ai-consultants 2.21.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.21.0
+**Version**: 2.21.1
 
 ## Distribution
 
@@ -47,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
@@ -73,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
@@ -200,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.
@@ -225,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)
@@ -270,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: true)
-- `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
@@ -314,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.
 
@@ -468,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.
 
@@ -628,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
 
@@ -661,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) |
@@ -673,7 +638,7 @@ 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) |
@@ -687,7 +652,7 @@ for f in scripts/*.sh scripts/lib/*.sh; do bash -n "$f" && echo "OK: $f"; done
 | `QWEN3_CMD` | qwen | Qwen CLI command (v2.7) |
 | `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) |
+| `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) |
@@ -699,15 +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)
 - `mmx` CLI - MiniMax via mmx-cli (v2.21, optional; `npm i -g mmx-cli`, auth `mmx auth login`)
-- `ollama` CLI - Local models (v2.2)
 - `jq` - JSON parsing
 
 ## Error Handling and Retry
@@ -727,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
@@ -741,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
@@ -842,6 +802,12 @@ 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.

package/README.md

@@ -1,8 +1,8 @@
-# AI Consultants v2.21.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.21.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 |
 
-### API-Based Consultants
+Qwen3 and MiniMax can switch from their CLI to API transport. Gemini, Codex,
+Claude, and Mistral are also CLI/API switchable.
+
+### 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,21 +523,67 @@ $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
+```
+
+**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
 ```
 
-Full reference (~150 vars): [`references/configuration.md`](references/configuration.md). For category-aware preset suggestions: `ai-consultants doctor --suggest-preset --question "..."`.
+**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
@@ -596,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`):
@@ -630,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
@@ -660,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
 
 ---
@@ -668,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
@@ -678,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).

package/SKILL.md

@@ -1,14 +1,14 @@
 ---
 name: ai-consultants
-description: Consult Gemini CLI, Codex CLI, Mistral Vibe, Kilo CLI, Cursor, Claude, Amp, Kimi, Qwen, MiniMax, and Ollama as external experts for coding questions. Automatically excludes the invoking agent from the panel to avoid self-consultation. Use when you have doubts about implementations, want a second opinion, need to choose between different approaches, or when explicitly requested with phrases like "ask the consultants", "what do the other models think", "compare solutions", "get expert opinions", "I'm not sure about this approach", "what would other models say". Make sure to consult this skill whenever the user is weighing trade-offs, comparing architectures, validating complex solutions, or wants multiple perspectives on any non-trivial coding decision. Do NOT use for simple questions that only need one model's answer or when you already have high confidence in a solution.
+description: Consult Gemini, Codex, Mistral Vibe, Cursor, Claude, Kimi, Qwen, MiniMax, GLM, Grok, and DeepSeek as external experts for coding questions. Automatically excludes the invoking agent from the panel to avoid self-consultation. Use when you have doubts about implementations, want a second opinion, need to choose between different approaches, or when explicitly requested with phrases like "ask the consultants", "what do the other models think", "compare solutions", "get expert opinions", "I'm not sure about this approach", "what would other models say". Make sure to consult this skill whenever the user is weighing trade-offs, comparing architectures, validating complex solutions, or wants multiple perspectives on any non-trivial coding decision. Do NOT use for simple questions that only need one model's answer or when you already have high confidence in a solution.
 license: MIT
 compatibility: Requires bash, jq, and at least 2 AI CLI tools (agy, codex, vibe, etc.). macOS and Linux.
 metadata:
   author: matteoscurati
-  version: 2.21.0
+  version: 2.21.1
 ---
 
-# AI Consultants v2.21.0 - AI Expert Panel
+# AI Consultants v2.21.1 - AI Expert Panel
 
 **A harness for every question.** Convene a panel of AI "consultants" for coding questions — and let the engine pick *how* they deliberate: a quick read, a convergence loop, an adversarial refutation gate, a tournament, or an exhaustive sweep. Each consultant has a **configurable persona** that shapes its analysis.
 
@@ -35,15 +35,11 @@ Configuration (presets, strategies, features, personas, API keys) can be managed
 | **Google Gemini** | `agy` | The Architect | Design patterns, scalability |
 | **OpenAI Codex** | `codex` | The Pragmatist | Simplicity, proven solutions |
 | **Mistral Vibe** | `vibe` | The Devil's Advocate | Edge cases, vulnerabilities |
