assafkip/kipi-system/council

Council

Multi-agent debate for founder decisions. 4 personas argue a topic across structured rounds, respond to each other's actual points, then synthesize. Produces a visible transcript and a recommended path.

When to Use

Invoke when:

• Conflicting signals from conversations and you need to decide which to follow
• About to change positioning in canonical files (/q-calibrate)
• Design partner asks for something that might pull you off-wedge
• Investor feedback contradicts buyer feedback
• Competitive move detected and you need a response strategy
• Any decision where "it depends" means you need structured tension
• User says "council", "debate this", "weigh options", "get perspectives"

Workflow Routing

Default to Quick. Use Debate only for positioning changes, pre-investor prep, or decisions that affect canonical files.

The Personas

4 personas, each anchored to real project files. They read the files before speaking -- grounded opinions, not generic advice.

Persona Rules

• Every persona speaks from their anchored files, not from general knowledge
• If a canonical file is empty/template, the persona says "I don't have data to ground this" -- no guessing
• Personas reference specific entries from their files when making points
• Contrarian must raise at least one uncomfortable point per round

Output

Every council session produces:

1. Visible transcript -- the full debate, readable
2. Recommended path -- synthesized from convergence
3. Decision log entry -- appended to q-system/canonical/decisions.md with [COUNCIL-DEBATED] origin tag

Decision Log Format

### [Decision summary]
-**Date:** YYYY-MM-DD
-**Origin:** [COUNCIL-DEBATED]
-**Mode:** Quick / Debate
-**Trigger:** [What prompted this]
-**Convergence:** [Where personas agreed]
-**Dissent:** [Where they disagreed]
-**Decision:** [What the founder chose]
-**Founder action:** [APPROVED / MODIFIED / REJECTED] the recommendation

The founder always makes the final call. Council recommends, founder decides.

Integration with Q System

Token Budget

• Quick: ~20K tokens (4 agents x 1 round). Fine for daily use.
• Debate: ~60K tokens (4 agents x 3 rounds). Use for real decisions only.

Before running a Debate, ask: "Is this decision worth 60K tokens?" If the answer is "probably not," use Quick.