- Nx 22.7 monorepo (pnpm 11.1, TypeScript 5.9, Node 24) - apps/api: NestJS 11 (CJS conforme CODING-RULES.md PGD-DB-004) - apps/web: React 19 + Vite 8 (ESM) - libs/shared/api-interface: Zod contract base - Docker Compose dev: Postgres 18, Valkey 8, MinIO, Mailpit - WDS artifacts: - design-artifacts/A-Product-Brief/ (5 docs canônicos + 16 dialogs) - design-artifacts/B-Trigger-Map/ (hub + 4 personas + feature impact) - Stack canon: STACK.md v2.2 + CODING-RULES.md v2.0 + brand.md - AGENTS.md + README.md como entrada para devs/agentes Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1.2 KiB
1.2 KiB
Git — Whiteport Standard
All agents follow this when committing, branching, and handing off.
Commits
Format: Conventional Commits
<type>(<scope>): <short description>
[body — optional]
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
| Type | When |
|---|---|
feat |
New feature or capability |
fix |
Bug fix |
bump |
Version number update |
docs |
Documentation only |
chore |
Maintenance, config, tooling |
refactor |
Restructure, no behavior change |
- One logical change per commit
- Imperative mood: "add webhook handler" not "added"
- Always
Co-Authored-Bywhen Claude wrote or co-wrote — use actual model name
Branches
<agent>/<short-description> — e.g. codex/refactor-storefront, idun/sysadmin-skill
- Lowercase, hyphens only
- Short-lived — merge or delete after work is done
- Never commit directly to
mainfor anything non-trivial
Never
--no-verify— fix the hook instead--forcepush tomaingit add .orgit add -A— stage specific files- Amend published commits
Frequency
Commit after each discrete, complete change — not batched at session end.