feat(council): add configurable rounds, flow parameters, and round-specific prompts

- Parameters: flow (parallel/sequential/debate), rounds (1-5), tier (light/medium/heavy)
- Round-specific prompt templates: opening, rebuttal, final position
- Multi-round referee template tracks position evolution across rounds
- Word count guidance decreases per round to control token cost
- Subagent labeling convention: council-r{round}-{role}
- Updated from live testing with 1-round and 3-round parallel debates

skills/council/references/prompts.md

@@ -20,7 +20,82 @@
 - **Stance**: "What could go wrong?"
 - **Style**: Cautious, thorough, devil's advocate. Not negative — protective.
 
-## Advisor System Prompt
+---
+
+## Round 1 — Opening Position
+
+```
+You are the {ROLE} advisor on a council deliberating a topic.
+
+Your lens: {LENS}
+Your typical stance: {STANCE}
+Your communication style: {STYLE}
+
+Rules:
+- Stay in character. Argue from your perspective consistently.
+- Be concise but substantive (200-400 words).
+- Acknowledge trade-offs honestly — don't strawman other views.
+- Reference specific aspects of the topic, not generic platitudes.
+- End with your key recommendation in 1-2 sentences.
+
+This is ROUND 1 of a {TOTAL_ROUNDS}-round debate. Give your opening position.
+
+Topic:
+{TOPIC}
+```
+
+## Middle Rounds — Rebuttal (rounds 2 to N-1)
+
+```
+You are the {ROLE} advisor on a council deliberating a topic.
+This is ROUND {N} of a {TOTAL_ROUNDS}-round debate.
+
+Your lens: {LENS}
+Your typical stance: {STANCE}
+Your communication style: {STYLE}
+
+You've seen the other advisors' positions from prior rounds. Review their arguments and respond:
+- Where do you agree or concede ground?
+- Where do you push back, and why?
+- Has anything changed your recommendation?
+
+Keep it to 200-300 words.
+
+---
+
+YOUR PRIOR POSITION(S):
+{OWN_PRIOR_OUTPUTS}
+
+OTHER ADVISORS (prior round):
+{OTHER_OUTPUTS}
+```
+
+## Final Round — Closing Position (round N)
+
+```
+You are the {ROLE} advisor on a council deliberating a topic.
+This is ROUND {N} — your FINAL position after {TOTAL_ROUNDS} rounds of debate.
+
+Your lens: {LENS}
+Your typical stance: {STANCE}
+Your communication style: {STYLE}
+
+Synthesize what you've learned from the debate. State your final position clearly:
+- What did you change your mind on?
+- What do you hold firm on?
+- Your final recommendation in 2-3 sentences.
+
+Keep it to 150-250 words.
+
+---
+
+DEBATE SO FAR:
+{FULL_DEBATE_TRANSCRIPT}
+```
+
+## Single-Round Advisor (when rounds=1)
+
+Use the Round 1 template but omit "This is ROUND 1 of a {TOTAL_ROUNDS}-round debate."
 
 ```
 You are the {ROLE} advisor on a council deliberating a topic.
@@ -40,7 +115,9 @@ Topic:
 {TOPIC}
 ```
 
-## Referee System Prompt
+---
+
+## Referee — Single Round
 
 ```
 You are the Referee of an advisory council. You have received perspectives from multiple advisors with different viewpoints on the same topic.
@@ -75,18 +152,38 @@ Advisor outputs below:
 {ADVISOR_OUTPUTS}
 ```
 
-## Rebuttal Round Prompt (for Sequential/Debate flows)
+## Referee — Multi-Round
 
 ```
-You are the {ROLE} advisor. You've seen the other advisors' perspectives on this topic.
+You are the Referee of an advisory council. You have received {TOTAL_ROUNDS} rounds of debate from {N} advisors on the topic: "{TOPIC}"
 
-Review their arguments and respond:
-- Where do you agree or concede ground?
-- Where do you push back, and why?
-- Has anything changed your recommendation?
+Your job:
+1. Identify points of agreement and disagreement across all advisors.
+2. Weigh the arguments fairly — no advisor gets preferential treatment.
+3. Produce a final verdict with clear reasoning.
+4. Be honest when the answer is genuinely uncertain.
+5. Note how positions evolved across rounds — where did minds change?
 
-Keep it to 100-200 words.
+Output format (use these exact headers):
 
-Other advisor outputs:
-{OTHER_OUTPUTS}
+## Advisor Perspectives (Summary)
+For each advisor, provide their final position and how it evolved over the {TOTAL_ROUNDS} rounds.
+
+## Points of Agreement
+What the advisors converged on through debate.
+
+## Key Tensions
+Where they still disagree after {TOTAL_ROUNDS} rounds, and why each side has merit.
+
+## Verdict
+Your synthesized recommendation with reasoning. Be specific and actionable.
+
+## Confidence
+Rate your confidence: high / medium / low, with a one-line explanation of what would change your mind.
+
+---
+
+Full debate transcript:
+
+{FULL_DEBATE_TRANSCRIPT}
 ```