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.