playbook-builderlisted

# Building a SuperDialog Playbook A playbook is a Director+Talker voice-agent script: the **Director** (usually a fast/cheap LLM) reads the transcript each turn and decides whether to advance to a new checkpoint or fire an interrupt; the **Talker** (usually a stronger LLM) speaks based on whatever checkpoint the Director landed on. Almost every hard bug in a playbook traces back to one specific thing being left to Director/Talker *judgment* when it should have been made *structural* — a real slot, a real `judge: expr` rule, or a real code-side guard. This skill exists because that lesson kept getting relearned the hard way across three real playbooks (a golf-booking agent, a real-estate agent, a meditation-retreat agent) before it got written down here. ## Before writing anything: read the real schema Don't guess field names. Read `references/schema.md` — it's the actual `superdialog.playbook.models` Pydantic schema (persona, llm, journeys, checkpoints, slots, advance_when, interrupts, policies, knowledge_base), not a remembered approximation. Every field there was confirmed against the installed library, not assumed from a prior example. ## Workflow 1. **Source hygiene check, before anything else.** If you're compiling from a client-provided prompt/spec, skim the whole thing first for content that doesn't belong — a copy-pasted section from a *different* client's script is a real, recurring failure mode (a real-estate "off-topic termination" block once ended