julian
17c08e6392
- 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>
56 lines
1.2 KiB
Markdown
56 lines
1.2 KiB
Markdown
# 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-By` when 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 `main` for anything non-trivial
|
|
|
|
---
|
|
|
|
## Never
|
|
|
|
- `--no-verify` — fix the hook instead
|
|
- `--force` push to `main`
|
|
- `git add .` or `git add -A` — stage specific files
|
|
- Amend published commits
|
|
|
|
---
|
|
|
|
## Frequency
|
|
|
|
Commit after each discrete, complete change — not batched at session end.
|