Commit Workflow

Every commit is atomic: one logical concern, one message.

Source of truth

Commit policy — types, subject format, body rules, footers — lives in references/commit-best-practices.md. Read it before drafting any message. If the project ships .agents/rules/commit-best-practices.md (or the Cursor adapter .cursor/rules/commit-best-practices.mdc), that file overrides these defaults.

Workflow

Step 1: Inspect staged state

Run git status --short, git diff --cached --name-only, and git diff --cached --stat.

If nothing is staged, report it and stop.