Skip to main content
research-plan-implement is a full pipeline for changes that need context before code. It asks one agent to research, another to plan, then passes the enriched prompt into the same ValidationLoop used by implement.
bunx smithers-orchestrator workflow run research-plan-implement --prompt "Replace the auth cookie format"

Inputs

InputTypeDefault
promptstring"Implement the requested change."
tddbooleanfalse
When tdd is true, the planning task is instructed to start with test steps before any implementation steps, and the implementation task is instructed to write or update tests before production code. Pass structured input when you want test-first planning:
bunx smithers-orchestrator workflow run research-plan-implement \
  --input '{"prompt":"Add invite-only signup","tdd":true}'

How It Runs

  1. Research gathers repo context, prior art, and relevant implementation details.
  2. Planning turns the request and research into concrete steps.
  3. Implementation receives the original prompt plus research and plan context.
  4. Validation and review decide whether another implementation pass is needed.

Use it when

  • The change needs repo context and a plan before code.
  • You want research, planning, and a validated implementation in one run.

Use something else when

Resume & retry

Runs are durable and resume with up --resume; completed research and planning are not re-run. The implementation stage uses the same validation loop as implement (up to 3 iterations, stopping on validation pass plus reviewer approval).