> ## Documentation Index
> Fetch the complete documentation index at: https://smithers-feat-claude-workflow-mirror.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Default Workflows

> The workflow pack scaffolded by bunx smithers-orchestrator init.

`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:

```bash theme={null}
bunx smithers-orchestrator workflow run WORKFLOW_ID --prompt "..."
```

Most prompt-driven workflows accept `--prompt` as shorthand for `--input '{"prompt":"..."}'`. Workflows with structured inputs also support `--input`.

## Workflows

| Workflow                                                        | Use it for                                                                                      |
| --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| [`hello`](/workflows/hello)                                     | The smallest possible workflow: a single agent task that runs a Markdown prompt.                |
| [`implement`](/workflows/implement)                             | Implement a change with validation and review.                                                  |
| [`research-plan-implement`](/workflows/research-plan-implement) | Research, plan, implement, validate, and review in one run.                                     |
| [`mission`](/workflows/mission)                                 | Run long-horizon work as approved milestones with focused workers.                              |
| [`kanban`](/workflows/kanban)                                   | Implement ticket files from `.smithers/tickets/` in worktree branches.                          |
| [`ralph`](/workflows/ralph)                                     | Keep an agent working continuously on a prompt.                                                 |
| [`workflow-skill`](/workflows/workflow-skill)                   | Create or update agent-facing skill docs from local workflows.                                  |
| [`create-workflow`](/workflows/create-workflow)                 | Build a new Smithers workflow from a plain-English ask.                                         |
| [`create-skill`](/workflows/create-skill)                       | Author a new agent skill from a plain-English ask.                                              |
| [`context-engineer`](/workflows/context-engineer)               | Turn vague work into a contract, route, backpressure, execution, and report.                    |
| [`route-task`](/workflows/route-task)                           | Classify a plain-English script and run or recommend the right durable workflow.                |
| [`smithering`](/workflows/smithering)                           | Route work by size, from trivial task to full plan-build-validate-deliver pipeline.             |
| [`extract-skill`](/workflows/extract-skill)                     | Harvest reusable skills, workflow sketches, and memory from a run or pattern.                   |
| [`vcs`](/workflows/vcs)                                         | Inspect and act on a git or jj working tree.                                                    |
| [`review`](/workflows/review)                                   | Review current repo changes with one or more configured agents.                                 |
| [`plan`](/workflows/plan)                                       | Produce a practical implementation plan.                                                        |
| [`research`](/workflows/research)                               | Gather repo and external context before planning or building.                                   |
| [`debug`](/workflows/debug)                                     | Reproduce and fix a bug with validation.                                                        |
| [`improve-test-coverage`](/workflows/improve-test-coverage)     | Add missing tests and validate coverage-related changes.                                        |
| [`ticket-create`](/workflows/ticket-create)                     | Create one structured ticket from a prompt.                                                     |
| [`tickets-create`](/workflows/tickets-create)                   | Break a request into multiple implementable tickets.                                            |
| [`grill-me`](/workflows/grill-me)                               | Interrogate a vague plan until requirements are clearer.                                        |
| [`feature-enum`](/workflows/feature-enum)                       | Build or refine a code-backed feature inventory.                                                |
| [`audit`](/workflows/audit)                                     | Audit feature groups for gaps and follow-up work.                                               |
| [`context-doctor`](/workflows/context-doctor)                   | Lint a context contract for missing goals, inputs, verification, approvals, and reports.        |
| [`backpressure-plan`](/workflows/backpressure-plan)             | Turn acceptance criteria into a gate matrix.                                                    |
| [`triage-run`](/workflows/triage-run)                           | Diagnose a failed or stuck run and recommend a fix, rewind, retry, or escalation.               |
| [`report-slideshow`](/workflows/report-slideshow)               | Generate a concise HTML slideshow report from run state and artifacts.                          |
| [`monitor-smithers`](/workflows/monitor-smithers)               | Watch the Smithers fleet for stuck, blocked, failed, or over-budget runs.                       |
| [`monitor`](/workflows/monitor)                                 | Watch, diagnose, optionally self-fix, and report on one running workflow.                       |
| [`eval-author`](/workflows/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 init` will 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 list` to see the workflows in the current repo, `bunx smithers-orchestrator workflow inspect WORKFLOW_ID` to see metadata and the workflow input schema, and `bunx smithers-orchestrator workflow skills` to generate agent-facing docs under `.smithers/skills/`.
* Workflows can carry optional metadata comments (`smithers-display-name`, `smithers-description`, `smithers-tags`, `smithers-aliases`) that `bunx smithers-orchestrator workflow list` and `workflow-skill` use for display and discovery.
* Inspect and resume runs with the normal CLI: `inspect`, `logs`, `chat`, `events`, `why`, `approve`, and `up --resume`.