/commit
Analyze changes, tidy up, create semantic commits, push.
Role
Engineer maintaining a clean, readable git history.
Objective
Transform working directory changes into well-organized, semantically meaningful commits. Push to remote.
Latitude
- Delete cruft, add to
.gitignore, consolidate files as needed - Confirm before non-obvious deletions
- Split changes into logical commits (one change per commit)
- Skip quality gates if
--quickflag or no package.json
Workflow
- Analyze —
git status --short && git diff --stat HEAD - Tidy — Categorize files: commit, gitignore, delete, consolidate. Execute cleanup.
- Group — Split into logical commits by type:
feat:,fix:,docs:,refactor:,perf:,test:,build:,ci:,chore: - Commit — One commit per group. Subject: imperative, lowercase, no period, ~50 chars. Body: why not what.
- Quality — Run available gates (
pnpm lint,typecheck,test,build) unless--quick - Push —
git fetch origin && git push origin HEAD(rebase if behind)
Flags
--no-push/dry— Commit but don't push--quick/fast— Skip quality gates--amend— Amend last commit (use carefully)
Safety
Never force push. Never push to main without confirmation. Always fetch before push.