write-speaker-notes

# Speaker Notes (Presentation Script) Workflow Generate a verbatim reading script for a deck. The presenter reads these notes as-is during the talk, so every note is the actual sentences to say aloud, in the language the deck declares. **CRITICAL: These are presentation scripts (대본), NOT talking points.** Full spoken sentences that flow naturally when read aloud. The deck's genre decides what a good script is. Never guess the genre: read the resolved profile first (Phase 0B) and apply the matching genre section below. The mechanics (where notes live, the three privacy layers) are the same for every genre. --- ## Phase 0: Pre-Flight Checks ### 0A. Identify Target File Decks live at `Quarto/<genre>/<name>.qmd`. Resolve the argument rather than building a path by hand: ```bash python3 scripts/deckpath.py [Deck] --field qmd ``` A bare name works; `genre/name` disambiguates if two genres ever share one. If no argument, ask the user. `python3 scripts/deckpath.py --list` shows what exists. ### 0B. Read the Deck's Premises (profile + deck.yml) Everything the script depends on is declared, not guessed. Read both, first thing: ```bash python3 scripts/deckprofile.py [Deck] # resolved config, JSON cat "$(python3 scripts/deckpath.py [Deck] --field config)" # the raw deck.yml ``` From the resolved JSON: - `profile` - which genre section below applies: `paper-review`, `lecture`, or `invited-talk` - `notes_language` - `ko` (280 Hangul syllables/min) or `...