Commit
Minimal commit helper for repos using commit discipline. For full staging/splitting workflows, use commit-work from softaworks/agent-toolkit instead.
Repo-specific rules (including auto-commit) appear in AGENTS.md Commit Discipline.
Rules
- Unit of work: one coherent, independently revertable change — one feature, one bugfix, one refactor in one domain, one config change. Never two unrelated concerns in one commit. A TDD cycle alone is not a commit boundary; commit when the intended change is complete and tests pass
- Use Conventional Commits:
feat:,fix:,refactor:,test:,docs:,chore: - One concern per commit; never batch unrelated changes
- Stage only files for this unit:
git add <files>— nevergit add .,git add -A, orgit add -p - Never commit with red tests; run the repo's validation command first
Workflow
- Inspect:
git status,git diff - Stage only files for this unit:
git add <files> - Verify staged diff:
git diff --cached - Write message:
type: short imperative summary(optional body for why) - Commit:
git commit -m "type: summary"
Message format
type: short summary in imperative mood
Optional body explaining what changed and why.
Examples: feat: add commit inject auto-commit flag, fix: resolve package root for hook run