council-review

name	council-review
description	Multi-model validation council — auto-validate plans, architecture changes, and PRs via validate-plan/review before executing
when-to-use	When you write a plan to ~/.claude/plans/, make architectural changes, or before marking a PR done; required for CLAUDE-tier tasks
user-invocable	false
allowed-tools	["Bash","Read"]
effort	high

Council of Experts — Multi-Model Validation

When to Auto-Trigger

Plans (auto_validate_plans)

When you write a plan to ~/.claude/plans/, automatically validate it:

~/bin/validate-plan --threshold 2 ~/.claude/plans/<plan-file>.md

• 2+ of 3 approve → execute immediately
• 1 of 3 → surface reviewer feedback to user before proceeding
• 0 of 3 → revise plan, re-validate

Architecture Decisions (auto_review_architecture)

When making architectural changes (new services, API redesigns, database schema changes), run:

~/bin/review --all "Review this architecture: <summary>"

PR Review (auto_review_prs)

Before marking a PR as done, run:

~/bin/review --all --file <changed-files>

Configuration

Council behavior is configured in ~/.claude/council.yaml. The Maggy dashboard (Settings > Council) also manages this config.

Reviewer Contexts

Context	Default Reviewers	When
plan	DeepSeek Pro, Codex, Gemini Pro	Before executing any plan
review	DeepSeek Pro, Kimi	Code review, PR review
architecture	DeepSeek Pro, Gemini Pro, Grok	System design, schema changes

Threshold Rules

The threshold setting controls how many approvals are needed:

• threshold: 2 with 3 reviewers → need 2/3 to auto-execute
• Clamped to [1, reviewer_count] — can't be 0 or exceed available reviewers

Model Inventory

All 13 tiers are listed in ~/.claude/council.yaml under models:. Each has:

• id — unique identifier
• cmd — CLI command to invoke (null for Claude models, which are the host)
• tier — routing priority (0=cheapest, 12=most capable)
• label — human-readable name

Use POST /api/models/health to verify all models are responding.

How This Skill is Used

This skill is loaded by Claude Code on session start. It provides the behavioral rules for when to invoke multi-model validation. The actual execution happens via ~/bin/validate-plan and ~/bin/review which are already installed.

Do not skip council validation for CLAUDE-tier tasks. The whole point is that architecture and security decisions get independent verification before execution.