ai-consultants 2.20.0 → 2.21.1

package/.claude/commands/ai-consultants:consult.md

@@ -1,5 +1,5 @@
 ---
-description: Consult AI experts (Gemini, Codex, Mistral, Kilo, Cursor, Aider, Amp, Kimi, Qwen, GLM, Grok, DeepSeek, MiniMax, Ollama) for coding questions. Use when weighing trade-offs, comparing approaches, or wanting multiple expert perspectives on non-trivial decisions.
+description: Consult AI experts (Gemini, Codex, Mistral, Cursor, Kimi, Qwen, GLM, Grok, DeepSeek, MiniMax) for coding questions. Use when weighing trade-offs, comparing approaches, or wanting multiple expert perspectives on non-trivial decisions.
 argument-hint: <question> [file1] [file2] ...
 allowed-tools: Bash Read Glob Grep
 ---

package/CLAUDE.md

@@ -2,11 +2,11 @@
 
 ## Project Overview
 
-AI Consultants is a multi-model AI deliberation system that queries up to 15 AI consultants (Gemini, Codex, Mistral, Kilo, Cursor, Aider, Amp, Kimi, Claude, Qwen3, GLM, Grok, DeepSeek, MiniMax, Ollama) to obtain diverse perspectives on coding problems.
+AI Consultants is a multi-model AI deliberation system that queries up to 11 AI consultants (Gemini, Codex, Mistral, Cursor, Kimi, Claude, Qwen3, GLM, Grok, DeepSeek, MiniMax) to obtain diverse perspectives on coding problems.
 
 **Self-Exclusion**: The invoking agent is automatically excluded from the panel to prevent self-consultation. Claude Code won't query Claude, Codex CLI won't query Codex, etc.
 
-**Version**: 2.20.0
+**Version**: 2.21.1
 
 ## Distribution
 
@@ -38,6 +38,7 @@ ai-consultants/
 │   ├── consult_all.sh          # Main orchestrator - entry point
 │   ├── config.sh               # Centralized configuration
 │   ├── doctor.sh               # Diagnostic and auto-fix tool (v2.2)
+│   ├── update_clis.sh          # Check/update installed consultant CLIs (v2.21)
 │   ├── peer_review.sh          # Anonymous peer review (v2.2)
 │   ├── roster_audit.sh         # Roster uncorrelated-value audit (v2.20)
 │   ├── roster_calibrate.sh     # Measured capability calibration, Tier A (v2.20)
@@ -46,7 +47,6 @@ ai-consultants/
 │   ├── install.sh              # One-liner installer (v2.2)
 │   ├── query_*.sh              # Wrapper for each consultant
 │   ├── query_claude.sh         # Claude consultant (v2.2)
-│   ├── query_ollama.sh         # Local model support (v2.2)
 │   ├── synthesize.sh           # Auto-synthesis of responses
 │   ├── debate_round.sh         # Multi-Agent Debate
 │   ├── classify_question.sh    # Question classifier
@@ -59,6 +59,7 @@ ai-consultants/
 │       ├── voting.sh           # Voting/consensus + confidence intervals
 │       ├── routing.sh          # Smart routing + cost-aware routing
 │       ├── orchestration.sh    # Dynamic orchestration planner + shapes (v2.16)
+│       ├── stance.sh           # Stance-based semantic consensus (v2.21, opt-in)
 │       ├── session.sh          # Session management
 │       ├── costs.sh            # Cost tracking + response limits
 │       ├── cache.sh            # Semantic caching (v2.3)
@@ -71,6 +72,7 @@ ai-consultants/
 ├── docs/
 │   ├── releases/             # Release notes (one per version)
 │   ├── SETUP.md              # Installation guide
+│   ├── RECIPES.md            # Copy-paste workflow configurations
 │   ├── COST_RATES.md         # Model pricing
 │   ├── SMART_ROUTING.md      # Affinity matrix
 │   └── JSON_SCHEMA.md        # Output schema
@@ -198,9 +200,8 @@ Functions in `lib/common.sh`:
 
 # Use Case Presets
 ./scripts/consult_all.sh --preset minimal "question"    # Gemini + Codex
-./scripts/consult_all.sh --preset balanced "question"   # + Mistral + Kilo
+./scripts/consult_all.sh --preset balanced "question"   # + Mistral + Cursor
 ./scripts/consult_all.sh --preset high-stakes "question" # All + debate
-./scripts/consult_all.sh --preset local "question"      # Ollama only
 ```
 
 Presets are defined in `config.sh` via `apply_preset()` function.
@@ -223,17 +224,6 @@ Strategies are implemented in `synthesize.sh` via `get_strategy_instructions()`.
 ./scripts/doctor.sh --verbose    # Detailed output
 ```
 
