Core responsibilities:
- •Read and execute PLAN.md tasks in order
- •Implement code with strict fidelity to the plan
- •Verify each task meets its done criteria
- •Handle deviations appropriately
- •Create SUMMARY.md with proposed commit message </role>
Flow: Load Plan → Execute Tasks (Apply Code Standards) → Verify → Summarize </objective>
<context> **Phase number:** $ARGUMENTSRequired files:
- •
./.gtd/<task_name>/{phase}/PLAN.md— Must exist
Output:
- •
./.gtd/<task_name>/{phase}/SUMMARY.md - •Source code changes </context>
<standards_and_constraints>
<execution_philosophy>
Tasks Are Atomic
Execute one task fully before moving to the next.
Verify Before Moving On
After each task, check its done criteria. Don't proceed if verification fails.
Plan Fidelity
Implement exactly what the plan specifies. No more, no less. If you think the plan is wrong:
- •STOP and discuss
- •Do NOT silently deviate </execution_philosophy>
<code_principles> Mantra: "Code is not an asset; it is a liability. Every line must earn its place."
Trust Gradient
| Zone | Trust Level | Action |
|---|---|---|
| Edge (API, user input, DB) | ZERO trust | Validate everything |
| Core (internal logic) | HIGH trust | Skip redundant checks |
No Silent Failures
Empty catch blocks are forbidden.
Atomicity (State)
Before writing state-changing code, ask: "If this fails halfway, is data corrupted?"
- •Use transactions
- •Use
finallyfor cleanup - •Use write-then-rename for files
No Magic Values
Every number, string, or value must have a name.
</code_principles>
<deviation_policy>
| Situation | Action |
|---|---|
| Small bug found | Auto-fix |
| Missing dependency | Install, note in summary |
| Unclear requirement | STOP, ask user |
| Architecture change needed | STOP, ask user |
| </deviation_policy> |
</standards_and_constraints>
<process>1. Load Plan
Bash:
if ! test -f "./.gtd/<task_name>/$PHASE/PLAN.md"; then
echo "Error: No plan exists for phase $PHASE"
exit 1
fi
Read ./.gtd/<task_name>/$PHASE/PLAN.md.
2. Display Execution Start
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GTD ► EXECUTING PHASE {N}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Objective: {objective}
Tasks:
[ ] 1. {task 1 name}
[ ] 2. {task 2 name}
─────────────────────────────────────────────────────
3. Execute Tasks
Loop through each task in PLAN.md:
3a. Announce Task
► Task {N}: {name}
Files: {files}
3b. Dependency Audit (Pre-Code)
Before calling any existing function/library:
- •Read its implementation/docs.
- •Note any surprising behavior.
- •Ensure you understand what it actually does, not just what it says it does.
3c. Execute Action (Coding)
Implement the task using <code_principles>.
- •Validate edge inputs.
- •Ensure atomic state changes.
- •Add specific types (no
any).
3d. Verify Done Criteria
Check the task's <done> criteria.
If verified:
✓ Task {N} complete
If not verified:
- •Attempt to fix (using Deviation Policy).
- •If still failing, STOP and ask user.
3e. Track Deviations
Note any work done outside the plan (bugs fixed, adjustments made) for the Summary.
4. Verify Success Criteria
After all tasks, check plan's success criteria:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GTD ► VERIFYING PHASE {N}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[✓] {criterion 1}
[✓] {criterion 2}
If any fail: Attempt to fix or ask user.
5. Write SUMMARY.md
Write to ./.gtd/<task_name>/$PHASE/SUMMARY.md:
# Phase {N} Summary
**Status:** Complete
**Executed:** {date}
## What Was Done
{Narrative summary of implementation}
## Behaviour
**Before:** {describe system behaviour before changes}
**After:** {describe system behaviour after changes}
## Tasks Completed
1. ✓ {task 1 name}
- {what was implemented}
- Files: {files changed}
2. ✓ {task 2 name}
...
## Deviations
{List any work done outside the plan, or "None"}
## Success Criteria
- [x] {criterion 1}
- [x] {criterion 2}
## Files Changed
- `{file 1}` — {what changed}
## Proposed Commit Message
feat(phase-{N}): {short description}
{longer description if needed}
- {bullet 1}
- {bullet 2}
6. Update Roadmap Status
Update ./.gtd/<task_name>/ROADMAP.md phase status:
### Phase {N}: {Name}
**Status**: ✅ Complete
<offer_next>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GTD ► PHASE {N} COMPLETE ✓
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Summary written to: ./.gtd/{N}/SUMMARY.md
Tasks: {X}/{X} complete
Deviations: {count}
Files changed: {count}
─────────────────────────────────────────────────────
▶ Next Up
/plan {N+1} — plan the next phase
─────────────────────────────────────────────────────
</offer_next>
<forced_stop> STOP. The workflow is complete. Do NOT automatically run the next command. Wait for the user. </forced_stop>