-| **Kilo Code** | `kilocode` | The Innovator | Creativity, unconventional |
 | **Cursor** | `agent` | The Integrator | Full-stack perspective |
-| **Aider** | `aider` | The Pair Programmer | Collaborative coding |
-| **Amp** | `amp` | The Systems Thinker | System design, interactions |
-| **Kimi** | `kimi` | The Eastern Sage | Holistic, balanced perspectives |
+| **Kimi K3** | `kimi` | The Eastern Sage | Holistic, balanced perspectives |
 | **Claude** | `claude` | The Synthesizer | Big picture, synthesis |
 | **Qwen** | `qwen` | The Analyst | Data-driven, metrics |
 | **MiniMax** | `mmx` | The Pragmatic Optimizer | Performance, efficiency, pragmatism |
-| **Ollama** | `ollama` | The Local Expert | Privacy-first, zero cost |
 
 **API-only consultants**: GLM (The Methodologist), Grok (The Provocateur), DeepSeek (The Code Specialist)
 
@@ -110,7 +106,7 @@ ENABLE_PANIC_MODE=auto       # Auto-rigor for uncertainty
 ENABLE_BUDGET_LIMIT=false    # Budget enforcement (v2.4)
 ```
 
-Enable opt-in consultants: `ENABLE_AMP`, `ENABLE_KIMI`, `ENABLE_QWEN3`, `ENABLE_CLAUDE`, `ENABLE_OLLAMA`, `ENABLE_MINIMAX`.
+Enable opt-in consultants: `ENABLE_KIMI`, `ENABLE_QWEN3`, `ENABLE_CLAUDE`, `ENABLE_MINIMAX`.
 
 CLI/API switching: `GEMINI_USE_API`, `CODEX_USE_API`, `CLAUDE_USE_API`, `MISTRAL_USE_API`, `QWEN3_USE_API`.
 
@@ -161,6 +157,7 @@ Run `./scripts/doctor.sh` to diagnose issues, or `./scripts/doctor.sh --fix` to
 
 - [Reference Details](references/details.md) - Presets, strategies, best practices, limitations
 - [Full Configuration](references/configuration.md) - All environment variables, models, tiers, timeouts
+- [Configuration Recipes](docs/RECIPES.md) - Copy-paste workflows for debate, routing, budgets, and transport
 - [Setup Guide](docs/SETUP.md) - Installation, authentication
 - [Cost Rates](docs/COST_RATES.md) - Model pricing
 - [Smart Routing](docs/SMART_ROUTING.md) - Category routing

package/docs/COST_RATES.md

@@ -1,4 +1,4 @@
-# Cost Rates - AI Consultants v2.21.0
+# Cost Rates - AI Consultants v2.21.1
 
 This page documents the per-token rates used by the cost tracking system.
 
@@ -24,9 +24,8 @@ Since v2.5, models are organized into three tiers. Use `apply_model_tier()` or `
 | Gemini 3.5 Flash (High) | Standard | $0.0015 | Gemini (agy CLI) |
 | Gemini 3.5 Flash (Low) | Economy | $0.0015 | Gemini (agy CLI) |
 | gpt-5.5 | Premium | $0.005 | Codex |
-| gpt-5.4 | Standard | $0.0025 | Codex/Aider |
-| gpt-5.4-nano | Economy | $0.0002 | Codex/Aider |
-| qwen3-coder:free | Premium | $0.00 | Aider |
+| gpt-5.4 | Standard | $0.0025 | Codex |
+| gpt-5.4-nano | Economy | $0.0002 | Codex |
 | claude-opus-4-8 | Premium | $0.005 | Claude |
 | claude-sonnet-4-6 | Standard | $0.003 | Claude |
 | claude-haiku-4-5 | Economy | $0.001 | Claude |
