chati-dev 2.1.2 → 3.0.1

package/framework/domains/constitution.yaml

@@ -1,5 +1,5 @@
 # Constitution Domain — Extracted governance rules for PRISM L0
-# Source: chati.dev/constitution.md (17 Articles + Preamble)
+# Source: chati.dev/constitution.md (19 Articles + Preamble)
 
 summary: >
   Constitution governance: self-validation required (loop until quality >= 95%),
@@ -9,7 +9,7 @@ summary: >
   context brackets, memory governance, registry governance,
   session lock, model governance.
 
-articleCount: 17
+articleCount: 19
 
 rules:
   - id: art-i
@@ -79,3 +79,31 @@ rules:
   - id: art-xvii
     text: "Execution mode governance: autonomous requires gate >= 90%. Safety net with circuit breaker (3 failures)."
     priority: critical
+
+articles:
+  article-xviii:
+    name: "Execution Profile Governance"
+    enforcement: block
+    rules:
+      - profile-explore: "In explore profile, agents read and analyze only. No write operations permitted."
+        priority: critical
+      - profile-guided: "In guided profile, agents propose actions and wait for user confirmation before writes."
+        priority: high
+      - profile-autonomous: "In autonomous profile, agents execute without confirmation when gate scores >= 90%."
+        priority: critical
+      - profile-always-confirm: "Destructive operations, deployments, deviations, and backward transitions always require confirmation regardless of profile."
+        priority: critical
+  article-xix:
+    name: "Multi-CLI Governance"
+    enforcement: guide
+    rules:
+      - provider-registry: "CLI Provider Registry is source of truth for provider capabilities."
+        priority: high
+      - provider-agnostic-handoff: "Handoff format is provider-agnostic. All agents produce handoffs in the same two-layer format."
+        priority: critical
+      - provider-fallback: "If a configured provider is unavailable, fall back to primary provider (claude) with warning."
+        priority: high
+      - provider-hooks: "Hook-based governance applies only to providers with hook support. Others use prompt injection."
+        priority: high
+      - provider-context-files: "Context file generation is automatic when a provider is enabled."
+        priority: normal

package/framework/domains/global.yaml

@@ -18,6 +18,26 @@ rules:
     text: "Interact with user in their preferred language. Artifacts stay in English."
     priority: normal
 
+  # Execution Profile Rules (v3.0.0)
+  execution-profiles:
+    - explore-readonly: "In explore profile, all write/edit tool calls are blocked."
+      priority: critical
+    - guided-confirmation: "In guided profile, significant writes require user confirmation."
+      priority: high
+    - autonomous-gate-check: "Autonomous profile requires cumulative gate scores >= 90%."
+      priority: critical
+    - profile-downgrade: "If quality drops below threshold during autonomous execution, auto-downgrade to guided."
+      priority: critical
+
+  # Multi-CLI Rules (v3.0.0)
+  multi-cli:
+    - primary-provider: "Claude is the default and primary provider. Multi-CLI is opt-in."
+      priority: high
+    - provider-validation: "Health check validates provider availability before spawning."
+      priority: high
+    - provider-model-map: "Each provider has its own model map. Agent assignments reference tier (opus/sonnet/haiku) which maps to provider-specific models."
+      priority: normal
+
 modes:
   planning:
     writeScope: "chati.dev/"

package/framework/hooks/model-governance.js

