council

Category: Tools & Productivity | Uploader: yogirk | Downloads: 0 | Version: v1.0（Latest）

Convene a panel of CLI-based AI agents (Codex, Gemini) to deliberate on a question. Each agent answers independently, then you synthesize the council's verdict as chairman. Use for architecture decisions, code review, debugging hypotheses, or any question where diverse perspectives add value.

Changelog: Source: GitHub https://github.com/yogirk/agent-council

Directory Structure

Current level: tree/main/skills/claude-code/

📁 agent-council-nudge/
- 📄 SKILL.md 4.2 KB
📁 council-list/
- 📄 SKILL.md 1.1 KB
📁 council-nudge/
- 📄 SKILL.md 1.7 KB
📁 council-outcome/
- 📄 SKILL.md 1.3 KB
📁 council-replay/
- 📄 SKILL.md 1.2 KB
📁 council-revisit/
- 📄 SKILL.md 1.7 KB
📄 SKILL.md 3.6 KB

SKILL.md

---
name: council
description: |
  Convene a panel of CLI-based AI agents (Codex, Gemini) to deliberate on a
  question. Each agent answers independently, then you synthesize the council's
  verdict as chairman. Use for architecture decisions, code review, debugging
  hypotheses, or any question where diverse perspectives add value.
allowed-tools:
  - Bash
  - Read
  - Write
---

# Agent Council

Convene a multi-agent council to deliberate on a question. You (Claude) are the
chairman. Other CLI agents (Codex, Gemini) provide independent opinions. You
synthesize the final verdict.

## Usage

The user invokes `/council "their question"` or `/council --with-review "their question"`.

## Step 1: Dispatch the council

Run this bash block. Replace `{QUESTION}` with the user's actual question text.

```bash
COUNCIL_BIN=""; for _d in "$HOME/.claude/skills/agent-council" "$HOME/.agents/skills/agent-council" "$HOME/.gemini/skills/agent-council" "$(git rev-parse --show-toplevel 2>/dev/null)"; do [ -x "$_d/bin/council" ] && COUNCIL_BIN="$_d/bin/council" && break; [ -x "$_d/council" ] && COUNCIL_BIN="$_d/council" && break; done; [ -z "$COUNCIL_BIN" ] && COUNCIL_BIN="$(which council 2>/dev/null || echo "bin/council")"
QUESTION_FILE=$(mktemp /tmp/council-q-XXXXXX)
cat <<'COUNCIL_EOF' > "$QUESTION_FILE"
{QUESTION}
COUNCIL_EOF
SLUG=$(basename "$(git rev-parse --show-toplevel 2>/dev/null || pwd)")
SESSION_DIR=$($COUNCIL_BIN --question-file "$QUESTION_FILE" --project "$SLUG")
rm -f "$QUESTION_FILE"
echo "SESSION_DIR=$SESSION_DIR"
```

If the user passed `--with-review`, add that flag to the council command.
If the user passed `--quick`, add that flag instead.

## Step 2: Read the council opinions

After the bash block completes, read the opinion files from the session directory:

1. Read `$SESSION_DIR/meta.json` to understand the session structure
2. Read each file in `$SESSION_DIR/stage1/` (opinion_codex.json, opinion_gemini.json, etc.)
3. If `--with-review` was used, also read files in `$SESSION_DIR/stage2/`

## Step 3: Synthesize as chairman

You are the chairman. You have the full conversation context with the user PLUS the
council opinions. Produce the synthesis:

- **Consensus:** Where all agents agree
- **Divergence:** Where agents disagree. State each position fairly with agent name.
- **Recommendation:** Your synthesized answer drawing from the strongest elements.
- **Confidence:**
  - If all agree: **HIGH** — Strong consensus across models.
  - If majority agrees: **MEDIUM** — Majority view with notable dissent.
  - If fundamental disagreement: **LOW — Agents fundamentally disagree.**
    For each agent, state: Agent name (their confidence): their position.
    End with: "This is a decision you should make yourself, not delegate to the council."

## Step 4: Save synthesis

Write your synthesis to `$SESSION_DIR/synthesis.json`:

```json
{
  "chairman": "claude",
  "consensus": "...",
  "divergence": "...",
  "recommendation": "...",
  "confidence": "high|medium|low",
  "timestamp": "ISO 8601"
}
```

## Step 5: Regenerate the viewer

After writing synthesis.json, regenerate the viewer so it includes your verdict:

```bash
$COUNCIL_BIN regenerate-viewer "$(basename "$SESSION_DIR")" --project "$SLUG"
```

## Step 6: Offer the viewer and next steps

Tell the user:

> Council viewer saved to: $SESSION_DIR/viewer.html — open in browser to explore the full deliberation.
>
> **Next steps:**
> - Re-evaluate later with current context: `/council-revisit {SESSION_ID}`
> - Record how this decision played out: `/council-outcome {SESSION_ID} "what happened"`
> - Browse past sessions: `/council-list`

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

council

Directory Structure

SKILL.md

Report

Notice