@@ -40,16 +39,14 @@ Since v2.5, models are organized into three tiers. Use `apply_model_tier()` or `
 | deepseek-v4-flash | Standard/Economy | $0.00014 | DeepSeek |
 | glm-5.2 | Premium/Standard | $0.00098 | GLM |
 | glm-4-flash | Economy | $0.001 | GLM |
-| grok-4.3 | Premium | $0.00125 | Grok |
+| grok-4.5 | Premium | $0.002 | Grok |
 | grok-4.1-fast | Standard/Economy | $0.0002 | Grok |
 | qwen3.7-max | Premium | $0.0012 | Qwen3 |
 | qwen3.6-35b-a3b | Standard | $0.000163 | Qwen3 |
 | qwen3-32b | Economy | $0.0004 | Qwen3 |
 | MiniMax-M2.7 | Premium/Standard | $0.00025 | MiniMax |
 | MiniMax-M2.5 | Economy | $0.000255 | MiniMax |
-| kimi-code/kimi-for-coding | Premium/Standard | $0.0005 | Kimi |
-| hf.co/prithivMLmods/VibeThinker-3B-GGUF | All | $0.00 | Ollama (local) |
-| auto | All | $0.002 | Kilo (internal routing) |
+| kimi-code/k3 | Premium/Standard/Economy | $0.0005 | Kimi |
 | default | - | $0.005 | Fallback |
 
 ### Output Tokens
@@ -60,9 +57,8 @@ Since v2.5, models are organized into three tiers. Use `apply_model_tier()` or `
 | Gemini 3.5 Flash (High) | Standard | $0.009 | Gemini (agy CLI) |
 | Gemini 3.5 Flash (Low) | Economy | $0.009 | Gemini (agy CLI) |
 | gpt-5.5 | Premium | $0.030 | Codex |
-| gpt-5.4 | Standard | $0.015 | Codex/Aider |
-| gpt-5.4-nano | Economy | $0.00125 | Codex/Aider |
-| qwen3-coder:free | Premium | $0.00 | Aider |
+| gpt-5.4 | Standard | $0.015 | Codex |
+| gpt-5.4-nano | Economy | $0.00125 | Codex |
 | claude-opus-4-8 | Premium | $0.025 | Claude |
 | claude-sonnet-4-6 | Standard | $0.015 | Claude |
 | claude-haiku-4-5 | Economy | $0.005 | Claude |
@@ -76,16 +72,14 @@ Since v2.5, models are organized into three tiers. Use `apply_model_tier()` or `
 | deepseek-v4-flash | Standard/Economy | $0.00028 | DeepSeek |
 | glm-5.2 | Premium/Standard | $0.00308 | GLM |
 | glm-4-flash | Economy | $0.003 | GLM |
-| grok-4.3 | Premium | $0.0025 | Grok |
+| grok-4.5 | Premium | $0.006 | Grok |
 | grok-4.1-fast | Standard/Economy | $0.0005 | Grok |
 | qwen3.7-max | Premium | $0.006 | Qwen3 |
 | qwen3.6-35b-a3b | Standard | $0.0009 | Qwen3 |
 | qwen3-32b | Economy | $0.0016 | Qwen3 |
 | MiniMax-M2.7 | Premium/Standard | $0.001 | MiniMax |
 | MiniMax-M2.5 | Economy | $0.001 | MiniMax |
-| kimi-code/kimi-for-coding | Premium/Standard | $0.002 | Kimi |
-| hf.co/prithivMLmods/VibeThinker-3B-GGUF | All | $0.00 | Ollama (local) |
-| auto | All | $0.006 | Kilo |
+| kimi-code/k3 | Premium/Standard/Economy | $0.002 | Kimi |
 | default | - | $0.015 | Fallback |
 
 ## Cost Estimation per Session

package/docs/JSON_SCHEMA.md

@@ -207,7 +207,7 @@ Present only if Multi-Agent Debate is enabled (round >= 2):
 ### consultant
 
 ```
-"Gemini" | "Codex" | "Mistral" | "Kilo" | "Cursor" | "Aider" | "Amp" | "Kimi" | "Claude" | "Qwen3" | "GLM" | "Grok" | "DeepSeek" | "MiniMax" | "Ollama"
+"Gemini" | "Codex" | "Mistral" | "Cursor" | "Kimi" | "Claude" | "Qwen3" | "GLM" | "Grok" | "DeepSeek" | "MiniMax"
 ```
 
 ### persona