council

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.

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."