create-talk

--- name: create-talk description: Generate Beamer presentations for the sewage-house-prices project by dispatching the Storyteller agent (creator) and Discussant agent (critic). Supports 4 formats — job market, seminar, short, lightning. Derives all content from the paper. disable-model-invocation: true argument-hint: "[format: job-market | seminar | short | lightning] [paper path (optional)]" allowed-tools: ["Read", "Grep", "Glob", "Write", "Edit", "Task", "Bash"] --- # Create Talk Generate a Beamer presentation by dispatching the **Storyteller** (creator) and **Discussant** (critic). **Input:** `$ARGUMENTS` — format name, optionally followed by paper path. --- ## Workflow ### Step 1: Parse Arguments - **Format** (required): `job-market` | `seminar` | `short` | `lightning` - **Paper path** (optional): defaults to `docs/overleaf/_main.tex` - If no format specified, ask the user. ### Format Constraints | Format | Slides | Duration | Content Scope | |--------|--------|----------|---------------| | Job market | 40-50 | 45-60 min | Full story, all results, mechanism, robustness | | Seminar | 25-35 | 30-45 min | Motivation, main result, 2 robustness, conclusion | | Short | 10-15 | 15 min | Question, method, key result, implication | | Lightning | 3-5 | 5 min | Hook, one result, so-what | ### Step 2: Launch Storyteller Agent Delegate to the `storyteller` agent via Task tool: ``` Prompt: Create a [format] talk from [paper]. Read the paper (docs/overleaf/_main.tex) and extract: - Research question: causal effect of sewage spills on house prices and rents in England - Data: EDM (Event Duration Monitoring) spill records 2021-2024+, Land Registry prices, Zoopla rentals - Identification strategy: hedonic pricing, repeat sales, long-difference, DiD/event study - Spatial matching: spill sites within radius (250m–10km) linked to properties - Key treatment variables: spill_count, spill_hrs, n_spill_sites, min_dist - Main results and effect sizes (house prices and rents separately) - Robustness checks: upstream/downstream, dry spill placebo, rainfall controls - Institutional context: England's water companies, EDM permit system, regulatory failure - Key figures: output/figures/, docs/overleaf/figures/, docs/overleaf/maps/ Design narrative arc for [format] format. Build Beamer .tex file with shared preamble if available. Compile with XeLaTeX. Save to docs/conferences/[format]_talk.tex ``` The Storyteller follows these principles: - One idea per slide - Figures > tables (tables in backup); prefer maps and scatter plots from output/figures/ - Build tension: motivation (regulatory failure) → question → EDM data → method → findings → policy implications - Transition slides between major sections - All claims must appear in the paper (single source of truth) - Treatment variable definitions (12/24hr counting) explained clearly on methods slide ### Step 3: Launch Discussant Agent (Talk Critic) After Storyteller returns, delegate to the `discussant` agent: ``` Prompt: Review the talk at docs/conferences/[format]_talk.tex. Check 5 categories: 1. Narrative flow — does the story build properly from EDM data → identification → results? 2. Visual quality — overflow, readability, consistency 3. Content fidelity — every claim (coefficient, standard error, N) traceable to paper 4. Scope for format — right amount of content for duration 5. Compilation — does it compile cleanly? Score as advisory (non-blocking). Save report to docs/conferences/quality_reports/[format]_talk_review.md ``` ### Step 4: Fix Critical Issues If Discussant finds Critical issues (compilation failures, content not in paper): 1. Re-dispatch Storyteller with specific fixes (max 3 rounds) 2. Re-run Discussant to verify ### Step 5: Present Results 1. Generated `.tex` file path 2. Slide count and format compliance 3. Discussant score (advisory, non-blocking) 4. TODO items (missing figures, tables not yet generated) --- ## Output Save to `docs/conferences/[format]_talk.tex` (e.g., `docs/conferences/seminar_talk.tex`). Quality report to `docs/conferences/quality_reports/[format]_talk_review.md`. --- ## Principles - **Paper is authoritative.** Every claim must appear in `docs/overleaf/_main.tex`. - **Less is more.** Especially for short and lightning — ruthlessly cut. - **Audience calibration.** Job market = identification rigor. Seminar = interesting result. Lightning = sell the idea. - **Advisory scoring.** Talk scores don't block commits. - **Worker-critic pairing.** Storyteller creates, Discussant critiques. Never skip the review. - **Figures first.** Prefer maps (docs/overleaf/maps/), event study plots, and scatter plots over regression tables.