Atomic Git Commits
Create well-separated atomic commits for all current changes.
Process
- •Run
git statusandgit diff --statto see all changes - •Run
git log --oneline -10to match existing commit message style - •Read the full diff to understand every change
- •Group changes into logical units — each commit should represent ONE coherent change that could be reverted independently
- •For each group, stage only those files and commit
- •After all commits, run
git statusto verify clean working tree
Grouping Rules
- •Separate content changes from config changes from template changes
- •If a data file and its template changed together for the same reason, they belong in one commit
- •Test/verification changes go with the code they verify
- •Never mix unrelated changes in one commit
- •When in doubt, prefer smaller commits over larger ones
Commit Message Format
Follow this project's convention:
- •
fix:— bug fixes - •
content:— copy/text changes - •
chore:— maintenance, cleanup - •
docs:— documentation - •
refactor:— code restructuring - •
perf:— performance improvements - •
feat:— new features
Format:
code
<type>: <short summary in lowercase> <optional body explaining WHY, not what> Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Rules
- •Always use HEREDOC syntax for commit messages
- •Stage specific files by name, never
git add -Aorgit add . - •Do NOT push unless explicitly asked
- •Verify clean working tree after all commits
- •If there are no changes to commit, say so and stop