| name | atomic-commits |
| description | Makes atomic commits with clean messages. Use when committing code, implementing tasks, or preparing git history. Ensures one logical change per commit for easy review and rollback. |
Atomic Commits
One task = one commit. Clean history, easy rollback.
Format
{type}({scope}): {description}
- {detail}
- {detail}
Task: {id}
Types
| Type | Use |
|---|
feat | New feature |
fix | Bug fix |
refactor | Code change (no behavior change) |
test | Adding/fixing tests |
docs | Documentation |
Example
feat(image-upload): create upload API endpoint
- Add POST /api/upload route
- Implement multer middleware
- Add file type validation
Task: T1
Process
- Implement task completely
- Verify it works (tests, types, lint)
- Stage specific files (
git add {files}, not -A)
- Read staged changes: !
git diff --cached --stat 2>/dev/null || echo 'NOT_FOUND'
- Commit with proper format
- Return hash
Pre-Commit
Rules
- Never commit broken code
- Never commit partial work
- Never commit unrelated changes
- One logical change per commit
Tags
Format: v{major}.{minor}.{patch}
| Trigger | Bump | Example |
|---|
| Breaking change | major | v2.0.0 |
| New feature | minor | v1.1.0 |
| Bug fix | patch | v1.0.1 |
Create: git tag -a v1.0.0 -m "message" → git push origin v1.0.0
Tag after milestone complete, not every commit.