@@ -27,19 +27,19 @@ import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';
 
 const AGENT_MODELS = {
-  orchestrator: 'sonnet',
-  'greenfield-wu': 'haiku',
-  'brownfield-wu': 'opus',
-  brief: 'sonnet',
-  detail: 'opus',
-  architect: 'opus',
-  ux: 'sonnet',
-  phases: 'sonnet',
-  tasks: 'sonnet',
-  'qa-planning': 'opus',
-  'qa-implementation': 'opus',
-  dev: 'opus',
-  devops: 'sonnet',
+  orchestrator: { provider: 'claude', model: 'sonnet', tier: 'sonnet' },
+  'greenfield-wu': { provider: 'claude', model: 'haiku', tier: 'haiku' },
+  'brownfield-wu': { provider: 'claude', model: 'opus', tier: 'opus' },
+  brief: { provider: 'claude', model: 'sonnet', tier: 'sonnet' },
+  detail: { provider: 'claude', model: 'opus', tier: 'opus' },
+  architect: { provider: 'claude', model: 'opus', tier: 'opus' },
+  ux: { provider: 'claude', model: 'sonnet', tier: 'sonnet' },
+  phases: { provider: 'claude', model: 'sonnet', tier: 'sonnet' },
+  tasks: { provider: 'claude', model: 'sonnet', tier: 'sonnet' },
+  'qa-planning': { provider: 'claude', model: 'opus', tier: 'opus' },
+  'qa-implementation': { provider: 'claude', model: 'opus', tier: 'opus' },
+  dev: { provider: 'claude', model: 'opus', tier: 'opus' },
+  devops: { provider: 'claude', model: 'sonnet', tier: 'sonnet' },
 };
 
 /**
@@ -77,11 +77,13 @@ async function main() {
     const agent = getCurrentAgent(projectDir);
 
     if (agent && AGENT_MODELS[agent]) {
-      const expected = AGENT_MODELS[agent];
+      const assignment = AGENT_MODELS[agent];
+      const expected = assignment.model || assignment;
+      const provider = assignment.provider || 'claude';
       // Advisory note — appended to context
       process.stdout.write(JSON.stringify({
         result: 'allow',
-        prefix: `<!-- [Article XVI] Agent "${agent}" assigned model: ${expected} -->`,
+        prefix: `<!-- [Article XVI] Agent "${agent}" assigned model: ${expected} (provider: ${provider}) -->`,
       }));
     } else {
       process.stdout.write(JSON.stringify({ result: 'allow' }));

package/framework/hooks/read-protection.js

@@ -18,6 +18,7 @@ const SENSITIVE_PATTERNS = [
   /^\.env\.[^.]+$/,
   /\.pem$/,
   /^credentials\./,
+  /^credentials$/,
   /^secrets\./,
   /\.key$/,
   /^\.git\/config$/,

package/framework/i18n/en.yaml

@@ -15,19 +15,26 @@ installer:
   language_label: "Language"
   ides_label: "IDEs"
   mcps_label: "MCPs"
+  llm_provider_title: "Select your default AI provider:"
+  llm_provider_claude: "Claude (Anthropic) — Best for structured reasoning"
+  llm_provider_gemini: "Gemini (Google) — 1M token context window"
+  llm_provider_codex: "Codex (OpenAI) — Optimized for code generation"
+  llm_provider_copilot: "Copilot (GitHub) — Multi-model, GitHub integrated"
+  llm_provider_not_installed: "(CLI not detected)"
+  llm_provider_label: "AI Provider"
   will_install: "Will install:"
   agents_count: "13 agent definitions (DISCOVER, PLAN, BUILD, DEPLOY phases)"
   workflows_count: "6 workflow blueprints"
   templates_count: "6 templates (PRD, Brownfield PRD, Architecture, Task, QA Gate, Quick Brief)"
-  constitution: "Constitution (17 Articles + Preamble)"
+  constitution: "Constitution (19 Articles + Preamble)"
   session_mgmt: "Session management system"
-  quality_gates: "Quality gates (4-tier validation)"
+  quality_gates: "Quality gates (3-tier verdicts)"
   proceed: "Proceed with installation?"
   installing: "Installing Chati.dev..."
   created_chati: "Created .chati/ session directory"
   created_framework: "Created chati.dev/ system directory (agents, templates, workflows)"
   created_commands: "Created .claude/commands/ (thin router)"
-  installed_constitution: "Installed Constitution (Articles I-XVII)"
+  installed_constitution: "Installed Constitution (Articles I-XIX)"
   created_session: "Created session.yaml schema"
   created_claude_md: "Created CLAUDE.md"
   configured_mcps: "Configured MCPs:"
@@ -35,7 +42,7 @@ installer:
   agents_valid: "All 13 agents implement 8 protocols"
   handoff_ok: "Handoff protocol: OK"
   validation_ok: "Self-validation criteria: OK"
-  constitution_ok: "Constitution: 17 articles verified"
+  constitution_ok: "Constitution: 19 articles verified"
   created_memories: "Created .chati/memories/ (Memory Layer)"
   installed_intelligence: "Installed Intelligence Layer (Context Engine, Memory, Registry)"
   intelligence_valid: "Intelligence: 6 spec files verified"

package/framework/i18n/es.yaml

@@ -15,19 +15,26 @@ installer:
   language_label: "Idioma"
   ides_label: "IDEs"
   mcps_label: "MCPs"
+  llm_provider_title: "Seleccione su proveedor de IA predeterminado:"
+  llm_provider_claude: "Claude (Anthropic) — Mejor para razonamiento estructurado"
+  llm_provider_gemini: "Gemini (Google) — Ventana de contexto de 1M tokens"
+  llm_provider_codex: "Codex (OpenAI) — Optimizado para generacion de codigo"
+  llm_provider_copilot: "Copilot (GitHub) — Multi-modelo, integrado con GitHub"
+  llm_provider_not_installed: "(CLI no detectada)"
+  llm_provider_label: "Proveedor de IA"
   will_install: "Se instalara:"
   agents_count: "13 definiciones de agentes (fases DISCOVER, PLAN, BUILD, DEPLOY)"
   workflows_count: "6 blueprints de workflow"
   templates_count: "6 templates (PRD, PRD Brownfield, Arquitectura, Task, QA Gate, Quick Brief)"
-  constitution: "Constitucion (17 Articulos + Preambulo)"
+  constitution: "Constitucion (19 Articulos + Preambulo)"
   session_mgmt: "Sistema de gestion de sesion"
-  quality_gates: "Quality gates (validacion en 4 capas)"
+  quality_gates: "Quality gates (veredictos en 3 niveles)"
   proceed: "Proceder con la instalacion?"
   installing: "Instalando Chati.dev..."
   created_chati: "Creado directorio de sesion .chati/"
   created_framework: "Creado directorio del sistema chati.dev/ (agentes, templates, workflows)"
   created_commands: "Creado .claude/commands/ (enrutador)"
-  installed_constitution: "Instalada Constitucion (Articulos I-XVII)"
+  installed_constitution: "Instalada Constitucion (Articulos I-XIX)"
   created_session: "Creado schema session.yaml"
   created_claude_md: "Creado CLAUDE.md"
   configured_mcps: "MCPs configurados:"
@@ -35,7 +42,7 @@ installer:
   agents_valid: "Los 13 agentes implementan 8 protocolos"
   handoff_ok: "Protocolo de handoff: OK"
   validation_ok: "Criterios de auto-validacion: OK"
-  constitution_ok: "Constitucion: 17 articulos verificados"
+  constitution_ok: "Constitucion: 19 articulos verificados"
   created_memories: "Creado .chati/memories/ (Memory Layer)"
   installed_intelligence: "Instalada Intelligence Layer (Context Engine, Memory, Registry)"
   intelligence_valid: "Intelligence: 6 archivos de spec verificados"

package/framework/i18n/fr.yaml

@@ -15,19 +15,26 @@ installer:
   language_label: "Langue"
   ides_label: "IDEs"
   mcps_label: "MCPs"
+  llm_provider_title: "Selectionnez votre fournisseur IA par defaut:"
+  llm_provider_claude: "Claude (Anthropic) — Ideal pour le raisonnement structure"
+  llm_provider_gemini: "Gemini (Google) — Fenetre de contexte de 1M tokens"
+  llm_provider_codex: "Codex (OpenAI) — Optimise pour la generation de code"
+  llm_provider_copilot: "Copilot (GitHub) — Multi-modele, integre a GitHub"
+  llm_provider_not_installed: "(CLI non detecte)"
+  llm_provider_label: "Fournisseur IA"
   will_install: "Sera installe:"
   agents_count: "13 definitions d'agents (phases DISCOVER, PLAN, BUILD, DEPLOY)"
   workflows_count: "6 blueprints de workflow"
   templates_count: "6 templates (PRD, PRD Brownfield, Architecture, Task, QA Gate, Quick Brief)"
-  constitution: "Constitution (17 Articles + Preambule)"
+  constitution: "Constitution (19 Articles + Preambule)"
   session_mgmt: "Systeme de gestion de session"
-  quality_gates: "Quality gates (validation en 4 couches)"
+  quality_gates: "Quality gates (verdicts en 3 niveaux)"
   proceed: "Proceder a l'installation?"
   installing: "Installation de Chati.dev..."
   created_chati: "Cree le repertoire de session .chati/"
   created_framework: "Cree le repertoire du systeme chati.dev/ (agents, templates, workflows)"
   created_commands: "Cree .claude/commands/ (routeur)"
-  installed_constitution: "Installee la Constitution (Articles I-XVII)"
+  installed_constitution: "Installee la Constitution (Articles I-XIX)"
   created_session: "Cree le schema session.yaml"
   created_claude_md: "Cree CLAUDE.md"
   configured_mcps: "MCPs configures:"
@@ -35,7 +42,7 @@ installer:
   agents_valid: "Les 13 agents implementent 8 protocoles"
   handoff_ok: "Protocole de passation: OK"
   validation_ok: "Criteres d'auto-validation: OK"
-  constitution_ok: "Constitution: 17 articles verifies"
+  constitution_ok: "Constitution: 19 articles verifies"
   created_memories: "Cree .chati/memories/ (Memory Layer)"
   installed_intelligence: "Installee Intelligence Layer (Context Engine, Memory, Registry)"
   intelligence_valid: "Intelligence: 6 fichiers de spec verifies"

package/framework/i18n/pt.yaml

@@ -15,19 +15,26 @@ installer:
   language_label: "Idioma"
   ides_label: "IDEs"
   mcps_label: "MCPs"
+  llm_provider_title: "Selecione seu provedor de IA padrao:"
+  llm_provider_claude: "Claude (Anthropic) — Melhor para raciocinio estruturado"
+  llm_provider_gemini: "Gemini (Google) — Janela de contexto de 1M tokens"
+  llm_provider_codex: "Codex (OpenAI) — Otimizado para geracao de codigo"
+  llm_provider_copilot: "Copilot (GitHub) — Multi-modelo, integrado ao GitHub"
+  llm_provider_not_installed: "(CLI nao detectada)"
+  llm_provider_label: "Provedor de IA"
   will_install: "Sera instalado:"
   agents_count: "13 definicoes de agentes (fases DISCOVER, PLAN, BUILD, DEPLOY)"
   workflows_count: "6 blueprints de workflow"
   templates_count: "6 templates (PRD, PRD Brownfield, Arquitetura, Task, QA Gate, Quick Brief)"
-  constitution: "Constituicao (17 Artigos + Preambulo)"
+  constitution: "Constituicao (19 Artigos + Preambulo)"
   session_mgmt: "Sistema de gerenciamento de sessao"
-  quality_gates: "Quality gates (validacao em 4 camadas)"
+  quality_gates: "Quality gates (veredictos em 3 niveis)"
   proceed: "Prosseguir com a instalacao?"
   installing: "Instalando Chati.dev..."
   created_chati: "Criado diretorio de sessao .chati/"
   created_framework: "Criado diretorio do sistema chati.dev/ (agentes, templates, workflows)"
   created_commands: "Criado .claude/commands/ (roteador)"
-  installed_constitution: "Instalada Constituicao (Artigos I-XVII)"
+  installed_constitution: "Instalada Constituicao (Artigos I-XIX)"
   created_session: "Criado schema session.yaml"
   created_claude_md: "Criado CLAUDE.md"
   configured_mcps: "MCPs configurados:"
@@ -35,7 +42,7 @@ installer:
   agents_valid: "Todos os 13 agentes implementam 8 protocolos"
   handoff_ok: "Protocolo de handoff: OK"
   validation_ok: "Criterios de auto-validacao: OK"
-  constitution_ok: "Constituicao: 17 artigos verificados"
+  constitution_ok: "Constituicao: 19 artigos verificados"
   created_memories: "Criado .chati/memories/ (Memory Layer)"
   installed_intelligence: "Instalada Intelligence Layer (Context Engine, Memory, Registry)"
   intelligence_valid: "Intelligence: 6 arquivos de spec verificados"

package/framework/intelligence/context-engine.md

@@ -25,7 +25,7 @@ The orchestrator injects context through 5 hierarchical layers:
 
 | Layer | Name | Source | When Active |
 |-------|------|--------|-------------|
-| **L0** | Constitution | `chati.dev/constitution.md` (Articles I-XVII) | ALWAYS (non-negotiable) |
+| **L0** | Constitution | `chati.dev/constitution.md` (Articles I-XIX) | ALWAYS (non-negotiable) |
 | **L1** | Mode + Global | `config.yaml` + mode governance (planning/build/deploy) | ALWAYS |
 | **L2** | Agent Scope | `chati.dev/agents/{agent}/` — mission, inputs, outputs, criteria | When agent is active |
 | **L3** | Pipeline State | `.chati/session.yaml` — pipeline position, scores, backlog | When session is active |
@@ -49,7 +49,7 @@ The orchestrator produces a structured XML block injected into agent prompts:
 ```xml
 <chati-context bracket="MODERATE">
   <constitution>
-    Articles I-XVII governing agent behavior.
+    Articles I-XIX governing agent behavior.
     Key: Self-validation required. Loop until quality threshold.
     Guided options (1,2,3). Persistent session state.
     Two-layer handoff. Language protocol. Deviation protocol.
@@ -161,3 +161,32 @@ If Smart Continuation is insufficient, the orchestrator spawns a new session:
 ---
 
 *Context Engine v1.0 — Chati.dev Intelligence Layer*
+
+---
+
+## Multi-CLI Context Strategy (v3.0.0)
+
+When agents execute on different CLI providers, context injection adapts to the provider's capabilities:
+
+### Hook-Based Providers (Claude Code, Gemini CLI, Copilot CLI)
+- PRISM context injected via `UserPromptSubmit` hook
+- Mode governance enforced via `PreToolUse` hook
+- Constitution guard enforced via `PreToolUse` hook
+- Full governance parity with Claude Code
+
+### Prompt-Based Providers (Codex CLI)
+- PRISM context embedded directly in the spawned prompt (via prompt-builder)
+- Governance directives included as system instructions in the prompt
+- Softer enforcement — relies on model compliance rather than hook interception
+- Write scope restrictions communicated via prompt, not blocked at tool level
+
+### Context File Mapping
+| Provider | Context File | Generation |
+|----------|-------------|------------|
+| Claude Code | CLAUDE.md | Native (already exists) |
+| Gemini CLI | GEMINI.md | Auto-generated from CLAUDE.md |
+| Codex CLI | AGENTS.md | Auto-generated from CLAUDE.md |
+| Copilot CLI | All three | Reads CLAUDE.md, GEMINI.md, AGENTS.md natively |
+
+### Cross-Provider Handoff
+Handoff format is identical regardless of which provider executed the agent. The two-layer structure (Article VIII) ensures any provider can read any handoff. Session state in `.chati/session.yaml` is the single source of truth — all providers read from and write to the same session file.

package/framework/intelligence/decision-engine.md

@@ -96,7 +96,7 @@ npx chati-dev health
 Checks:
 1. All registered entities exist on disk
 2. Schema files are valid JSON
-3. Constitution has >= 17 articles
+3. Constitution has >= 19 articles
 4. Agents contain required protocol references
 5. Entity count matches actual file count
 6. Checksums match (if calculated)

package/framework/intelligence/memory-layer.md

@@ -185,3 +185,20 @@ This prevents cross-contamination while enabling knowledge sharing.
 ---
 
 *Memory Layer v1.0 — Chati.dev Intelligence Layer*
+
+---
+
+## Cross-CLI Memory Persistence (v3.0.0)
+
+Memory is provider-agnostic. All providers read from and write to the same memory store (`.chati/memories/`).
+
+### Memory Capture Across Providers
+- **Hook-based providers**: Capture via `PreCompact` hook (session-digest.js)
+- **Prompt-based providers**: Capture via explicit instructions in the spawned prompt — the agent is instructed to output a `<chati-memory>` block that the orchestrator parses from stdout
+
+### Memory Injection Across Providers
+- **Hook-based providers**: Injected via PRISM engine hook (prism-engine.js)
+- **Prompt-based providers**: Relevant memories are included in the spawned prompt by the prompt-builder
+
+### Gotchas Auto-Capture
+Gotchas are captured regardless of provider. The auto-capture engine monitors agent stdout for error patterns and tracks frequency. When an error pattern appears 3+ times across any provider combination, a gotcha is auto-created.

package/framework/orchestrator/chati.md

@@ -45,10 +45,15 @@ Before determining state, check if the user passed a subcommand:
   -> Resume session with full context recovery
   -> Re-activate session lock
 
+/chati providers:
+  -> Display enabled providers and per-agent overrides (see Provider Routing section)
+  -> Stay locked
+
 /chati help:
   -> Display available commands:
      /chati              Start or resume session
      /chati status       Show project dashboard
+     /chati providers    List enabled providers and overrides
      /chati resume       Resume from continuation file
      /chati exit         Save and exit session
      /chati help         Show this help
@@ -338,20 +343,20 @@ Model selection is **enforced by construction**: the orchestrator passes `--mode
 
 ### Model Map (Quick Reference)
 
-| Agent | Default | Upgrade Condition |
-|-------|---------|-------------------|
-| greenfield-wu | haiku | sonnet if multi-stack or enterprise |
-| brownfield-wu | opus | no downgrade |
-| brief | sonnet | opus if enterprise or 10+ integrations |
-| detail | opus | no downgrade |
-| architect | opus | no downgrade |
-| ux | sonnet | opus if design system from scratch |
-| phases | sonnet | opus if 20+ requirements |
-| tasks | sonnet | opus if 50+ tasks |
-| qa-planning | opus | no downgrade |
-| dev | opus | no downgrade |
-| qa-implementation | opus | no downgrade |
-| devops | sonnet | opus if multi-environment or IaC |
+| Agent | Default | Upgrade Condition | Provider |
+|-------|---------|-------------------|----------|
+| greenfield-wu | haiku | sonnet if multi-stack or enterprise | claude (default) |
+| brownfield-wu | opus | no downgrade | claude (default) | gemini (when codebase > 100K LOC) |
+| brief | sonnet | opus if enterprise or 10+ integrations | claude (default) |
+| detail | opus | no downgrade | claude (default) |
+| architect | opus | no downgrade | claude (default) |
+| ux | sonnet | opus if design system from scratch | claude (default) |
+| phases | sonnet | opus if 20+ requirements | claude (default) |
+| tasks | sonnet | opus if 50+ tasks | claude (default) |
+| qa-planning | opus | no downgrade | claude (default) |
+| dev | opus | no downgrade | claude (default) | gemini (when large codebase tasks) |
+| qa-implementation | opus | no downgrade | claude (default) |
+| devops | sonnet | opus if multi-environment or IaC | claude (default) |
 
 ### Enforcement
 
@@ -383,6 +388,81 @@ model_selections:
 
 ---
 
+## Provider Routing
+
+The orchestrator selects the optimal provider for each agent based on the task context, codebase characteristics, and configuration. Provider routing determines WHICH CLI or API backend executes the agent, while model selection determines WHICH model runs within that provider.
+
+### Provider Selection Priority
+
+```
+Resolution order (highest to lowest priority):
+  1. agent_overrides (config.yaml) — explicit per-agent provider override
+  2. Agent default (AGENT_MODELS map) — provider defined in agent Identity section
+  3. Primary provider — the project-level default provider (claude)
+
+Example resolution:
+  config.yaml has: agent_overrides.brownfield-wu.provider = gemini
+  Agent default has: Provider: claude (default) | gemini (when codebase > 100K LOC)
+  Primary provider: claude
+
+  -> Result: gemini (config.yaml override wins)
+
+If no override exists and no agent default specifies a condition match:
+  -> Result: claude (primary provider fallback)
+```
+
+### Provider Fallback
+
+```
+If the selected provider is unavailable (CLI not installed, API unreachable, auth failure):
+  1. Log the failure:
+     provider_fallback:
+       agent: {name}
+       intended_provider: {selected}
+       fallback_provider: claude
+       reason: "{error_message}"
+       timestamp: "{now}"
+  2. Fall back to the primary provider (claude)
+  3. Continue agent execution with fallback provider
+  4. Record the fallback in session.yaml for audit
+
+The primary provider (claude) is always the last-resort fallback.
+Provider fallback NEVER blocks the pipeline — it degrades gracefully.
+```
+
+### Subcommand: /chati providers
+
+```
+When the user types `/chati providers`:
+  Display enabled providers and their status:
+
+  Providers:
+    claude    PRIMARY   Enabled   Claude Code CLI
+    gemini    -         Enabled   Gemini CLI
+    codex     -         Disabled  OpenAI Codex CLI
+
+  Agent Overrides (from config.yaml):
+    brownfield-wu -> gemini (when codebase > 100K LOC)
+    dev           -> gemini (when large codebase tasks)
+
+  To configure: edit chati.dev/config.yaml -> providers section
+```
+
+### Provider Logging
+
+```yaml
+# Appended to session.yaml on each agent activation
+provider_selections:
+  - agent: brownfield-wu
+    resolved_provider: gemini
+    resolution_source: agent_default   # config_override | agent_default | primary
+    reason: "codebase > 100K LOC"
+    model: opus
+    timestamp: "2026-..."
+```
+
+---
+
 ## Mode Enforcement Protocol
 
 ### Scope Validation

package/framework/patterns/elicitation-library.yaml

@@ -307,7 +307,7 @@ categories:
           - "Goals: What do they want to achieve?"
           - "Frustrations: What annoys them about current solutions?"
           - "Typical day: When/where/how do they use the product?"
-          - "Key scenario: Write one user story for this persona"
+          - "Key scenario: Define one key scenario for this persona"
           - "Prioritize personas by frequency of use"
         anti_patterns:
           - "Creating too many personas (3-5 is ideal)"
@@ -500,7 +500,7 @@ categories:
         steps:
           - "Top row: user activities (high-level goals)"
           - "Second row: user tasks (steps within each activity)"
-          - "Below each task: user stories (specific features)"
+          - "Below each task: specific features and requirements"
           - "Draw horizontal lines for release boundaries"
           - "Everything above first line = MVP"
           - "Validate: Does MVP deliver end-to-end value?"

package/framework/schemas/config.schema.json

@@ -37,6 +37,50 @@
       "type": "array",
       "items": { "type": "string" },
       "description": "IDEs configured during installation"
+    },
+    "providers": {
+      "type": "object",
+      "description": "CLI provider configuration",
+      "properties": {
+        "claude": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean", "default": true },
+            "primary": { "type": "boolean", "default": true }
+          }
+        },
+        "gemini": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean", "default": false },
+            "model_default": { "type": "string", "default": "pro" }
+          }
+        },
+        "codex": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean", "default": false },
+            "model_default": { "type": "string", "default": "codex" }
+          }
+        },
+        "copilot": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean", "default": false }
+          }
+        }
+      }
+    },
+    "agent_overrides": {
+      "type": "object",
+      "description": "Per-agent provider/model overrides",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "provider": { "type": "string" },
+          "model": { "type": "string" }
+        }
+      }
     }
   }
 }

package/framework/schemas/session.schema.json

@@ -19,6 +19,32 @@
       "default": "interactive",
       "description": "interactive = agent-driven guided mode; autonomous = Ralph Wiggum mode (Dev agent)"
     },
+    "execution_profile": {
+      "type": "string",
+      "enum": ["explore", "guided", "autonomous"],
+      "default": "guided",
+      "description": "Current execution profile governing confirmation requirements"
+    },
+    "providers_enabled": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": ["claude"],
+      "description": "List of enabled CLI providers"
+    },
+    "profile_transitions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "from": { "type": "string" },
+          "to": { "type": "string" },
+          "reason": { "type": "string" },
+          "timestamp": { "type": "string", "format": "date-time" }
+        }
+      },
+      "default": [],
+      "description": "History of execution profile changes"
+    },
     "current_agent": {
       "type": "string",
       "description": "Currently active agent name"
@@ -143,6 +169,7 @@
           "recommended": { "enum": ["opus", "sonnet", "haiku"], "description": "Recommended model" },
           "actual": { "enum": ["opus", "sonnet", "haiku"], "description": "Model actually used" },
           "reason": { "type": "string", "description": "Why this model was selected (default, upgrade condition, no downgrade)" },
+          "provider": { "type": "string", "description": "CLI provider used (claude, gemini, codex, copilot)" },
           "timestamp": { "type": "string", "format": "date-time" }
         }
       }

package/framework/tasks/brownfield-wu-dependency-scan.md

@@ -351,7 +351,7 @@ estimated_total_update_effort:
 
 recommendations:
   - Fix critical lodash vulnerability immediately
-  - Plan React 17→18 migration as dedicated sprint (16 hours)
+  - Plan React 17→18 migration as dedicated phase (16 hours)
   - Remove unused packages (uuid, color) to reduce bloat
   - Replace moment with date-fns for bundle size reduction (523 KB savings)
   - Standardize on single HTTP client (axios)