Commit

1. Rust formatting:

   cargo fmt
   

2. Compile check:

   cargo check
   

3. Linting:

   cargo clippy
   

4. Tests:

   cargo test
   

5. Policy checks - runs all policy checks with auto diff-base:

   python3 tools/policy/check_all.py
   

   If any fail, fix violations before committing.

Commit Format

<Summary starting with verb, 50 chars or less>

- Bullet under 60 chars
- Another bullet if needed (2-5 total)

Bullet points should be concise (under 60 chars each) and describe what changed, not background context.

ASCII only. No special Unicode characters.

CRITICAL: Do NOT add attribution. No "Generated with Claude Code", no "Co-Authored-By", no author credits. These duplicate badly when squash-merging. The commit message should ONLY contain the summary line and bullet points.

IMPORTANT: Describe the outcome, not the process. The commit message reflects what changed, not how you got there.

Branch Rules

Branch name format: <type>/<short-description>

• Types: feature, bugfix, refactor, release, chore, docs
• Use kebab-case: aaa-bbb-ccc
• Keep short (~5 words max)

IMPORTANT: Name for the primary feature, not the recent task. Look at the full diff and identify what the main deliverable is.

Examples:

• feature/user-auth
• bugfix/null-pointer-crash
• refactor/split-codegen (behavior-preserving restructuring)
• chore/update-deps (CI changes go here)
• docs/api-reference

Instructions

1. Check branch first - See "STOP: Check Branch First" section above. Do NOT skip this.
2. Format all files (cargo fmt)
3. Run all checks (check, clippy, test, policy) - fix any violations before proceeding
4. Check git status again - Formatters may modify files beyond your original changeset. Run git status --short to see all modified files before staging.
5. Stage files with git add <files> (do NOT use git add -A)
6. Run git commit as a separate command (do NOT chain with add)

Note: Never use git commit --amend if the previous commit has been pushed. If git status shows "Your branch is up to date with origin", the last commit is pushed - create a new commit instead.