workflows-work

Execute the implementation plan: $ARGUMENTS

Purpose

You are executing Stage 4 (Implementation) of the development workflow. A plan exists from Stage 3 with decomposed tasks. Your job is to dispatch sub-agents for each task, collect their structured summaries, and persist everything to disk.

Pre-Conditions

Before starting, verify:

1. .workflow/state.json exists and currentStage is "implementation"
2. Plan file exists (check stages.planning.artifacts.plan in state, usually .workflow/plan.md)

If pre-conditions are not met, report what's missing and halt.

Process

Step 1: Read the Plan

Read .workflow/plan.md and the spec/ADR it references. Build the task execution order from the dependency graph.

Step 2: Dispatch Sub-Agents

For each task in dependency order:

1. Dispatch a sub-agent (use the Agent tool with subagent_type: "general-purpose") with:

   • The task definition from the plan (files, acceptance criteria, notes)
   • The relevant spec sections
   • The ADR hypotheses this task should support/test
   • Instructions to return the structured summary format (see below)

2. Parallelize independent tasks: If tasks have no dependency between them, dispatch their sub-agents concurrently using parallel Agent tool calls.

3. Persist the summary immediately upon receipt:

   .workflow/summaries/<branch-slug>-<task-id>.md
   

4. Verify acceptance criteria: Check each criterion from the plan against the sub-agent's summary. If any fail, note them for review.

Sub-Agent Summary Format

Each sub-agent MUST return this format:

## Sub-Agent Work Summary

### Task

- Branch: <current branch>
- Spec: <spec path>

### Changes
- Files modified: [list]
- Files created: [list]
- Lines: +N / -N

### Claims
1. "[specific testable claim]"
   - Verifiable by: [test or command]

### Spec/Evidence Alignment
- H1 "<text>": SUPPORTS / REFUTES / NO EVIDENCE -- [evidence]

### Tests
- Tests written: N
- Tests passing: N/N
- Commands: `[exact command]`

### Known Gaps
- [anything deferred or uncertain]

### Risks
- [anything that could break other parts]