| name | cursor-debate |
| description | Run a research-first, multi-perspective debate to explore complex technical decisions (trade-offs, architecture choices, integration strategies) using concrete codebase evidence. Use when the user asks to "debate" approaches, compare options, or needs a structured exploration before deciding. |
Cursor Debate
Overview
Structure an evidence-based “debate round” to surface ideas and trade-offs; the debate does not decide, it informs the human decision-maker.
Workflow
1) Define the question
- Write the precise decision question (1 sentence).
2) Choose candidates
- Include 3–6 perspectives total.
- Human personas (pragmatist, architect, researcher, integrator, tool builder)
- Optional “code entity” personas (actual modules/symbols), backed by real file evidence
3) Research first (required)
- For each candidate, list questions they need answered.
- Run concrete repo inspection (examples):
rg -n "...", git grep, git log -p -- <path>, go test ./..., etc.
- Record commands + key outputs in “Pre-Debate Research”.
4) Debate round
- Opening statements (Round 1)
- Rebuttals (Round 2)
- Moderator summary (tensions, trade-offs, open questions)
Output template
Use the canonical outline in references/debate.md.
