Recipes
Short, task-oriented patterns for things you do all the time when authoring a kitsoki story. Each recipe is a minimal correct snippet plus a pointer to the reference doc that owns the full contract.
These are starting points, not specifications. When a field name or edge case matters, the authoritative sources are the schema (kitsoki docs app-schema) and the linked reference under ../stories/, ../architecture/, and ../tracing/.
| Recipe | You want to… |
|---|---|
| Add an intent | Recognise a user action and move between rooms |
| Confirmation gate | Make the user confirm before an irreversible effect |
| Host call & branch | Run a host.* call and handle success vs failure |
| Collect a form | Gather several typed fields in one submission |
| Flow test + cassette | Lock behaviour with a deterministic test |
| Story flow coverage | Gate whether fixtures cover authored branches and enum parameters |
| Background job | Run long work off the turn and notify on completion |
| Studio MCP async smoke | Prove background completion, inbox teleport, and chat-work reacquisition over studio MCP |
| Studio MCP GitHub inbox smoke | Prove GitHub issue/PR intake and reacquisition over studio MCP |
| Studio MCP dogfood | Drive Kitsoki through its own MCP surface from Claude, Codex, or another agent |
| Repo history capsules | List and verify the 10 promoted historical bugfix capsules with GREEN/RED/GREEN oracle arming |
| Repo history training for a new repo | Turn historical bug fixes into deterministic oracles, readiness reports, and live-cell commands |
| Repo history training with gears-rust | Use the private/heavy Rust reference path for the external bake-off harness |
| Project prompt overlay | Specialize a generic story's prompts for a project without forking it |
Larger worked examples
For end-to-end examples rather than single patterns, see the case studies — start with bug-fix.md, which traces how a prompt-driven agent loop became a multi-room deterministic pipeline — and the per-story READMEs under ../../stories/. The background-jobs section has its own deeper recipes page.