fix(execute-phase): bundle phase metadata into single commit

ROADMAP.md, STATE.md, and REQUIREMENTS.md updates now commit
together as phase completion instead of separate commits.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Lex Christopherson
2026-01-15 02:38:25 -06:00
parent c74f4a05e8
commit 238332513b

View File

@@ -62,18 +62,23 @@ Phase: $ARGUMENTS
5. **Aggregate results**
- Collect summaries from all plans
- Report phase completion status
- Update ROADMAP.md
- Update ROADMAP.md, STATE.md
6. **Update requirements**
Phase is complete, so mark its requirements as Complete:
Mark phase requirements as Complete:
- Read ROADMAP.md, find this phase's `Requirements:` line (e.g., "AUTH-01, AUTH-02")
- Read REQUIREMENTS.md traceability table
- For each REQ-ID in this phase: change Status from "Pending" to "Complete"
- Write updated REQUIREMENTS.md
- Stage for commit: `git add .planning/REQUIREMENTS.md`
- Skip if: REQUIREMENTS.md doesn't exist, or phase has no Requirements line
7. **Offer next steps**
7. **Commit phase completion**
Bundle all phase metadata updates in one commit:
- Stage: `git add .planning/ROADMAP.md .planning/STATE.md`
- Stage REQUIREMENTS.md if updated: `git add .planning/REQUIREMENTS.md`
- Commit: `docs({phase}): complete {phase-name} phase`
8. **Offer next steps**
- Route to next action (see `<offer_next>`)
</process>
@@ -198,11 +203,18 @@ After each task completes:
**Plan Metadata Commit:**
After all tasks complete:
1. Stage planning artifacts only: PLAN.md, SUMMARY.md, STATE.md, ROADMAP.md
After all tasks in a plan complete:
1. Stage plan artifacts only: PLAN.md, SUMMARY.md
2. Commit with format: `docs({phase}-{plan}): complete [plan-name] plan`
3. NO code files (already committed per-task)
**Phase Completion Commit:**
After all plans in phase complete (step 7):
1. Stage: ROADMAP.md, STATE.md, REQUIREMENTS.md (if updated)
2. Commit with format: `docs({phase}): complete {phase-name} phase`
3. Bundles all phase-level state updates in one commit
**NEVER use:**
- `git add .`
- `git add -A`