| name | review-commits |
| description | Review commit structure and organization. Use when asked to "review commits", "check commit history", "are commits atomic", "review commit structure", or when evaluating whether commits are logically grouped and ordered.
|
| argument-hint | [PR number or branch name] |
Review Commits
Evaluate commit structure for atomicity, logical grouping, and clean history.
What to Evaluate
| Dimension | Check for |
|---|
| Atomicity | Does each commit do exactly one thing? |
| Ordering | Do commits build logically on each other? |
| Grouping | Are related changes in the same commit? |
| Bisectability | Could git bisect find a bug introduced by one commit? |
| No fixups | Are there "fix typo" or "oops" commits that should be squashed? |
Process
- List commits on the branch:
git log --oneline <base>..HEAD
- For each commit, check that it is self-contained and buildable
- Verify no commit mixes unrelated changes
- Flag fixup commits that should be squashed
- Check that the commit sequence tells a readable story
Output
- Commit list with assessment of each
- Recommendations for squashing, reordering, or splitting
- Overall structure score
