Skip to main content
make-workflow-tutorial is an archived guided example, not installed by init: copy it from examples/init-pack/ with its dependency closure, or run the seeded create-workflow workflow directly. It turns “what should I automate?” into a real Smithers workflow: it recommends one from your repo and recent sessions instead of a blank catalog, then delegates the build to create-workflow.
You can bias the recommendation step with a hint:

​
Stages

  1. bootstrap: read the repo file tree, package.json, recent commits, and the Smithers docs index.
  2. sessions: bounded, read-only scan of recent Claude Code, Codex, and Pi session JSONL files, with secrets redacted.
  3. recommend: rank five candidate workflows for this codebase and recent work.
  4. pick: pause for the human to choose or modify one recommendation.
  5. build-launch: start create-workflow with the selected goal and require a custom .smithers/ui/<id>.tsx.
  6. monitor-loop: poll the child run, narrate progress, resume stale work, and triage failures when possible.
  7. dive-deeper: read human guide docs and preview other “You say -> Smithers runs” capabilities.

​
Inputs

​
What it reads

The session reader samples recent files from ~/.claude/projects, ~/.codex/sessions, ~/.codex/history.jsonl, and ~/.pi/agent/sessions, extracts user and assistant text where schemas are known, and redacts API keys and bearer tokens before passing snippets to the recommendation task.