bunx smithers-orchestrator init creates a .smithers/workflows/ directory with ready-to-run workflows for planning, implementation, review, tickets, audits, and long-running missions. These workflows are normal Smithers TSX files: run them as-is, edit them for your repo, or use them as examples for your own workflow pack.
Run any default workflow by ID:
--prompt as shorthand for --input '{"prompt":"..."}'. Workflows with structured inputs also support --input.
Workflows
| Workflow | Use it for |
|---|---|
hello | The smallest possible workflow: a single agent task that runs a Markdown prompt. |
implement | Implement a change with validation and review. |
research-plan-implement | Research, plan, implement, validate, and review in one run. |
mission | Run long-horizon work as approved milestones with focused workers. |
kanban | Implement ticket files from .smithers/tickets/ in worktree branches. |
ralph | Keep an agent working continuously on a prompt. |
workflow-skill | Create or update agent-facing skill docs from local workflows. |
create-workflow | Build a new Smithers workflow from a plain-English ask. |
create-skill | Author a new agent skill from a plain-English ask. |
context-engineer | Turn vague work into a contract, route, backpressure, execution, and report. |
route-task | Classify a plain-English script and run or recommend the right durable workflow. |
smithering | Route work by size, from trivial task to full plan-build-validate-deliver pipeline. |
extract-skill | Harvest reusable skills, workflow sketches, and memory from a run or pattern. |
vcs | Inspect and act on a git or jj working tree. |
review | Review current repo changes with one or more configured agents. |
plan | Produce a practical implementation plan. |
research | Gather repo and external context before planning or building. |
debug | Reproduce and fix a bug with validation. |
improve-test-coverage | Add missing tests and validate coverage-related changes. |
ticket-create | Create one structured ticket from a prompt. |
tickets-create | Break a request into multiple implementable tickets. |
grill-me | Interrogate a vague plan until requirements are clearer. |
feature-enum | Build or refine a code-backed feature inventory. |
audit | Audit feature groups for gaps and follow-up work. |
context-doctor | Lint a context contract for missing goals, inputs, verification, approvals, and reports. |
backpressure-plan | Turn acceptance criteria into a gate matrix. |
triage-run | Diagnose a failed or stuck run and recommend a fix, rewind, retry, or escalation. |
report-slideshow | Generate a concise HTML slideshow report from run state and artifacts. |
monitor-smithers | Watch the Smithers fleet for stuck, blocked, failed, or over-budget runs. |
monitor | Watch, diagnose, optionally self-fix, and report on one running workflow. |
eval-author | Turn acceptance criteria into eval fixtures and a rubric for bunx smithers-orchestrator eval. |
Operational Notes
- Default workflow files are user-owned after scaffold.
bunx smithers-orchestrator initwill not overwrite edited files unless you pass--force. - Agent pools are defined in
.smithers/agents.ts; edit that file to change which models each workflow uses. - Run
bunx smithers-orchestrator workflow listto see the workflows in the current repo,bunx smithers-orchestrator workflow inspect WORKFLOW_IDto see metadata and the workflow input schema, andbunx smithers-orchestrator workflow skillsto generate agent-facing docs under.smithers/skills/. - Workflows can carry optional metadata comments (
smithers-display-name,smithers-description,smithers-tags,smithers-aliases) thatbunx smithers-orchestrator workflow listandworkflow-skilluse for display and discovery. - Inspect and resume runs with the normal CLI:
inspect,logs,chat,events,why,approve, andup --resume.