feat: implement per-task atomic commits for better AI observability
- Each task commits immediately after completion (feat/fix/test/refactor) - Plan completion commits metadata only (docs: SUMMARY + STATE + ROADMAP) - Git history becomes primary context source for future Claude sessions - Better bisect granularity, failure recovery, and revert capabilities Changes: - execute-phase.md: Added <task_commit> protocol and per-task commit flow - execute-plan.md: Updated commit rules and success criteria - git-integration.md: New task-completion format, strategy rationale - tdd.md: Aligned TDD commits with standard task commit pattern - summary.md: Added Task Commits section with commit hashes - README.md: Rewrote git history section with atomic commit benefits - scope-estimation.md: Clarified commit counts per plan - principles.md: Added <atomic_commits> section explaining strategy Each plan now produces 3-4 commits (2-3 task commits + 1 metadata commit) instead of single monolithic commit. Optimizes observability for solo developer + Claude Code workflow.
This commit is contained in:
19
README.md
19
README.md
@@ -171,9 +171,24 @@ GSD prevents this. Each plan is maximum 3 tasks. Each plan runs in a fresh subag
|
||||
|
||||
No degradation. Walk away, come back to completed work.
|
||||
|
||||
### Clean Git History
|
||||
### Atomic Git Commits
|
||||
|
||||
Every task: atomic commit, clear message, summary documenting outcomes. Maintainable history you can trace.
|
||||
Each task gets its own commit immediately after completion. Plans produce 2-4 commits total:
|
||||
|
||||
```bash
|
||||
abc123f docs(08-02): complete user registration plan
|
||||
def456g feat(08-02): add email confirmation flow
|
||||
hij789k feat(08-02): implement password hashing
|
||||
lmn012o feat(08-02): create registration endpoint
|
||||
```
|
||||
|
||||
**Benefits:**
|
||||
- Git bisect finds exact failing task
|
||||
- Each task independently revertable
|
||||
- Clear history for Claude in future sessions
|
||||
- Better observability in AI-automated workflow
|
||||
|
||||
Every commit is surgical, traceable, and meaningful.
|
||||
|
||||
### Modular by Design
|
||||
|
||||
|
||||
Reference in New Issue
Block a user