team-dispatch

Team Dispatch

Subagent dispatch arm. The PhaseSpec v1 contract is the only handoff format used between parent and child agents.

PhaseSpec v1 (the contract)

phase_id: <stable id, used as filename prefix and progress.md anchor>
parent_plan_ref: <pointer to task_plan.md#phase-N>
goal: <one sentence>
done_when:                       # testable exit criteria, no goalpost moving
  - <criterion 1>
  - <criterion 2>
inputs:
  files: [<read-only file refs>]
  memory_keys: [<keys for memory-layer recall>]
tools_allowed: [<list>]
tools_denied: [<list>]
budget:
  max_tool_calls: <int>
  max_wall_seconds: <int>
hitl_checkpoints: [<named checkpoint strings the child surfaces>]
return_contract:
  format: markdown+frontmatter
  fields: [summary, artifacts, open_questions, next_phase_hint]

Six load-bearing properties:

1. parent_plan_ref is a pointer (file path with anchor), not a copy of the phase text. The child reads the file itself.
2. done_when is testable. Without it, completion is hallucinatable.
3. tools_allowed and tools_denied map onto the Claude Code permission model and any other framework's permission story.
4. hitl_checkpoints are named strings the child surfaces by printing HITL_CHECKPOINT: <name> to stdout.
5. return_contract forces structured output. The child returns markdown with frontmatter; the parent parses it deterministically.
6. phase_id doubles as the filename prefix for any artifacts the child writes.

Available subagents

Each is defined as agents/<name>.md in this plugin.

Subagent	When to pick
planner	A phase exists in task_plan.md but has no PhaseSpec yet. The planner drafts one.
executor	Default. A PhaseSpec exists; the work is straightforward; one specialist runs it end to end.
reviewer	Auto-approve mode is on; we need a surrogate human to check the executor's return against done_when.
memory-keeper	Stop hook fired; we need to classify session output into scratch/WHERE/WHY.
design-archeologist	/mddesign:harvest invoked; long-running codebase scan needed.