---
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:
```bash
~/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:
```bash
~/bin/review --all "Review this architecture: <summary>"
```
### PR Review (auto_review_prs)
Before marking a PR as done, run:
```bash
~/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.