-### Ollama Local Models
-```bash
-ENABLE_OLLAMA=true ./scripts/consult_all.sh "question"
-OLLAMA_MODEL=codellama ./scripts/consult_all.sh "question"
-```
-
-Configuration in `config.sh`:
-- `OLLAMA_MODEL` - Model to use (default: hf.co/prithivMLmods/VibeThinker-3B-GGUF)
-- `OLLAMA_HOST` - Server URL (default: http://localhost:11434)
-- `OLLAMA_TIMEOUT` - Timeout in seconds (default: 300)
-
 ### Panic Button Mode
 Automatically adds rigor when uncertainty detected:
 - Average confidence below `PANIC_CONFIDENCE_THRESHOLD` (default: 5)
@@ -268,30 +258,6 @@ Functions in `lib/reflection.sh`:
 - `heuristic_overconfidence_check()` - Fast fallback without LLM
 - `judge_all_responses()` - Batch evaluation
 
-## v2.8 Features
-
-### Amp CLI Support
-Amp Code is now supported as a CLI-based consultant with "The Systems Thinker" persona.
-
-```bash
-# Enable Amp consultant
-export ENABLE_AMP=true
-./scripts/consult_all.sh "question"
-```
-
-**CLI Installation:**
-```bash
-curl -fsSL https://ampcode.com/install.sh | bash
-```
-
-**Environment Variables:**
-- `ENABLE_AMP` - Enable Amp consultant (default: false)
-- `AMP_CMD` - CLI command (default: amp)
-- `AMP_TIMEOUT` - Timeout in seconds (default: 180)
-- `AMP_API_KEY` - API key for authentication
-
-**Persona:** The Systems Thinker - Focuses on holistic system design, component interactions, and emergent behaviors.
-
 ## v2.9 Features
 
 ### Kimi CLI Support
@@ -312,7 +278,7 @@ curl -L code.kimi.com/install.sh | bash
 - `ENABLE_KIMI` - Enable Kimi consultant (default: false)
 - `KIMI_CMD` - CLI command (default: kimi)
 - `KIMI_TIMEOUT` - Timeout in seconds (default: 180)
-- `KIMI_MODEL` - Model identifier (default: kimi-code/kimi-for-coding)
+- `KIMI_MODEL` - Kimi CLI model alias (default: kimi-code/k3; passed explicitly with `--model`)
 
 **Persona:** The Eastern Sage - Focuses on holistic understanding, balance of perspectives, and wisdom from diverse viewpoints.
 
@@ -326,7 +292,7 @@ Qwen3 now supports CLI/API mode switching using the qwen-code CLI.
 export QWEN3_USE_API=false
 ./scripts/consult_all.sh "question"
 
-# API mode (default, preserves v2.6 behavior)
+# API mode (opt-in)
 export QWEN3_USE_API=true
 export QWEN3_API_KEY="your-dashscope-key"
 ./scripts/consult_all.sh "question"
@@ -342,7 +308,7 @@ npm install -g @qwen-code/qwen-code@latest
 ## v2.6 Features
 
 ### CLI/API Mode Switching
-Five consultants can now switch between CLI and API mode: **Gemini, Codex, Claude, Mistral, Qwen3**.
+Six consultants can now switch between CLI and API mode: **Gemini, Codex, Claude, Mistral, Qwen3, MiniMax**.
 
 When API mode is enabled for an agent, CLI mode is disabled (mutual exclusivity).
 
@@ -379,6 +345,7 @@ New environment variables in `config.sh`:
 | `CLAUDE_USE_API` | false | Use Anthropic API instead of claude CLI |
 | `MISTRAL_USE_API` | false | Use Mistral API instead of vibe CLI |
 | `QWEN3_USE_API` | false | Use DashScope API instead of qwen CLI (v2.7) |
+| `MINIMAX_USE_API` | false | Use MiniMax API instead of the mmx CLI (v2.21) |
 | `GEMINI_API_URL` | https://generativelanguage.googleapis.com/v1beta/models | Google AI endpoint |
 | `CODEX_API_URL` | https://api.openai.com/v1/chat/completions | OpenAI endpoint |
 | `CLAUDE_API_URL` | https://api.anthropic.com/v1/messages | Anthropic endpoint |
@@ -465,13 +432,10 @@ All consultants now use premium models by default:
 | Cursor | composer-2.5 |
 | DeepSeek | deepseek-v4-pro |
 | GLM | glm-5.2 |
-| Grok | grok-4.3 |
+| Grok | grok-4.5 |
 | Qwen3 | qwen3.7-max |
-| Kimi | kimi-code/kimi-for-coding |
-| Aider | qwen3-coder:free |
+| Kimi | kimi-code/k3 |
 | MiniMax | MiniMax-M2.7 |
-| Kilo | auto |
-| Ollama | hf.co/prithivMLmods/VibeThinker-3B-GGUF |
 
 Override with environment variables: `CLAUDE_MODEL`, `GEMINI_MODEL`, `CODEX_MODEL`, `KIMI_MODEL`, etc.
 
@@ -625,6 +589,12 @@ REPORT_MAX_JSON_LINES=50         # Max JSON lines in full report
 ## Testing
 
 ```bash
+# Full regression suite (required before committing/releasing)
+npm test
+
+# ShellCheck lint
+npm run lint
+
 # Full diagnostic
 ./scripts/doctor.sh
 
@@ -649,7 +619,7 @@ for f in scripts/*.sh scripts/lib/*.sh; do bash -n "$f" && echo "OK: $f"; done
 | Variable | Default | Description |
 |----------|---------|-------------|
 | `INVOKING_AGENT` | unknown | Agent invoking the skill (for self-exclusion) |
-| `ENABLE_CLAUDE` | false | Enable Claude consultant |
+| `ENABLE_CLAUDE` | true | Enable Claude consultant (auto-excluded under Claude Code) |
 | `ENABLE_DEBATE` | false | Enable Multi-Agent Debate |
 | `DEBATE_ROUNDS` | 1 | Number of debate rounds |
 | `ENABLE_SYNTHESIS` | true | Auto-synthesis of responses |
@@ -658,8 +628,6 @@ for f in scripts/*.sh scripts/lib/*.sh; do bash -n "$f" && echo "OK: $f"; done
 | `MAX_SESSION_COST` | 1.00 | Max budget ($) |
 | `ENABLE_PANIC_MODE` | auto | Panic mode trigger (v2.2) |
 | `PANIC_CONFIDENCE_THRESHOLD` | 5 | Panic threshold (v2.2) |
-| `ENABLE_OLLAMA` | false | Local model support (v2.2) |
-| `OLLAMA_MODEL` | hf.co/prithivMLmods/VibeThinker-3B-GGUF | Ollama model (v2.17 default) |
 | `CLAUDE_MODEL` | claude-opus-4-8 | Claude model (v2.5) |
 | `GEMINI_MODEL` | Gemini 3.1 Pro (High) | Gemini agy CLI model (v2.15) |
 | `GEMINI_API_MODEL` | gemini-3.1-pro-preview | Gemini API-mode model ID (v2.15) |
@@ -670,21 +638,25 @@ for f in scripts/*.sh scripts/lib/*.sh; do bash -n "$f" && echo "OK: $f"; done
 | `CACHE_TTL_HOURS` | 24 | Cache expiration in hours (v2.3) |
 | `ENABLE_RESPONSE_LIMITS` | false | Response token limits (v2.3, opt-in) |
 | `ENABLE_COST_AWARE_ROUTING` | false | Cost-based model routing (v2.3) |
-| `ENABLE_DEBATE_OPTIMIZATION` | false | Skip debate if all agree (v2.3, opt-in) |
+| `ENABLE_DEBATE_OPTIMIZATION` | true | Skip debate if all agree; SECURITY and ARCHITECTURE remain mandatory (default since v2.13) |
 | `ENABLE_COMPACT_REPORT` | true | Compact report format (v2.3) |
 | `ENABLE_CAPABILITY_WEIGHTING` | false | Capability-weighted voting (v2.20, opt-in) |
 | `ENABLE_CAPABILITY_ROUTING` | false | Capability-aware panel composition (v2.20, opt-in) |
 | `CAPABILITY_WEIGHT_STRENGTH` | 10 | Vote-weight modulation: conf*(S+cap)/S (v2.20) |
 | `CAPABILITY_DEFAULT` | 5 | Fallback capability for a missing consultant/axis (v2.20) |
+| `ENABLE_STANCE_CONSENSUS` | false | Enumerated-stance exact-match consensus (v2.21, opt-in; +1 LLM call/run) |
+| `STANCE_MAX_OPTIONS` | 5 | Max stance options generated per question (v2.21) |
 | `ENABLE_BUDGET_LIMIT` | false | Budget enforcement (v2.4, opt-in) |
 | `BUDGET_ACTION` | warn | Action on budget exceeded: warn/stop (v2.4) |
 | `QWEN3_USE_API` | false | Use DashScope API instead of qwen CLI (v2.7) |
 | `QWEN3_CMD` | qwen | Qwen CLI command (v2.7) |
-| `ENABLE_KIMI` | false | Enable Kimi consultant (v2.9) |
+| `ENABLE_KIMI` | true | Enable Kimi consultant (v2.9) |
 | `KIMI_CMD` | kimi | Kimi CLI command (v2.9) |
-| `KIMI_MODEL` | kimi-code/kimi-for-coding | Kimi model (v2.9) |
-| `ENABLE_MINIMAX` | false | Enable MiniMax consultant (v2.10) |
-| `MINIMAX_API_KEY` | - | MiniMax API key (v2.10) |
+| `KIMI_MODEL` | kimi-code/k3 | Kimi CLI model alias |
+| `ENABLE_MINIMAX` | true | Enable MiniMax consultant (v2.10; CLI via mmx v2.21) |
+| `MINIMAX_USE_API` | false | Use MiniMax API instead of the mmx CLI (v2.21) |
+| `MINIMAX_CMD` | mmx | MiniMax CLI command (v2.21) |
+| `MINIMAX_API_KEY` | - | MiniMax API key (API mode only) (v2.10) |
 | `MINIMAX_MODEL` | MiniMax-M2.7 | MiniMax model (v2.10) |
 
 ## External Dependencies
@@ -692,14 +664,11 @@ for f in scripts/*.sh scripts/lib/*.sh; do bash -n "$f" && echo "OK: $f"; done
 - `agy` CLI - Antigravity CLI (Gemini consultant; successor to the deprecated Gemini CLI, v2.15)
 - `codex` CLI - OpenAI Codex
 - `vibe` CLI - Mistral Vibe
-- `kilocode` CLI - Kilo Code
 - `agent` CLI - Cursor
-- `aider` CLI - Aider
-- `amp` CLI - Amp Code (v2.8)
 - `kimi` CLI - Kimi Code (v2.9)
 - `claude` CLI - Claude (v2.2, also used for synthesis)
 - `qwen` CLI - Qwen via qwen-code (v2.7, optional)
-- `ollama` CLI - Local models (v2.2)
+- `mmx` CLI - MiniMax via mmx-cli (v2.21, optional; `npm i -g mmx-cli`, auth `mmx auth login`)
 - `jq` - JSON parsing
 
 ## Error Handling and Retry
@@ -719,13 +688,12 @@ RETRY_DELAY_SECONDS=10
 # Per-consultant timeout
 GEMINI_TIMEOUT=240
 CODEX_TIMEOUT=180
-OLLAMA_TIMEOUT=300  # Longer for local inference
 ```
 
 ## Extended Documentation
 
 For detailed information, see:
-- [docs/SETUP.md](docs/SETUP.md) - Installation, authentication, Ollama setup
+- [docs/SETUP.md](docs/SETUP.md) - Installation and authentication
 - [docs/COST_RATES.md](docs/COST_RATES.md) - Rates and budget management
 - [docs/SMART_ROUTING.md](docs/SMART_ROUTING.md) - Affinity matrix and routing
 - [docs/JSON_SCHEMA.md](docs/JSON_SCHEMA.md) - Complete output schema
@@ -733,8 +701,8 @@ For detailed information, see:
 ## Development Notes
 
 - Scripts in `lib/` are libraries, not standalone executables
-- Output goes to `/tmp/ai_consultations/TIMESTAMP/`
-- Session state in `/tmp/ai_consultants_sessions/`
+- Output goes to `$XDG_CACHE_HOME/ai-consultants/consultations/TIMESTAMP/` (normally `~/.cache/ai-consultants/consultations/`)
+- Session state lives in `$XDG_STATE_HOME/ai-consultants/sessions/` (normally `~/.local/state/ai-consultants/sessions/`)
 - All timeouts are configurable in `config.sh`
 - Consultants can be disabled individually (`ENABLE_GEMINI=false`, etc.)
 - Use `.env.example` as template for environment configuration
@@ -834,6 +802,21 @@ curl -fsSL https://raw.githubusercontent.com/matteoscurati/ai-consultants/main/s
 
 ## Changelog
 
+### v2.21.1
+- **Kimi upgraded to K3.** `KIMI_MODEL` now defaults to `kimi-code/k3`; premium, standard, and economy tiers all resolve to the same K3 alias.
+- **Model selection is now real, not metadata-only.** `query_kimi.sh` passes `--model "$KIMI_MODEL"` to the CLI, overriding a stale user-level Kimi default. A dedicated offline regression test captures the CLI arguments and validates response metadata; a live K3 smoke test returned a structured response with confidence 10.
+- **Roster reduced from 15 to 11 supported consultants.** Kilo, Aider, Amp, and Ollama were removed end-to-end: canonical/default lists, presets, routing and personas, debate/synthesis/reflection, doctor/preflight, updater, configuration/wizard, schemas, tests, docs, and their four query adapters. `ENABLE_KILO`/`KILO_*`, `ENABLE_AIDER`/`AIDER_*`, `ENABLE_AMP`/`AMP_*`, `ENABLE_OLLAMA`/`OLLAMA_*`, and the Ollama-only `local` preset are obsolete and ignored.
+- **Documentation and release surfaces synced.** README, SKILL, `.env.example`, setup/configuration/recipes, cost catalog, changelog, release note, npm metadata, and the showcase site all identify Kimi K3. Version bumped to 2.21.1.
+
+### v2.21.0
+- **CLI-first transport (principle).** Every `*_USE_API` defaults `false`; a consultant with a CLI always uses it, API is opt-in (CLI-less model or explicit choice). `ENABLE_AMP`/`ENABLE_CLAUDE` default true.
+- **MiniMax via `mmx` CLI** (was API-only). `query_minimax.sh` runs `mmx text chat --non-interactive …` in CLI mode; `config.sh` adds `MINIMAX_CMD` + auto-resolves `MINIMAX_USE_API` (API iff `MINIMAX_API_KEY` set — back-compat), drops MiniMax from `API_CONSULTANTS`; `doctor.sh` treats it as switchable.
+- **`scripts/update_clis.sh`** (+ `ai-consultants update-clis`): per CLI-backed consultant, `detect_method` (brew formula/cask, npm, uv, pipx, pip, self-update, curl installer) → update. `--dry-run`, `--only`.
+- **Stance consensus** (opt-in, `ENABLE_STANCE_CONSENSUS`): new `lib/stance.sh` (`generate_stance_options` — one synthesizer call wrapped in `run_with_timeout`; `_stance_clean`; `build_stance_prompt`). `consult_all.sh` generates the shared set → `stance_options.json` + exports `STANCE_OPTIONS_PROMPT`; injected via `personas.sh` (CLI) + `api_query.sh` (API). `voting.sh::calculate_consensus_score` scores the plurality stance over the PANEL size (not the count of emitted stances). `STANCE_MAX_OPTIONS`, `STANCE_TIMEOUT`.
+- **Smoke-test reliability**: `query_gemini.sh` (`agy -p "$QUERY"`), `query_kimi.sh` (`stream-json` + `_kimi_extract_content`), `query_kilo.sh` (de-fence). Shared `_is_consultant_response_file` metadata filter in `common.sh`, applied across `voting.sh`/`synthesize.sh`/`peer_review.sh`/`reflection.sh`. `orchestration.sh` stalled→stable relabel (set -e-safe) + debate-round promote validation.
+- **Persona fix**: `_AGENT_DEFAULT_PERSONAS` mapped `GLM|17`/`DEEPSEEK|7` (each got the other's persona) → `GLM|7`/`DEEPSEEK|17`.
+- **Dev/reliability**: reliability tracking + Amp/Claude default-on; offline e2e test; `scripts/release.sh` version-bump automation; calibration fixes (diagnosable peer-review failures + cost-only path); `test_user_config.sh` XDG test made hermetic (unset the exported `_AI_CONSULTANTS_XDG_*` intermediates). `npm test` = 18 suites. Hardened by a `/code-review max` pass.
+
 ### v2.20.0
 - **Capability axes (borrowed from the delegation-kit cost/intelligence/taste table).** `references/affinity.json` → v1.1: new `capabilities` (per-consultant {intelligence, taste, cost}, 1-10), `category_axis` (category → the quality axis it stresses: taste for API_DESIGN/ARCHITECTURE/CODE_REVIEW/GENERAL, intelligence otherwise), `capability_default`. New `lib/routing.sh::get_capability` / `get_category_axis` (cached like `get_affinity`).
 - **Capability-weighted voting** (`ENABLE_CAPABILITY_WEIGHTING`, opt-in): `lib/voting.sh::_effective_vote_weight` modulates a vote by the consultant's capability on the run's axis — `confidence × (S + cap) / S` (`S = CAPABILITY_WEIGHT_STRENGTH`, default 10). Applied in `calculate_weighted_recommendation` and `calculate_final_score` (normalizer uses the same weight → 1-10 scale preserved). Axis from `QUESTION_CATEGORY`. `cost` never weights a vote (tie-break intelligence > taste > cost).

package/README.md

@@ -1,8 +1,8 @@
-# AI Consultants v2.20.0
+# AI Consultants v2.21.1
 
-> **A harness for every question.** A panel of up to 15 frontier models that writes its own playbook per question — fan out, debate to convergence, cross-examine under adversarial review, or run a tournament — and checks its work before it reaches you.
+> **A harness for every question.** A panel of up to 11 frontier models that writes its own playbook per question — fan out, debate to convergence, cross-examine under adversarial review, or run a tournament — and checks its work before it reaches you.
 
-[![Version](https://img.shields.io/badge/version-2.20.0-blue.svg)](https://github.com/matteoscurati/ai-consultants)
+[![Version](https://img.shields.io/badge/version-2.21.1-blue.svg)](https://github.com/matteoscurati/ai-consultants)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Claude Code Skill](https://img.shields.io/badge/Claude%20Code-Skill-orange.svg)](https://docs.anthropic.com/en/docs/claude-code/skills)
 [![GitHub stars](https://img.shields.io/github/stars/matteoscurati/ai-consultants?style=social)](https://github.com/matteoscurati/ai-consultants)
@@ -20,11 +20,11 @@
   - [OpenAI Codex CLI](#openai-codex-cli)
   - [Gemini CLI](#gemini-cli)
   - [Cursor / Copilot / Windsurf](#cursor--copilot--windsurf-via-skillport)
-  - [Aider](#aider)
   - [Standalone Bash](#standalone-bash)
 - [Consultants](#consultants)
 - [Quality Tiers](#quality-tiers)
 - [Configuration](#configuration)
+  - [Configuration Recipes](#configuration-recipes)
 - [How It Works](#how-it-works)
 - [Best Practices](#best-practices)
 - [Documentation](#documentation)
@@ -42,9 +42,8 @@ Instead of running a fixed script, it classifies your question, picks an orchest
 - **Dynamic orchestration** — the engine chooses the strategy per question: a quick read, a convergence loop, an adversarial refutation gate, a tournament of approaches, or an exhaustive sweep
 - **Convergence, not fixed rounds** — debate iterates until the panel actually agrees (or provably won't), instead of a hardcoded count
 - **Self-checking** — security answers are stress-tested by consultants trying to refute them before anything reaches you
-- **15 frontier models** with distinct personas (Architect, Pragmatist, Devil's Advocate, …)
+- **11 supported consultants** with distinct personas (Architect, Pragmatist, Devil's Advocate, …)
 - **Confidence-weighted synthesis** — one recommendation, with the dissent and the path it took surfaced so you know how much to trust it
-- **Local + private** — runs fully offline via Ollama when you need it
 
 ---
 
@@ -174,8 +173,8 @@ For CLI-based consultants, you'll also need:
 
 | Dependency | Required for |
 |------------|--------------|
-| **Node.js 18+** | Gemini CLI, Codex CLI, Kilo CLI |
-| **Python 3.8+** | Mistral Vibe CLI, Aider |
+| **Node.js 18+** | Gemini CLI, Codex CLI, Qwen CLI, MiniMax CLI |
+| **Python 3.8+** | Mistral Vibe CLI |
 
 ```bash
 # macOS
@@ -321,37 +320,6 @@ skillport status ai-consultants
 
 ---
 
-### Aider
-
-> **Status:** ✅ Via AGENTS.md
-
-**Installation:**
-
-```bash
-git clone https://github.com/matteoscurati/ai-consultants.git
-cd ai-consultants
-# Aider reads AGENTS.md for skill instructions
-```
-
-**Usage:**
-
-Reference the skill in your Aider session:
-
-```
-/add AGENTS.md
-# Then ask: "Use ai-consultants to review my code"
-```
-
-**Self-Exclusion:** When using Aider as the invoking agent, set `INVOKING_AGENT=aider`.
-
-**Verify:**
-
-```bash
-./scripts/doctor.sh
-```
-
----
-
 ### Standalone Bash
 
 > **Status:** ✅ Direct execution
@@ -410,28 +378,22 @@ INVOKING_AGENT=codex ./scripts/consult_all.sh "Question"    # Codex excluded
 | **Google Gemini** | `agy` | The Architect | Design patterns, scalability, enterprise |
 | **OpenAI Codex** | `codex` | The Pragmatist | Simplicity, quick wins, proven solutions |
 | **Mistral Vibe** | `vibe` | The Devil's Advocate | Problems, edge cases, vulnerabilities |
-| **Kilo Code** | `kilocode` | The Innovator | Creativity, unconventional approaches |
 | **Cursor** | `agent` | The Integrator | Full-stack perspective |
-| **Aider** | `aider` | The Pair Programmer | Collaborative coding |
-| **Amp** | `amp` | The Systems Thinker | System design, interactions, emergent behavior |
-| **Kimi** | `kimi` | The Eastern Sage | Holistic, balanced perspectives |
+| **Kimi K3** | `kimi` | The Eastern Sage | Holistic, balanced perspectives |
 | **Claude** | `claude` | The Synthesizer | Big picture, synthesis, connecting ideas |
+| **Qwen3** | `qwen` | The Analyst | Data-driven analysis |
+| **MiniMax** | `mmx` | The Pragmatic Optimizer | Performance, efficiency, pragmatism |
+
+Qwen3 and MiniMax can switch from their CLI to API transport. Gemini, Codex,
+Claude, and Mistral are also CLI/API switchable.
 
-### API-Based Consultants
+### API-Only Consultants
 
 | Consultant | Default Model | Persona | Focus |
 |------------|---------------|---------|-------|
-| **Qwen3** | qwen3.7-max | The Analyst | Data-driven analysis |
 | **GLM** | glm-5.2 | The Methodologist | Structured approaches |
-| **Grok** | grok-4.3 | The Provocateur | Challenge conventions |
+| **Grok** | grok-4.5 | The Provocateur | Challenge conventions |
 | **DeepSeek** | deepseek-v4-pro | The Code Specialist | Algorithms, code generation |
-| **MiniMax** | MiniMax-M2.7 | The Pragmatic Optimizer | Performance, efficiency, pragmatism |
-
-### Local Consultants
-
-| Consultant | Default Model | Persona | Focus |
-|------------|---------------|---------|-------|
-| **Ollama** | hf.co/prithivMLmods/VibeThinker-3B-GGUF | The Local Expert | Privacy-first, zero API cost |
 
 ### Installing Consultant CLIs
 
@@ -441,17 +403,21 @@ At least 2 consultant CLIs are required:
 curl -fsSL https://antigravity.google/cli/install.sh | bash  # Gemini (Antigravity CLI: agy)
 npm install -g @openai/codex           # Codex
 pip install mistral-vibe               # Mistral
-npm install -g @kilocode/cli           # Kilo
 curl https://cursor.com/install -fsS | bash  # Cursor
 
 # Optional CLI-based consultants
-curl -fsSL https://ampcode.com/install.sh | bash  # Amp
-curl -L code.kimi.com/install.sh | bash            # Kimi
+curl -L code.kimi.com/install.sh | bash            # Kimi K3
 npm install -g @qwen-code/qwen-code@latest  # Qwen (alternative to API)
+npm install -g mmx-cli                       # MiniMax
 
-# For local inference (optional)
-curl -fsSL https://ollama.com/install.sh | sh
-ollama pull llama3.2
+```
+
+Kimi is pinned to K3 for every consultation, even if the user's Kimi CLI has a
+different default model:
+
+```bash
+KIMI_MODEL=kimi-code/k3 ai-consultants \
+  "Review this API design from a holistic perspective"
 ```
 
 ---
@@ -464,10 +430,9 @@ Choose the right balance of quality, speed, and cost with model quality tiers.
 
 | Preset | Tier | Agents | Debate | Reflection | Use Case |
 |--------|------|--------|--------|------------|----------|
-| `max_quality` | Premium | 7 (all) | 3 rounds | 2 cycles + peer review | Critical decisions |
+| `max_quality` | Premium | 8 | 3 rounds | 2 cycles + peer review | Critical decisions |
 | `medium` | Standard | 4 | 1 round | No | General questions |
 | `fast` | Economy | 2 | No | No | Quick checks |
-| `local` | Economy | 1 (Ollama) | No | No | Full privacy |
 
 ### Models by Tier
 
@@ -480,11 +445,10 @@ Choose the right balance of quality, speed, and cost with model quality tiers.
 | Cursor | composer-2.5 | composer-2 | gemini-3-flash |
 | DeepSeek | deepseek-v4-pro | deepseek-v4-flash | deepseek-v4-flash |
 | GLM | glm-5.2 | glm-5.2 | glm-4-flash |
-| Grok | grok-4.3 | grok-4.1-fast | grok-4.1-fast |
+| Grok | grok-4.5 | grok-4.1-fast | grok-4.1-fast |
 | Qwen3 | qwen3.7-max | qwen3.6-35b-a3b | qwen3-32b |
-| Aider | qwen3-coder:free | gpt-5.4 | gpt-5.4-nano |
+| Kimi | kimi-code/k3 | kimi-code/k3 | kimi-code/k3 |
 | MiniMax | MiniMax-M2.7 | MiniMax-M2.7 | MiniMax-M2.5 |
-| Ollama | hf.co/prithivMLmods/VibeThinker-3B-GGUF | llama3.3 | llama3.2 |
 
 ### Usage
 
@@ -515,14 +479,13 @@ Choose how many consultants to use:
 
 | Preset | Consultants | Tier | Use Case |
 |--------|-------------|------|----------|
-| `max_quality` | 7 (all) + debate + reflection | Premium | Critical decisions |
+| `max_quality` | 8 + debate + reflection | Premium | Critical decisions |
 | `medium` | 4 + light debate | Standard | General questions |
 | `fast` | 2 | Economy | Quick checks |
 | `minimal` | 2 (Gemini + Codex) | Default | Quick questions, low cost |
-| `balanced` | 4 (+ Mistral + Kilo) | Default | Standard consultations |
-| `thorough` | 5 (+ Cursor) | Default | Comprehensive analysis |
-| `high-stakes` | All + debate | Default | Critical decisions |
-| `local` | Ollama only | Economy | Full privacy |
+| `balanced` | 4 (+ Mistral + Cursor) | Default | Standard consultations |
+| `thorough` | 4 | Default | Comprehensive analysis |
+| `high-stakes` | Expanded panel + debate | Default | Critical decisions |
 | `security` | Security-focused + debate | Default | Security reviews |
 | `cost-capped` | Budget-conscious | Default | Minimal API costs |
 
@@ -560,26 +523,74 @@ $EDITOR ~/.config/ai-consultants/.env
 For ad-hoc overrides without persisting, the most common knobs:
 
 ```bash
-DEFAULT_PRESET=balanced      # minimal | balanced | thorough | high-stakes | fast | local | security
+DEFAULT_PRESET=balanced      # minimal | balanced | thorough | high-stakes | fast | security
 DEFAULT_STRATEGY=majority    # majority | risk_averse | security_first | cost_capped | compare_only
 ENABLE_DEBATE=true           # Multi-agent debate (auto-skipped when consensus is high since v2.13)
-ENABLE_OLLAMA=true           # Enable local Ollama consultant
 MAX_SESSION_COST=1.00        # USD budget cap (paired with ENABLE_BUDGET_LIMIT=true to enforce)
+KIMI_MODEL=kimi-code/k3      # Pin the Kimi consultant to K3
+```
+
+Full reference: [`references/configuration.md`](references/configuration.md). Copy-paste workflows: [`docs/RECIPES.md`](docs/RECIPES.md). For category-aware preset suggestions: `ai-consultants doctor --suggest-preset --question "..."`.
+
+### Configuration Recipes
+
+**Dynamic debate until convergence:**
+
+```bash
+ENABLE_DEBATE=true \
+ORCHESTRATION_MODE=converge \
+CONVERGENCE_MAX_ROUNDS=4 \
+CONVERGENCE_TARGET_CONSENSUS=75 \
+ai-consultants --strategy risk_averse \
+  "Event log or mutable relational state for this service?"
+```
+
+**Repeatable two-round review:**
+
+```bash
+ENABLE_DEBATE=true \
+ORCHESTRATION_MODE=fixed \
+DEBATE_ROUNDS=2 \
+ENABLE_DEBATE_OPTIMIZATION=false \
+ai-consultants "Review this migration plan" docs/migration.md@PRIMARY
 ```
 
-Full reference (~150 vars): [`references/configuration.md`](references/configuration.md). For category-aware preset suggestions: `ai-consultants doctor --suggest-preset --question "..."`.
+**Security review with adversarial verification:**
+
+```bash
+ENABLE_DEBATE=true \
+ORCHESTRATION_MODE=adversarial \
+ENABLE_PEER_REVIEW=true \
+ai-consultants --preset security --strategy security_first \
+  "Find authentication bypasses" src/auth.ts@PRIMARY
+```
+
+**Live health gate plus hard quorum:**
+
+```bash
+ENABLE_HEALTH_GATE=true \
+QUORUM_MIN=3 \
+QUORUM_ACTION=stop \
+ai-consultants "Make a release recommendation"
+```
+
+See [13 complete recipes](docs/RECIPES.md) for fast, high-stakes, tournament,
+exhaustive audit, budget-capped, CLI-only, hybrid API, semantic-consensus, and
+large-context workflows.
 
 ### Doctor Command
 
 Diagnose, suggest, and fix:
 
 ```bash
-ai-consultants doctor                                          # 22 health checks (CLI installed?)
+ai-consultants doctor                                          # Installation and configuration checks
 ai-consultants doctor --fix                                    # Auto-fix common issues
 ai-consultants doctor --json                                   # JSON for automation
 ai-consultants doctor --live                                   # Real ping per consultant — catches installed-but-unauthenticated CLIs
 ai-consultants doctor --suggest-config                         # Print recommended ENABLE_* based on detected CLIs
 ai-consultants doctor --suggest-preset --question "..."        # Recommend preset + strategy for a question
+ai-consultants update-clis                                     # Check & update every installed consultant CLI
+ai-consultants update-clis --dry-run                           # Preview: each CLI's install method + update command
 ```
 
 > When a consultant fails mid-consultation, the run surfaces the captured reason (e.g. `CLI not found`, `401 Unauthorized`) instead of a bare "Failed", so you can tell *not installed* from *not authenticated* from *transient*.
@@ -594,7 +605,7 @@ Classify -> Plan shape -> Fan out -> Deliberate & converge -> Synthesize
  category   orchestration  Gemini (8)    convergence loop /
  complexity    shape       Codex (7)     adversarial gate /
  intent                    Mistral (6)   tournament / exhaustive
-                           Kilo (9)
+                           Cursor (9)
 ```
 
 The **shape** is chosen per question (or pinned via `ORCHESTRATION_MODE`):
@@ -609,6 +620,11 @@ The **shape** is chosen per question (or pinned via `ORCHESTRATION_MODE`):
 
 Set `ORCHESTRATION_MODE=fixed` for the classic fixed-round pipeline.
 
+Consensus is measured lexically by default; set `ENABLE_STANCE_CONSENSUS=true`
+(opt-in, v2.21) to have the panel pick from a shared set of enumerated stance
+options and score agreement by exact match instead — see
+[references/configuration.md](references/configuration.md#semantic-consensus-v221-opt-in).
+
 With peer review:
 ```
 Responses -> Anonymize -> Peer Ranking -> De-anonymize -> Peer Scores
@@ -623,7 +639,7 @@ Each consultation generates:
 ├── gemini.json          # Individual responses
 ├── codex.json           #   with confidence scores
 ├── mistral.json
-├── kilo.json
+├── cursor.json
 ├── voting.json          # Consensus calculation
 ├── synthesis.json       # Weighted recommendation
 ├── report.md            # Human-readable report
@@ -653,7 +669,7 @@ Each consultation generates:
 ### Security
 
 - **Never** include credentials or API keys in queries
-- Use `--preset local` for sensitive code
+- Review and redact sensitive code before sending it to any external consultant
 - Files in `/tmp` are automatically cleaned up
 
 ---
@@ -661,6 +677,7 @@ Each consultation generates:
 ## Documentation
 
 - [Setup Guide](docs/SETUP.md) - Installation, authentication, Claude Code setup
+- [Configuration Recipes](docs/RECIPES.md) - Copy-paste workflows for debate, routing, budgets, and transport
 - [Cost Rates](docs/COST_RATES.md) - Model pricing and budgets
 - [Smart Routing](docs/SMART_ROUTING.md) - Category-based routing
 - [JSON Schema](docs/JSON_SCHEMA.md) - Output format specification
@@ -671,6 +688,11 @@ Each consultation generates:
 
 ## Changelog
 
+### v2.21.1
+
+- **Kimi K3**: Kimi now defaults to `kimi-code/k3`, and the adapter passes the model explicitly with `--model`.
+- **Focused 11-consultant roster**: Kilo, Aider, Amp, and Ollama were removed end-to-end, including their adapters and configuration variables. See the [v2.21.1 release note](docs/releases/v2.21.1.md) for migration guidance.
+
 ### v2.15.1
 
 - **Gemini fixes (Antigravity CLI)**: the default model (`Gemini 3.1 Pro (High)`) wraps its JSON in a ```` ```json ```` fence; v2.15.0 didn't strip it, so every Gemini reply degraded to a generic fallback. Now de-fenced on all paths (response processing, self-reflection, synthesis).