skills/debate/SKILL.md
Use when you want multiple agents to debate and find optimal solutions.
npx skillsauth add seokan-jeong/team-shinchan team-shinchan:debateInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
If args empty: ask user for topic and STOP. If args > 2000 chars: truncate + warn.
All debates invoke Midori via Task tool.
| Trigger YES | Trigger NO | |-------------|------------| | 2+ approaches, architecture change, pattern break, perf vs readability, security, tech stack | Simple CRUD, clear bug fix, user already decided |
On detection: announce "Design decision needed: [situation]", proceed Steps 1-3. Record decision in REQUESTS.md (Stage 1) or PROGRESS.md (Stage 2+).
This skill (Midori, consensus-seeking, cheap, auto-triggerable) is Tier 1 and the default. For irreversible / high-stakes decisions, escalate to Tier 2 — team-shinchan:fierce-debate (a deterministic main-loop Workflow with a non-skippable refutation round + scored judge).
| Stay on Tier 1 (this skill) | Escalate to fierce-debate | |---|---| | Reversible, low-stakes, simple 2-option | Irreversible: schema migration, public API contract, security boundary, data-loss | | Quick consensus acceptable | A guaranteed refutation round is worth the cost | | Auto-triggered, silent | Explicit user opt-in only (Workflow can't fire silently) |
Auto-detect never silently jumps to Tier 2 — on a high-stakes detection, announce the design decision and offer the opt-in; the user launches /team-shinchan:fierce-debate. Both tiers write to the same .shinchan-docs/debate-decisions.md ledger (see agents/_shared/debate-decisions.md).
Triggers: args contains any of: "경쟁 구현", "competitive", "best of N", "best of", "parallel implementation", "competitive-code"
If competitive-code trigger detected:
Tier 2 escalation: this Midori/worktree path is the cheap default. For a high-value contested implementation where you want a deterministic, schema-validated tournament (read-only builders → scored judge → winner picked by score, applied + tested), escalate to
team-shinchan:fierce-compete(opt-in main-loop Workflow). Never silently jump to it; offer the opt-in.
Task(
subagent_type="team-shinchan:midori",
model="sonnet",
prompt=`Competitive Code mode invoked.
## Request
${implementation_request}
## Parameters
- N implementations: ${N} (max 3)
- Mode: competitive-code
## Instructions
Run the competitive-code workflow:
1. ToolSearch for EnterWorktree schema before starting (HR-3)
2. Set .current-agent to midori before parallel Task calls (HR-1)
3. Dispatch N Bo subagents each in an isolated worktree via EnterWorktree
4. Collect implementation reports from all Bo agents
5. Dispatch Action Kamen to judge all implementations using rubric scoring (FR-2.1)
6. Announce winner and score comparison table
7. Merge winner worktree to main, ExitWorktree all others
8. Guarantee cleanup on error (NFR-3)
9. Record decision in .shinchan-docs/debate-decisions.md
See agents/midori.md ## Competitive Code Workflow for full procedure.`
)
After Midori returns:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏆 Competitive Code Results
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 Request: {implementation_request}
👥 Implementations: {N}
🥇 Winner: Bo-{N} | Score: {score}/15
📊 Score Comparison: [all Bo scores]
✅ Merged: winner changes applied
🧹 Cleanup: all worktrees removed
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Ask user if they accept the winner's implementation. If yes: proceed to completion. If no: offer to run competitive-code again or accept a specific implementation.
STOP. Steps 1-CC through 3-CC handle the full competitive-code workflow. Do NOT proceed to Step 1 (standard debate) when competitive-code mode was detected.
Task(subagent_type="team-shinchan:midori", model="sonnet",
prompt="Debate topic: {topic}\nPanel: {panel list}\nProcedure: Announce, collect opinions (parallel), ALWAYS run a separate refutation round (even on apparent agreement), then a separate scored judge picks the winner with surviving dissent, report decision.")
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💭 Debate Results
📋 Topic: {topic}
🎤 Opinions: [Agent]: {summary} ...
✅ Decision: {conclusion} | 📝 Rationale: {reasoning}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Ask user if they agree. If yes: document and proceed. If no: revise reflecting concerns. Never proceed without confirmation.
.shinchan-docs/debates/DECISION-{NNN}.json for traceabilitySee agents/midori.md for full criteria. Quick reference:
| Topic | Panel | |-------|-------| | Frontend/UI | Aichan, Hiroshi | | Backend/API | Buriburi, Hiroshi | | DevOps/Infra | Masao, Hiroshi | | Architecture | Hiroshi, Nene, Misae | | Security | Hiroshi, Buriburi, Masao |
Keywords: "A or B", "vs", "method1/method2", "schema change", "layer", "structure", "differs from existing pattern", "trade-off", "at the cost of", "auth", "encryption", "permission"
testing
Default-on interview option-quality panel — N diverse generators produce structure-free options, a SelfCheckGPT majority-vote consensus filters hallucinations, a SteerConf cautious-confidence judge scores survivors, and a deterministic top-K is returned. Workflow tier; the single fierce-* skill that is ON by default.
development
Deterministic adversarial code review for high-stakes scope — independent per-dimension review, a non-skippable per-finding refutation, completeness + interaction critics, and a deterministic 3-lens rubric judge panel. Opt-in main-loop Workflow tier.
data-ai
Deterministic loop-until-done for high-stakes long-running tasks — a worker/verifier loop the script bounds by iteration cap, token budget, and stagnation, closed by an Action-Kamen gate. Opt-in main-loop Workflow tier.
testing
Deterministic adversarial debate for high-stakes or irreversible decisions — mandatory refutation plus a scored judge panel. Opt-in main-loop Workflow tier.