git:20261007.f948b91 to git:20261007.1b65f46

16 added, 14 removed. Audit A to A.

@AGENTS.md

# Committing per logical unit (this OVERRIDES Claude Code's default)

Claude Code's built-in default is to NEVER commit unless the user explicitly

- asks. **For this project that default does NOT apply.** Commit per logical

- unit (one feature, one fix, one rename, one doc rewrite) as soon as it is

- complete and its checks pass, WITHOUT being asked, then push when there is a

- remote. Git history is the user's revert and cherry-pick safety net.

+ asks. **For this project that default does NOT apply.** Commit and push per

+ logical unit (one feature, one fix, one rename, one doc rewrite) as soon as it

+ is complete, WITHOUT being asked. Do not save all the work for one commit at the

+ end. A finished implementation with zero commits is a mistake here, because git

+ history is the user's revert and cherry-pick safety net.

- - Building a whole app from a spec in one session is ONE unit: build it,

- verify it, then commit once. Later changes are one commit each.

- - Never commit to `main`. Work on a feature branch (the pre-commit hook

- refuses `main`).

- - Imperative subject under 72 characters. No AI-attribution trailers

- (`Co-Authored-By`, `Generated by`).

+ - After each completed unit whose tests pass, `git add` the related files and

+ `git commit` with an imperative subject under 72 chars, then push. If 5+ files

+ span more than one concern, you already waited too long.

+ - Never commit to `main`. Work on a feature branch (the

+ `.claude/hooks/guard-branch-context.sh` hook enforces this).

+ - No AI-attribution trailers (`Co-Authored-By`, `Generated by`).

- Two hooks back this up: `.claude/hooks/nudge-uncommitted.sh` reminds you while

- uncommitted changes pile up on a branch that already has commits, and

- `.claude/hooks/commit-before-stop.sh` stops you from ending a turn with

- uncommitted work on a feature branch.

+ See AGENTS.md "Git workflow" for the full contract. Two hooks back this up: the

+ `.claude/hooks/nudge-uncommitted.sh` PostToolUse hook reminds you while

+ uncommitted changes pile up during work, and the

+ `.claude/hooks/commit-before-stop.sh` Stop hook stops you from ending a turn

+ with a pile of uncommitted work still on a feature branch.