Initial commit

commands/debate-report.md

@@ -0,0 +1,145 @@
+---
+description: Generate comprehensive debate report with analysis and visualization
+argument-hint: [slug]
+---
+
+# Generate Debate Report
+
+Analyzes the debate and generates a comprehensive report with argument graph visualization.
+
+## Arguments
+
+- `$1`: Debate slug (optional if only 1 debate exists)
+
+## Step 1: Determine Debate
+
+**If `$1` provided:**
+- Use it
+
+**If no `$1`:**
+- List debates
+- If 0: "No debates found."
+- If 1: Auto-use that debate
+- If 2+: "Which debate? {list}"
+
+## Step 2: Convert Argument Graph to PNG
+
+Try to convert `{debate}/argument-graph.mmd` to PNG image:
+
+```bash
+mmdc -i {debate}/argument-graph.mmd -o {debate}/argument-graph.png -t dark -b transparent -s 4
+```
+
+**If conversion succeeds:**
+- Note: "✓ Graph visualization created"
+- Set `image_exists = true`
+- Continue to Step 3
+
+**If conversion fails:**
+
+Check if `mmdc` (mermaid-cli) is installed:
+```bash
+which mmdc || command -v mmdc
+```
+
+**If not installed, present options:**
+
+"**Graph visualization requires mermaid-cli (not currently installed).**
+
+Choose how to proceed:
+
+**1. Install and retry** - Install [mermaid-cli](https://github.com/mermaid-js/mermaid-cli) then run this command again
+   - npm: `npm install -g @mermaid-js/mermaid-cli`
+   - Docker: `docker pull minlag/mermaid-cli` (requires creating a shell alias for `mmdc`)
+
+**2. Convert manually** - Convert the graph yourself and continue
+   - Copy contents of `{debate}/argument-graph.mmd`
+   - Convert online at: https://mermaid.live
+   - Download PNG and save as `{debate}/argument-graph.png`
+   - Reply: **'Image provided, continue'**
+
+**3. Skip visualization** - Generate report without the graph image
+   - Reply: **'Skip image, continue'**"
+
+Wait for user input:
+- If "1": Exit with message "Install mermaid-cli and re-run `/debate-report {slug}`"
+- If "2": Set `image_exists = true`, continue to Step 3
+- If "3": Set `image_exists = false`, continue to Step 3
+
+## Step 3: Generate Comprehensive Report
+
+Use Task tool with subagent_type "general-purpose" to generate analysis:
+
+**Prompt:**
+
+```
+Generate a comprehensive debate report for the debate at {debate}/.
+
+Read and analyze:
+- Motion from @{debate}/debate.md
+- All arguments in @{debate}/arguments/
+- Scores from @{debate}/scores.json
+- Debate state and cumulative scores from @{debate}/debate.md frontmatter
+
+Your task is to write a compelling, high-level analysis in **500-600 words** that captures the intellectual battle and hooks readers. This is a summary for someone who hasn't read the full debate yet—make it engaging and insightful, not exhaustive.
+
+**Required structure:**
+
+# [Motion Title]
+
+## The Question
+1-2 sentences capturing what's at stake and why it matters
+
+## The Clash
+100-150 words on the fundamental disagreement. What core assumptions or frameworks divide the sides?
+
+## Turning Points
+150-200 words on 2-3 key moments that shifted the debate's trajectory. Focus on the most dramatic or intellectually significant developments.
+
+## The Verdict
+100-150 words: Final scores (zero-sum totals), strongest/weakest arguments with IDs, and your assessment of who won and why
+
+{if image_exists:}
+## Argument Graph
+
+![Argument Graph](./argument-graph.png)
+{/if}
+
+**Style guidelines:**
+- Use rich markdown: headings (##, ###), **bold**, *italic*
+- Match tone to debate topic (serious debates = analytical tone, lighter topics = can be more engaging)
+- Strictly avoid em-dashes and en-dashes
+- Focus on clarity and intellectual substance over exhaustive detail
+- 500-600 words total (strictly enforced)
+
+Output ONLY the complete markdown content for the README.md file.
+```
+
+Save agent output to `{debate}/README.md`.
+
+## Step 4: Completion Message
+
+**If image exists:**
+```
+✓ Debate report generated successfully!
+
+**Generated files:**
+- {debate}/README.md (comprehensive analysis)
+- {debate}/argument-graph.png (visual graph)
+
+View the report: `cat {debate}/README.md`
+```
+
+**If image skipped:**
+```
+✓ Debate report generated successfully!
+
+**Generated file:**
+- {debate}/README.md (comprehensive analysis)
+
+Note: Graph visualization was skipped. You can generate it later by:
+1. Installing [mermaid-cli](https://github.com/mermaid-js/mermaid-cli): `npm install -g @mermaid-js/mermaid-cli`
+2. Running: `mmdc -i {debate}/argument-graph.mmd -o {debate}/argument-graph.png -t dark -b transparent`
+
+View the report: `cat {debate}/README.md`
+```