Skip to main content

Documentation Index

Fetch the complete documentation index at: https://smithers.sh/llms.txt

Use this file to discover all available pages before exploring further.

mission is for work that is too long or broad for one agent loop. It creates a milestone plan, optionally pauses for human approval, then executes one milestone at a time. Within the active milestone it can run multiple feature workers in parallel, integrate their work, validate the checkpoint, and repair failed validation before moving on.
bunx smithers-orchestrator workflow run mission --prompt "Migrate the dashboard to the new gateway APIs"

Inputs

InputTypeDefault
promptstring"Describe the mission goal."
requirePlanApprovalbooleantrue
maxMilestonesnumber6
maxFeaturesPerMilestonenumber6
maxConcurrencynumber3
useWorktreesbooleanfalse
baseBranchstring"main"
Example with worktree isolation:
bunx smithers-orchestrator workflow run mission \
  --input '{"prompt":"Build import/export support","useWorktrees":true,"maxConcurrency":4}'

How It Runs

  1. The orchestrator scopes the request and creates serial milestones.
  2. If approval is enabled, the run waits at mission:approve-plan.
  3. The active milestone dispatches feature workers with fresh focused prompts.
  4. The integration task merges or reconciles the feature outputs.
  5. Validation runs tests, builds, smoke checks, and UI walkthroughs when applicable.
  6. Failed validation triggers one focused follow-up task and a revalidation.
  7. After all milestones complete, the final task writes a mission report.
Use smithers approve <run-id> --node mission:approve-plan after reviewing the proposed plan.