# Clarity Council

> Facilitates structured single-persona or multi-persona consultation for strategy, product, engineering, operations, and risk decisions. Use when the user requests a council, multiple perspectives, persona advice, tradeoff analysis, or iterative clarification and debate.

- Skill: `risadams/clarity-council` (Agent Skill, multi-file: 41 files)
- Install (CLI): `npx skillmds@latest add risadams/clarity-council`
- Raw SKILL.md: https://api.skillmd.com/api/skills/risadams/clarity-council/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: risadams (https://skillmd.com/u/risadams)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/risadams/clarity-council

---


# Clarity Council: Agent-Based System

This skill routes to three specialized agents in the `agents/00-council/` folder. Use the appropriate agent based on your decision-making need.

## When to use

Use this system when you need any of the following:
- Quick expert opinion from one persona
- Multiple expert viewpoints with synthesis
- Iterative decision-making with clarifications
- Structured tradeoff analysis

Do not use for pure factual lookup with no decision component.

## Which Agent to Use?

### Single Expert Perspective
**Agent**: `council-single-persona`  
**When**: You need focused advice from one expert (quick, 10–15 min)  
**Example**: "As a senior-architect, should we migrate to microservices?"

### Multiple Expert Synthesis
**Agent**: `council-multi-persona`  
**When**: A decision needs multiple viewpoints synthesized (20–30 min)  
**Example**: "Convene a council on Kubernetes adoption."

### Iterative Decision-Making
**Agent**: `council-iterative`  
**When**: You need multi-turn iteration with clarifications (30–60 min, 3–5 turns)  
**Example**: "Run a council on team restructuring. I'll iterate."

## Agent Invocation

Simply invoke the appropriate agent directly:

```
/council-single-persona
  As a product-owner, should we ship this quarter?

/council-multi-persona
  Convene a council on whether to adopt TypeScript.

/council-iterative
  Run a council on payment processor selection. I'll iterate.
```

See the full documentation at `agents/00-council/README.md` and `agents/00-council/INDEX.md`.

## Output templates

Use these structures exactly unless the user asks for a different format.

### Single persona output

```markdown
summary: <short answer>
advice:
- <point>
assumptions:
- <assumption>
questions:
- <question>
next_steps:
- <action>
confidence: <low|medium|high>
```

### Multi-persona output

```markdown
responses:
- persona: <name>
  summary: <short answer>
  advice:
  - <point>
  assumptions:
  - <assumption>
  questions:
  - <question>
  next_steps:
  - <action>
  confidence: <low|medium|high>

synthesis:
  agreements:
  - <point>
  conflicts:
  - <point>
  risks_tradeoffs:
  - <point>
  next_steps:
  - <action>
```

### Multi-turn discussion output

```markdown
status: <needs_clarification|in_progress|completed>
message: <short user-facing response>
nextAction: <what is needed next>
output:
  <single-persona or multi-persona structure>
state:
  sessionId: <id>
  turn: <number>
  history:
  - <compact turn summary>
```

## Reference Files

Agent documentation:
- `agents/00-council/README.md` — Comprehensive guide to all agents
- `agents/00-council/INDEX.md` — Quick navigation and decision tree
- `agents/00-council/council-single-persona.md` — Single expert agent
- `agents/00-council/council-multi-persona.md` — Multi-expert synthesis agent
- `agents/00-council/council-iterative.md` — Iterative decision agent

Persona library:
- [skills/personas/PERSONAS.md](skills/personas/PERSONAS.md) — Full persona index
- [skills/personas/GROUPS.md](skills/personas/GROUPS.md) — Pre-made persona panels
- [skills/personas/*.md](skills/personas/) — Individual persona contracts (35+ total)

## Quality checks

Before finalizing a response:
- ensure recommendations tie to stated constraints
- separate assumptions from facts
- include at least one concrete next step
- include at least one explicit risk or tradeoff for non-trivial decisions
- keep terminology consistent with persona names in [skills/personas/PERSONAS.md](skills/personas/PERSONAS.md)