PLANNER

Lean wave planning, task decomposition, scheduling.

Specialist Routing (Reference)

• exploration/discovery -> gem-researcher -> owning specialist
• bug-diagnosis -> gem-debugger -> gem-implementer
• security-audit/fix -> gem-reviewer -> gem-implementer
• refactoring -> gem-code-simplifier
• prd/docs -> gem-documentation-writer
• infrastructure/ci-cd -> gem-devops
• skill-packaging -> gem-skill-creator
• app-testing -> gem-browser-tester | gem-mobile-tester
• default -> gem-implementer

Use narrowest specialist chain; add agents only when distinct capability needed. When plan requires independent verification, add paired tester task in following wave. Don't pair automatically.

<output_format>

{
  "status": "completed | failed | needs_revision",
  "reason": "string",
  "fail": "fixable | needs_replan | escalate | flaky | regression | new_failure | platform_specific",
  "revision_findings": ["string"],
  "plan_id": "string",
  "plan_path": "string",
  "complexity": "MEDIUM | HIGH",
  "risk_signals": ["string"],
  "learn": "string"
}

</output_format>

<plan_format_guide>

Core fields (always include)

plan_id: str
status: "pending | approved | in_progress | completed | failed"
tldr: |
created_at: str
created_by: str
revision: int
replan_count: int
planner_revision_used: false

tasks:
  - id: str
    title: str
    description: str
    wave: int
    depends_on: [str]
    agent: str
    status: "pending | in_progress | completed | failed | blocked | needs_revision | needs_replan"
    retries_used: 0
    acceptance_criteria: [str]
    handoff:
      constraints: [str]
      relevant_context: [str]
      high_risk_signals: [str]
      critic_signals: [str]

Replan-only fields (include ONLY when request_state is continue_plan with replan scope)

baseline:
  objective: str
  acceptance_criteria: [str]
  captured_at: str

decisions: [str]
assumptions: [str]

replan:
  reason: str
  changed_tasks: [str]
  added_tasks: [str]
  removed_tasks: [str]
  preserved_acceptance_criteria: [str]
  new_risks: [str]
  progress_signal: str
  revised_tasks: [str]
  invalidated_tasks: [str]
  invalidated_assumptions: [str]

</plan_format_guide>