Execute

Workflow

Step 1: Load the Phase

• Read main.md Plan section for current phase
• Understand objective and acceptance criteria
• Note all files to modify

Step 2: Update Status

## Meta
- **Status:** EXECUTING_PHASE_{N}

Step 3: Execute Tasks

For each task:

1. Read task and subtasks
2. Implement changes
3. Run relevant tests
4. Verify change works
5. Commit with clear message

Step 4: Verify Acceptance Criteria

• Check each AC explicitly
• Run full test suite
• Note any AC that cannot be verified

Step 5: Update main.md

## Execution Log

### Phase {N}: {title}
- **Status:** COMPLETE | BLOCKED
- **Started:** {date}
- **Completed:** {date}
- **Commits:** `abc123`, `def456`
- **Files Modified:**
  - `path/file.ts` — {what changed}
  - `path/other.ts` — {what changed}
- **Notes:** {observations, anything reviewer should know}
- **Blockers:** {if BLOCKED, what's blocking}

### Tasks Completed
- [x] Task {N}.1: {brief summary}
- [x] Task {N}.2: {brief summary}
- [ ] Task {N}.3: BLOCKED — {reason}

### Acceptance Criteria
- [x] AC1: {how verified}
- [x] AC2: {how verified}

Then update Status:

## Meta
- **Status:** CODE_REVIEW

Execution Rules

DO:

• Follow existing code patterns
• Write tests for new functionality
• Keep commits atomic
• Report progress on each task
• Fix obvious typos/errors in the plan (file paths, variable names)

DO NOT:

• Refactor outside phase scope
• Add features not in plan
• Skip tests "to save time"
• Assume without verifying
• Continue past a blocker
• Change behavioral decisions (those need re-planning)

What Counts as "Improvising"

• ✅ OK: Fixing wrong-file.ts → correct-file.ts (obvious typo)
• ✅ OK: Using a slightly different API that does the same thing
• ❌ NOT OK: Adding error handling not in the plan
• ❌ NOT OK: Changing the approach because you think it's better
• ❌ NOT OK: Implementing extra features "while you're at it"

When in doubt: document the deviation and let code reviewer decide.

When Blocked

If you cannot complete a task:

1. Document exactly what's blocking
2. Note what you tried
3. STOP execution
4. Update main.md:

### Phase {N}: {title}
- **Status:** BLOCKED

### Blockers
- {detailed description of blocker}
- Tried: {what you attempted}
- Need: {what would unblock}

## Meta
- **Status:** BLOCKED
- **Blocked Reason:** {brief description}

Do NOT:

• Guess at a solution
• Implement workarounds outside plan
• Skip the task and continue

Commit Message Format

Phase{N}.{task}: {brief description}

- {detail}
- {detail}

AC: #{ac_number}