Documentation Index
Fetch the complete documentation index at: https://smithers.sh/llms.txt
Use this file to discover all available pages before exploring further.
smithers 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 |
|---|---|
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. |
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. |
write-a-prd | Turn a product or feature idea into a PRD. |
feature-enum | Build or refine a code-backed feature inventory. |
audit | Audit feature groups for gaps and follow-up work. |
ralph | Keep an agent working continuously on a prompt. |
workflow-skill | Create or update agent-facing skill docs from local workflows. |
Operational Notes
- Default workflow files are user-owned after scaffold.
smithers initwill not overwrite edited files unless you pass--force. - Agent pools come from
.smithers/agents.ts; the default workflows use pools such asagents.smart,agents.smartTool, andagents.cheapFast. - Run
smithers workflow listto see the workflows in the current repo. - Inspect and resume runs with the normal CLI:
inspect,logs,chat,events,why,approve, andup --resume.
workflow-skill is included in this repository’s local .smithers pack. Copy it into another workflow pack when you want agents to generate skill files from local workflows.