Commit workflow

Run from the repository that holds the changes. Start with .agents/skills/codex-commit/scripts/preflight.sh.

Stop on an interrupted Git operation or missing precondition. Create and maintain an update_plan checklist for base, grouping, staging, draft, prose, review, gates, confirmation, commit, and rebase.

Use the recommended base from preflight. Read the whole diff and divide it into independently revertible logical changes. Stage every path by name with git add --. Never use git add ., git add -A, or git add --all. Confirm the index with the cached stat and short status.

Write the complete message to repo-root COMMIT_AGENTMSG. Use <type>(<scope>)?(!)?: <imperative description>. The body records why the change exists rather than restating the diff. Use only checked claims. Omit counts, sales language, and provenance. Hard-wrap body lines at 72 and trailers at 100. Put Assisted-by before the required Signed-off-by printed by preflight.

Invoke codex-fix-prose on COMMIT_AGENTMSG mise run lint-commit-msg. Then delegate codex-review-commit-message with fork_turns: "none", supplying only the repository root, optional --amend, and instruction to follow that skill. Resolve every finding and repeat prose lint plus independent review until it returns exactly VERDICT: PASS.

Only after receiving that verdict, run:

bash .agents/skills/codex-commit/scripts/stamp-review.sh <repo-root> <verdict-file>
mise run lint-commit-msg