/debate-report

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:

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:

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 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`