run-execute

<progress_display> Show current position in workflow:

### Run Progress
- [ ] Run initialized (init-run.cjs)
- [ ] Context loaded
- [ ] Plan generated  ← {current_step}
- [ ] Implementation
- [ ] Tests passing
- [ ] Code review
- [ ] Run completed (complete-run.cjs)
- [ ] Walkthrough generated

Update markers as you progress: [x] = done, ← current = active step </progress_display>

Package	Purpose	Install Command
yaml	Parse/stringify state.yaml	npm install yaml

<resume_detection critical="true"> Before starting execution, check if resuming an interrupted run:

<check if="runs.active is empty">
  <goto step="1">No active run, start fresh</goto>
</check>

<check if="runs.active has entries">
  <action>Load active run from state.yaml runs.active[0]</action>
  <action>Read scope (single/batch/wide) and work_items array</action>

  <substep n="0a" title="Enumerate Work Item Status">
    <action>For EACH work item in runs.active[0].work_items, classify by status:</action>
    <action>Build status summary from state.yaml (NOT from artifact files):</action>
    <format>
      [DONE] {item-id} — completed
      [WORKING] {item-id} (phase: {current_phase}) — in_progress
      [PENDING] {item-id} — pending
    </format>
    <action>Count: completed={X}, in_progress={Y}, pending={Z}</action>
  </substep>

  <substep n="0b" title="Determine Resume Point for Current Item">
    <action>Get current_item from state.yaml</action>
    <action>Read current_phase from the current item's entry in work_items</action>

    <determine_resume_point>
      Use current_phase from state.yaml to determine resume point:

      | current_phase | Resume At |
      |---------------|-----------|
      | plan (or unset) | Step 3 (Generate Plan) |
      | execute | Step 5 (Implementation) |
      | test | Step 6 (Run Tests) |
      | review | Step 6b (Code Review) |
    </determine_resume_point>
  </substep>

  <llm critical="true">
    <mandate>NEVER call --complete-item for items with status "completed" — they are already done</mandate>
    <mandate>NEVER re-execute steps (plan, implement, test) for completed items</mandate>
    <mandate>ONLY work on the current_item identified in state.yaml</mandate>
    <mandate>Use current_phase from state.yaml — do NOT infer phase from artifact file existence</mandate>
  </llm>

  <output>
    Resuming run {run-id} ({scope}) for work item {current_item}.
    Mode: {mode}
    Phase: {current_phase}
    Status: {completed_count} done, {in_progress_count} working, {pending_count} pending
    Resuming at: Step {step_number}
  </output>
</check>

<degrees_of_freedom> Varies by mode:

• Autopilot: LOW — Execute standard patterns decisively
• Confirm: MEDIUM — Present plan, adjust based on feedback
• Validate: LOW — Follow approved design precisely </degrees_of_freedom>