@geraldmaron/construct 1.0.6 → 1.0.8

package/{agents → specialists}/registry.json

@@ -2,169 +2,23 @@
   "version": 1,
   "system": "construct",
   "prefix": "cx",
-  "models": {
-    "reasoning": { "primary": null, "fallback": [] },
-    "standard": { "primary": null, "fallback": [] },
-    "fast": { "primary": null, "fallback": [] },
-    "embeddings": {
-      "local": {
-        "provider": "onnx",
-        "model": "Xenova/all-MiniLM-L6-v2",
-        "dimensions": 384,
-        "description": "Free, offline, runs locally via ONNX Runtime"
-      },
-      "openai": {
-        "provider": "openai",
-        "model": "text-embedding-3-small",
-        "dimensions": 1536,
-        "description": "Best quality, requires OPENAI_API_KEY"
-      },
-      "ollama": {
-        "provider": "ollama",
-        "model": "nomic-embed-text",
-        "dimensions": 768,
-        "description": "Local Ollama server, requires OLLAMA_BASE_URL"
-      },
-      "hashing": {
-        "provider": "local",
-        "model": "hashing-bow-v1",
-        "dimensions": 256,
-        "description": "Legacy deterministic hash — fast but no semantic understanding"
-      }
-    }
-  },
-  "providers": {
-    "openrouter": {
-      "npm": "@ai-sdk/openai-compatible",
-      "name": "OpenRouter",
-      "options": {
-        "baseURL": "https://openrouter.ai/api/v1",
-        "headers": {
-          "HTTP-Referer": "__OPENROUTER_REFERER__",
-          "X-Title": "__OPENROUTER_TITLE__"
-        }
-      },
-      "models": {
-        "google/gemma-3-27b-it:free": {
-          "name": "Google: Gemma 3 27B (free)"
-        },
-        "meta-llama/llama-3.3-70b-instruct:free": {
-          "name": "Meta: Llama 3.3 70B Instruct (free)"
-        },
-        "mistralai/mistral-7b-instruct:free": {
-          "name": "Mistral: Mistral 7B Instruct (free)"
-        },
-        "qwen/qwen3-coder:free": {
-          "name": "Qwen: Qwen3 Coder 480B A35B (free)"
-        }
-      }
-    }
-  },
-  "mcpServers": {
-    "memory": {
-      "type": "url",
-      "url": "http://127.0.0.1:8765/",
-      "description": "Persistent cross-session knowledge graph for agent memory and handoffs"
-    },
-    "context7": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "@upstash/context7-mcp@latest"
-      ],
-      "description": "Library and framework documentation lookup"
+  "orchestrator": {
+    "name": "construct",
+    "displayName": "Construct",
+    "role": "Your AI co-pilot",
+    "description": "Single entry point for all work — plans, builds, validates, and ships. Route everything through Construct.",
+    "modelTier": "standard",
+    "reasoningEffort": "medium",
+    "permissions": {
+      "edit": "allow",
+      "bash": "allow",
+      "webfetch": "allow"
     },
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "@playwright/mcp@latest"
-      ],
-      "description": "Browser automation and E2E testing"
-    },
-    "github": {
-      "type": "url",
-      "url": "https://api.githubcopilot.com/mcp/",
-      "headers": {
-        "Authorization": "Bearer __GITHUB_TOKEN__"
-      },
-      "description": "GitHub API: issues, PRs, code search"
-    },
-    "sequential-thinking": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "@modelcontextprotocol/server-sequential-thinking"
-      ],
-      "description": "Complex multi-step reasoning chains"
-    },
-    "construct-mcp": {
-      "command": "node",
-      "args": [
-        "__CX_TOOLKIT_DIR__/lib/mcp/server.mjs"
-      ],
-      "description": "Agent health, diff summary, file scanner, project context, telemetry trace write"
-    }
-  },
-  "sharedGuidance": [
-    "Session Resumption: start every new chat by grounding in project_context, memory_search, AGENTS.md, plan.md, and the relevant repo docs. Apply results silently — never ask the user to repeat information that memory already holds.",
-    "Memory recording: after completing meaningful work, call memory_add_observations to record what you learned. Record: patterns discovered (category: pattern), decisions made with rationale (category: decision), anti-patterns found (category: anti-pattern), and open questions (category: insight). Summaries must be ≥30 characters and specific — avoid placeholders like 'task done' or 'completed'.",
-    "Project Identification: identify the current project from the workspace (basename of CWD) or memory MCP. Focus your expertise on the target repository you are currently in.",
-    "Loop guard: if you observe the same command or tool call being attempted more than 3 times with identical arguments and no state change, stop immediately and surface what blocked progress and what decision is needed.",
-    "Circuit breaker: after 3 failed attempts at the same approach, stop all edits. Revert to last known working state. Document what was tried and escalate to the user with full context.",
-    "Worker task contract: specialists return exactly one terminal state: DONE (with files changed and verification evidence), BLOCKED (with concrete blocker and attempted steps), or NEEDS_MAIN_INPUT ({ taskKey, worker, blocker, question, safeDefault, context }). Never conduct user interviews from child sessions.",
-    "Tool naming contract: use the exact tool names exposed by the current host — never emit names from other vendors catalogs. Claude-trained models map edits→edit, writes→write, shell→bash. OpenAI-trained models map python/code interpreter→unavailable, shell→bash, apply_patch→edit/write. The bash tool requires both command and description string fields: {\"command\":\"...\",\"description\":\"why this command is needed\"}. Prefer rg over find/grep. If a needed tool is not listed, use the closest available primitive.",
-    "Observability: you MUST call cx_trace at the start of every new task using your agent name as the name field and the user goal as input. Construct attaches promptName/promptFile/promptHash automatically. If the tool is unavailable, log the failure and continue — telemetry must never block execution.",
-    "Quality scoring: after producing a significant deliverable, you MUST call cx_score with name=quality, value 0.0-1.0, and a brief comment explaining the score. Use the trace_id returned by cx_trace.",
-    "Model failover: if you hit a rate-limit error (HTTP 429), provider quota message, or model unavailability, the PostToolUseFailure hook may run construct models --apply. Surface whether fallback ran, then retry only after the model assignment changed.",
-    "Detailed orchestration reference (execution contract, handoff template, intent/category classification, parallel dispatch, horizontal routing, efficiency discipline) is in skills/operating/orchestration-reference.md — call get_skill(\"operating/orchestration-reference\") when you need it.",
-    "Agent contracts: explicit producer→consumer service contracts live in agents/contracts.json (loaded via lib/agent-contracts.mjs). Call the agent_contract MCP tool at handoff time to look up input.mustContain, preconditions, output shape, and postconditions for the current pair. routeRequest returns contractChain alongside specialists."
-  ],
-  "platformGuidance": {
-    "opencode": [
-      "You are running inside OpenCode. Construct is the primary entry point. Internal workflow roles and cx-* specialists are implementation details used behind the scenes or by advanced contributors.",
-      "Construct routes to internal specialists automatically based on intent. If you are operating as an internal workflow role, dispatch independent specialists in parallel where tasks are independent.",
-      "OpenCode subagents are not primary chat surfaces. If you are running as a subagent and you need user input, do not prompt the user from the child session. Return a concise NEEDS_MAIN_INPUT packet containing the blocker, exact question, safe default, and current task/session context so the primary persona can ask the user and resume.",
-      "If a subagent returns NEEDS_MAIN_INPUT, the primary persona must ask the user in the main session, update the tracker or plan with the blocker, then resume or re-dispatch the specialist with the answer.",
-      "Provider fallback is not guaranteed inside OpenCode provider/session failures. If you see a provider quota or usage-limit error, run or ask the main session to run `construct models --apply` after confirming an OpenRouter key is available, then retry after sync changes model assignments.",
-      "Use OpenCode's native plugin, agent, command, and hook surfaces as the orchestration substrate. Visible handoff blocks are fallback/debug artifacts, not the workflow itself.",
-      "Loop guard: if you observe the same command or tool call being attempted more than 3 times with identical arguments and no state change, stop immediately and surface what blocked progress.",
-      "If the memory MCP is available, call search_nodes with the current project name before starting work to retrieve prior session context."
-    ],
-    "claude": [
-      "Follow workspace instructions, project-level CLAUDE.md, agent definitions in ~/.claude/agents/, slash commands, and hooks. Project-level instructions override global ones.",
-      "At session start, check for .cx/context.md in the project root and incorporate prior context.",
-      "Construct is the primary entry point. Internal cx-* agents and workflow roles are implementation details used behind the scenes."
-    ],
-    "codex": [
-      "Construct is the primary Codex profile for normal use. Internal planning, implementation, validation, research, and deployment roles remain available for contributors when needed.",
-      "Codex profile switching is not automatic. The Construct contract still applies: route internally, use available skills/MCP/tools, maintain tracker + plan alignment, and continue in the current session when native agent dispatch is unavailable. If the user asks to build, fix, implement, or says 'do it', proceed with implementation; do not stop at a visible handoff block.",
-      "Keep orchestration internals internal. Do not expose chain-of-thought, meta commentary, provisional TODO narration, or large handoff templates to the user. Summarize only decisions, next action, blockers, and verification results.",
-      "Follow the relevant session skill before inventing process."
-    ],
-    "copilot": [
-      "Copilot has no spawnable subagents. Use the Construct prompt/profile for normal use; internal role-specific profiles are contributor-facing implementation details."
-    ]
+    "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,WebSearch,WebFetch,summarize_diff,scan_file,project_context,memory_create_entities,list_skills,get_skill,search_skills,list_teams,get_team,memory_search,memory_add_observations,cx_trace,cx_score",
+    "promptFile": "personas/construct.md",
+    "injectAgentRoster": true
   },
-  "personas": [
-    {
-      "name": "construct",
-      "displayName": "Construct",
-      "role": "Your AI co-pilot",
-      "description": "Single entry point for all work — plans, builds, validates, and ships. Route everything through Construct.",
-      "modelTier": "standard",
-      "reasoningEffort": "medium",
-      "permissions": {
-        "edit": "allow",
-        "bash": "allow",
-        "webfetch": "allow"
-      },
-      "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,WebSearch,WebFetch,summarize_diff,scan_file,project_context,memory_create_entities,list_skills,get_skill,search_skills,list_teams,get_team,memory_search,memory_add_observations,cx_trace,cx_score",
-      "promptFile": "personas/construct.md",
-      "injectAgentRoster": true
-    }
-  ],
-  "agents": [
+  "specialists": [
     {
       "internal": true,
       "name": "orchestrator",
@@ -174,14 +28,29 @@
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,list_teams,get_team,memory_search,memory_add_observations,cx_trace,cx_score",
       "injectAgentRoster": true,
-      "promptFile": "agents/prompts/cx-orchestrator.md",
+      "promptFile": "specialists/prompts/cx-orchestrator.md",
       "embedOrientation": {
-        "focusAreas": ["routing accuracy", "workload balance", "handoff completeness", "specialist utilization"],
-        "riskSignals": ["misrouted tasks", "overloaded specialists", "dropped handoffs", "stale queued work"],
-        "artifactBias": ["notes", "memos"]
+        "focusAreas": [
+          "routing accuracy",
+          "workload balance",
+          "handoff completeness",
+          "specialist utilization"
+        ],
+        "riskSignals": [
+          "misrouted tasks",
+          "overloaded specialists",
+          "dropped handoffs",
+          "stale queued work"
+        ],
+        "artifactBias": [
+          "notes",
+          "memos"
+        ]
       },
       "skills": [
-        "ai/orchestration-workflow"
+        "ai/orchestration-workflow",
+        "operating/orchestration-reference",
+        "operating/change-management"
       ],
       "perspective": {
         "bias": "Over-routing to cx-engineer, false simplicity, plans where every task runs in parallel",
@@ -200,11 +69,24 @@
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,get_template,list_templates,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-rd-lead.md",
+      "promptFile": "specialists/prompts/cx-rd-lead.md",
       "embedOrientation": {
-        "focusAreas": ["hypothesis validation", "experiment progress", "assumption tracking", "learning velocity"],
-        "riskSignals": ["untested assumptions", "premature hardening", "stalled experiments", "unfalsifiable claims"],
-        "artifactBias": ["adrs", "notes"]
+        "focusAreas": [
+          "hypothesis validation",
+          "experiment progress",
+          "assumption tracking",
+          "learning velocity"
+        ],
+        "riskSignals": [
+          "untested assumptions",
+          "premature hardening",
+          "stalled experiments",
+          "unfalsifiable claims"
+        ],
+        "artifactBias": [
+          "adrs",
+          "notes"
+        ]
       },
       "skills": [
         "ai/agent-dev",
@@ -226,11 +108,25 @@
       "reasoningEffort": "high",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,get_template,list_templates,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-product-manager.md",
+      "promptFile": "specialists/prompts/cx-product-manager.md",
       "embedOrientation": {
-        "focusAreas": ["requirements coverage", "delivery risk", "user-facing gaps", "scope clarity"],
-        "riskSignals": ["untraced requirements", "scope creep", "blocked dependencies", "missing acceptance criteria"],
-        "artifactBias": ["prds", "intake", "memos"]
+        "focusAreas": [
+          "requirements coverage",
+          "delivery risk",
+          "user-facing gaps",
+          "scope clarity"
+        ],
+        "riskSignals": [
+          "untraced requirements",
+          "scope creep",
+          "blocked dependencies",
+          "missing acceptance criteria"
+        ],
+        "artifactBias": [
+          "prds",
+          "intake",
+          "memos"
+        ]
       },
       "skills": [
         "docs/product-intelligence-workflow",
@@ -261,11 +157,24 @@
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-ux-researcher.md",
+      "promptFile": "specialists/prompts/cx-ux-researcher.md",
       "embedOrientation": {
-        "focusAreas": ["user evidence freshness", "friction points", "persona coverage", "research gaps"],
-        "riskSignals": ["stale user data", "untested assumptions about users", "missing friction analysis", "internal-only validation"],
-        "artifactBias": ["notes", "memos"]
+        "focusAreas": [
+          "user evidence freshness",
+          "friction points",
+          "persona coverage",
+          "research gaps"
+        ],
+        "riskSignals": [
+          "stale user data",
+          "untested assumptions about users",
+          "missing friction analysis",
+          "internal-only validation"
+        ],
+        "artifactBias": [
+          "notes",
+          "memos"
+        ]
       },
       "skills": [
         "docs/research-workflow"
@@ -294,14 +203,30 @@
       "reasoningEffort": "medium",
       "codexSandbox": "workspace-write",
       "claudeTools": "Read,Grep,Glob,LS,Bash,Edit,Write,list_skills,get_skill,search_skills,get_template,list_templates,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-operations.md",
+      "promptFile": "specialists/prompts/cx-operations.md",
       "embedOrientation": {
-        "focusAreas": ["dependency sequencing", "ownership clarity", "blocker resolution", "delivery cadence"],
-        "riskSignals": ["hidden dependencies", "unowned tasks", "blocked work aging", "parallel plans with serial reality"],
-        "artifactBias": ["notes", "memos"]
+        "focusAreas": [
+          "dependency sequencing",
+          "ownership clarity",
+          "blocker resolution",
+          "delivery cadence"
+        ],
+        "riskSignals": [
+          "hidden dependencies",
+          "unowned tasks",
+          "blocked work aging",
+          "parallel plans with serial reality"
+        ],
+        "artifactBias": [
+          "notes",
+          "memos"
+        ]
       },
       "skills": [
-        "docs/init-project"
+        "docs/init-project",
+        "operating/incident-response",
+        "operating/oncall-rotation",
+        "operating/change-management"
       ],
       "perspective": {
         "bias": "Plans where every task runs in parallel, tasks that sound atomic but aren't, work starting before blockers clear",
@@ -319,11 +244,24 @@
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,WebSearch,WebFetch,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-researcher.md",
+      "promptFile": "specialists/prompts/cx-researcher.md",
       "embedOrientation": {
-        "focusAreas": ["source freshness", "citation coverage", "dependency versions", "conflicting evidence"],
-        "riskSignals": ["undated sources", "unverified claims", "outdated dependencies", "single-source conclusions"],
-        "artifactBias": ["notes", "memos"]
+        "focusAreas": [
+          "source freshness",
+          "citation coverage",
+          "dependency versions",
+          "conflicting evidence"
+        ],
+        "riskSignals": [
+          "undated sources",
+          "unverified claims",
+          "outdated dependencies",
+          "single-source conclusions"
+        ],
+        "artifactBias": [
+          "notes",
+          "memos"
+        ]
       },
       "skills": [
         "docs/research-workflow",
@@ -345,14 +283,30 @@
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,WebSearch,WebFetch,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-business-strategist.md",
+      "promptFile": "specialists/prompts/cx-business-strategist.md",
       "embedOrientation": {
-        "focusAreas": ["market positioning", "competitive shifts", "timing relevance", "strategic coherence"],
-        "riskSignals": ["tactics dressed as strategy", "ignored competitive moves", "undifferentiated positioning", "missing market timing"],
-        "artifactBias": ["memos", "notes"]
+        "focusAreas": [
+          "market positioning",
+          "competitive shifts",
+          "timing relevance",
+          "strategic coherence"
+        ],
+        "riskSignals": [
+          "tactics dressed as strategy",
+          "ignored competitive moves",
+          "undifferentiated positioning",
+          "missing market timing"
+        ],
+        "artifactBias": [
+          "memos",
+          "notes"
+        ]
       },
       "skills": [
-        "architecture/api-design"
+        "strategy/competitive-landscape",
+        "strategy/market-research-methods",
+        "strategy/pricing-positioning",
+        "strategy/narrative-arc"
       ],
       "perspective": {
         "bias": "Tactical decisions dressed as strategy, ignoring competitive dynamics, 'build it and they will come'",
@@ -375,11 +329,24 @@
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-data-analyst.md",
+      "promptFile": "specialists/prompts/cx-data-analyst.md",
       "embedOrientation": {
-        "focusAreas": ["metric validity", "measurement coverage", "behavioral indicators", "distribution analysis"],
-        "riskSignals": ["vanity metrics", "averages hiding variance", "post-hoc success definitions", "ungamed metrics becoming gamed"],
-        "artifactBias": ["notes", "memos"]
+        "focusAreas": [
+          "metric validity",
+          "measurement coverage",
+          "behavioral indicators",
+          "distribution analysis"
+        ],
+        "riskSignals": [
+          "vanity metrics",
+          "averages hiding variance",
+          "post-hoc success definitions",
+          "ungamed metrics becoming gamed"
+        ],
+        "artifactBias": [
+          "notes",
+          "memos"
+        ]
       },
       "skills": [
         "devops/observability",
@@ -408,11 +375,24 @@
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score",
-      "promptFile": "agents/prompts/cx-evaluator.md",
+      "promptFile": "specialists/prompts/cx-evaluator.md",
       "embedOrientation": {
-        "focusAreas": ["eval coverage", "regression detection", "baseline drift", "failure case representation"],
-        "riskSignals": ["eval sets matching known outputs", "cherry-picked baselines", "missing failure cases", "promotion on too few traces"],
-        "artifactBias": ["notes", "adrs"]
+        "focusAreas": [
+          "eval coverage",
+          "regression detection",
+          "baseline drift",
+          "failure case representation"
+        ],
+        "riskSignals": [
+          "eval sets matching known outputs",
+          "cherry-picked baselines",
+          "missing failure cases",
+          "promotion on too few traces"
+        ],
+        "artifactBias": [
+          "notes",
+          "adrs"
+        ]
       },
       "skills": [
         "ai/prompt-and-eval",
@@ -439,11 +419,24 @@
       "reasoningEffort": "high",
       "codexSandbox": "workspace-write",
       "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score",
-      "promptFile": "agents/prompts/cx-ai-engineer.md",
+      "promptFile": "specialists/prompts/cx-ai-engineer.md",
       "embedOrientation": {
-        "focusAreas": ["model reliability", "failure mode coverage", "prompt stability", "eval health"],
-        "riskSignals": ["untested failure paths", "hallucination risk dismissed", "prompt drift", "demo-only validation"],
-        "artifactBias": ["adrs", "notes"]
+        "focusAreas": [
+          "model reliability",
+          "failure mode coverage",
+          "prompt stability",
+          "eval health"
+        ],
+        "riskSignals": [
+          "untested failure paths",
+          "hallucination risk dismissed",
+          "prompt drift",
+          "demo-only validation"
+        ],
+        "artifactBias": [
+          "adrs",
+          "notes"
+        ]
       },
       "skills": [
         "ai/agent-dev",
@@ -476,11 +469,24 @@
       "reasoningEffort": "high",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,get_template,list_templates,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-architect.md",
+      "promptFile": "specialists/prompts/cx-architect.md",
       "embedOrientation": {
-        "focusAreas": ["coupling and cohesion", "unvalidated assumptions", "interface contracts", "tech debt accumulation"],
-        "riskSignals": ["missing ADRs", "implicit contracts", "data model drift", "undocumented invariants"],
-        "artifactBias": ["adrs", "notes"]
+        "focusAreas": [
+          "coupling and cohesion",
+          "unvalidated assumptions",
+          "interface contracts",
+          "tech debt accumulation"
+        ],
+        "riskSignals": [
+          "missing ADRs",
+          "implicit contracts",
+          "data model drift",
+          "undocumented invariants"
+        ],
+        "artifactBias": [
+          "adrs",
+          "notes"
+        ]
       },
       "skills": [
         "architecture/api-design",
@@ -509,13 +515,26 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "embedOrientation": {
-        "focusAreas": ["implementation progress", "test coverage gaps", "build health", "PR velocity"],
-        "riskSignals": ["failing CI", "stale PRs", "untested paths", "pattern drift"],
-        "artifactBias": ["notes", "adrs"]
+        "focusAreas": [
+          "implementation progress",
+          "test coverage gaps",
+          "build health",
+          "PR velocity"
+        ],
+        "riskSignals": [
+          "failing CI",
+          "stale PRs",
+          "untested paths",
+          "pattern drift"
+        ],
+        "artifactBias": [
+          "notes",
+          "adrs"
+        ]
       },
       "codexSandbox": "workspace-write",
       "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,WebSearch,WebFetch,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score",
-      "promptFile": "agents/prompts/cx-engineer.md",
+      "promptFile": "specialists/prompts/cx-engineer.md",
       "skills": [
         "development/typescript",
         "development/python",
@@ -532,7 +551,10 @@
         "frameworks/react",
         "frameworks/nextjs",
         "frameworks/django",
-        "frameworks/spring-boot"
+        "frameworks/spring-boot",
+        "exploration/unknown-codebase-onboarding",
+        "exploration/tracer-bullet-method",
+        "exploration/dependency-graph-reading"
       ],
       "perspective": {
         "bias": "Implementations that ignore existing conventions, abstractions that complicate the simple case",
@@ -550,11 +572,24 @@
       "reasoningEffort": "high",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-devil-advocate.md",
+      "promptFile": "specialists/prompts/cx-devil-advocate.md",
       "embedOrientation": {
-        "focusAreas": ["plan survivability", "hidden failure modes", "scope stability", "assumption stress-testing"],
-        "riskSignals": ["plans too elegant to survive contact", "unlikely failures unaddressed", "scope drift", "unanimous agreement without challenge"],
-        "artifactBias": ["notes", "memos"]
+        "focusAreas": [
+          "plan survivability",
+          "hidden failure modes",
+          "scope stability",
+          "assumption stress-testing"
+        ],
+        "riskSignals": [
+          "plans too elegant to survive contact",
+          "unlikely failures unaddressed",
+          "scope drift",
+          "unanimous agreement without challenge"
+        ],
+        "artifactBias": [
+          "notes",
+          "memos"
+        ]
       },
       "skills": [
         "quality-gates/review-work"
@@ -575,11 +610,23 @@
       "reasoningEffort": "high",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score",
-      "promptFile": "agents/prompts/cx-reviewer.md",
+      "promptFile": "specialists/prompts/cx-reviewer.md",
       "embedOrientation": {
-        "focusAreas": ["edge case coverage", "error handling completeness", "test fidelity", "code quality trends"],
-        "riskSignals": ["happy-path-only reviews", "excessive mocking", "missing error handlers", "review without reproduction"],
-        "artifactBias": ["notes"]
+        "focusAreas": [
+          "edge case coverage",
+          "error handling completeness",
+          "test fidelity",
+          "code quality trends"
+        ],
+        "riskSignals": [
+          "happy-path-only reviews",
+          "excessive mocking",
+          "missing error handlers",
+          "review without reproduction"
+        ],
+        "artifactBias": [
+          "notes"
+        ]
       },
       "skills": [
         "quality-gates/verify-quality",
@@ -602,11 +649,24 @@
       "reasoningEffort": "high",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score",
-      "promptFile": "agents/prompts/cx-security.md",
+      "promptFile": "specialists/prompts/cx-security.md",
       "embedOrientation": {
-        "focusAreas": ["attack surface changes", "dependency vulnerabilities", "auth boundary integrity", "secret exposure"],
-        "riskSignals": ["new unauthed endpoints", "unaudited dependencies", "implicit trust boundaries", "hardcoded credentials"],
-        "artifactBias": ["adrs", "notes"]
+        "focusAreas": [
+          "attack surface changes",
+          "dependency vulnerabilities",
+          "auth boundary integrity",
+          "secret exposure"
+        ],
+        "riskSignals": [
+          "new unauthed endpoints",
+          "unaudited dependencies",
+          "implicit trust boundaries",
+          "hardcoded credentials"
+        ],
+        "artifactBias": [
+          "adrs",
+          "notes"
+        ]
       },
       "skills": [
         "security/red-team",
@@ -634,11 +694,23 @@
       "reasoningEffort": "medium",
       "codexSandbox": "workspace-write",
       "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score",
-      "promptFile": "agents/prompts/cx-qa.md",
+      "promptFile": "specialists/prompts/cx-qa.md",
       "embedOrientation": {
-        "focusAreas": ["test effectiveness", "behavioral coverage", "regression risk", "acceptance criteria traceability"],
-        "riskSignals": ["tests that never fail", "coverage without behavioral assertions", "untested acceptance criteria", "flaky tests ignored"],
-        "artifactBias": ["notes"]
+        "focusAreas": [
+          "test effectiveness",
+          "behavioral coverage",
+          "regression risk",
+          "acceptance criteria traceability"
+        ],
+        "riskSignals": [
+          "tests that never fail",
+          "coverage without behavioral assertions",
+          "untested acceptance criteria",
+          "flaky tests ignored"
+        ],
+        "artifactBias": [
+          "notes"
+        ]
       },
       "skills": [
         "devops/testing",
@@ -661,11 +733,23 @@
       "reasoningEffort": "high",
       "codexSandbox": "workspace-write",
       "claudeTools": "Read,Grep,Glob,LS,Bash,Edit,WebSearch,WebFetch,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score",
-      "promptFile": "agents/prompts/cx-debugger.md",
+      "promptFile": "specialists/prompts/cx-debugger.md",
       "embedOrientation": {
-        "focusAreas": ["root cause identification", "reproduction reliability", "fix verification", "regression prevention"],
-        "riskSignals": ["symptom fixes without root cause", "non-reproducible bugs closed", "missing regression tests", "repeated failure patterns"],
-        "artifactBias": ["notes"]
+        "focusAreas": [
+          "root cause identification",
+          "reproduction reliability",
+          "fix verification",
+          "regression prevention"
+        ],
+        "riskSignals": [
+          "symptom fixes without root cause",
+          "non-reproducible bugs closed",
+          "missing regression tests",
+          "repeated failure patterns"
+        ],
+        "artifactBias": [
+          "notes"
+        ]
       },
       "skills": [
         "quality-gates/verify-change",
@@ -688,11 +772,24 @@
       "reasoningEffort": "medium",
       "codexSandbox": "workspace-write",
       "claudeTools": "Read,Grep,Glob,LS,Bash,Edit,list_skills,get_skill,search_skills,get_template,list_templates,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-sre.md",
+      "promptFile": "specialists/prompts/cx-sre.md",
       "embedOrientation": {
-        "focusAreas": ["reliability posture", "observability coverage", "incident readiness", "SLO adherence"],
-        "riskSignals": ["missing alerts", "untested rollbacks", "observability gaps", "SLOs defined post-incident"],
-        "artifactBias": ["adrs", "notes"]
+        "focusAreas": [
+          "reliability posture",
+          "observability coverage",
+          "incident readiness",
+          "SLO adherence"
+        ],
+        "riskSignals": [
+          "missing alerts",
+          "untested rollbacks",
+          "observability gaps",
+          "SLOs defined post-incident"
+        ],
+        "artifactBias": [
+          "adrs",
+          "notes"
+        ]
       },
       "skills": [
         "devops/observability",
@@ -724,11 +821,24 @@
       "reasoningEffort": "medium",
       "codexSandbox": "workspace-write",
       "claudeTools": "Read,Grep,Glob,LS,Bash,Edit,Write,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-platform-engineer.md",
+      "promptFile": "specialists/prompts/cx-platform-engineer.md",
       "embedOrientation": {
-        "focusAreas": ["developer friction", "pipeline health", "dependency freshness", "build reliability"],
-        "riskSignals": ["slow CI", "stale dependencies", "manual steps in pipelines", "config only author understands"],
-        "artifactBias": ["adrs", "notes"]
+        "focusAreas": [
+          "developer friction",
+          "pipeline health",
+          "dependency freshness",
+          "build reliability"
+        ],
+        "riskSignals": [
+          "slow CI",
+          "stale dependencies",
+          "manual steps in pipelines",
+          "config only author understands"
+        ],
+        "artifactBias": [
+          "adrs",
+          "notes"
+        ]
       },
       "skills": [
         "devops/ci-cd",
@@ -761,11 +871,24 @@
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,WebSearch,WebFetch,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-legal-compliance.md",
+      "promptFile": "specialists/prompts/cx-legal-compliance.md",
       "embedOrientation": {
-        "focusAreas": ["license compliance", "data privacy posture", "AI disclosure obligations", "regulatory changes"],
-        "riskSignals": ["unreviewed dependency licenses", "undisclosed AI processing", "missing data basis documentation", "new jurisdiction exposure"],
-        "artifactBias": ["adrs", "memos"]
+        "focusAreas": [
+          "license compliance",
+          "data privacy posture",
+          "AI disclosure obligations",
+          "regulatory changes"
+        ],
+        "riskSignals": [
+          "unreviewed dependency licenses",
+          "undisclosed AI processing",
+          "missing data basis documentation",
+          "new jurisdiction exposure"
+        ],
+        "artifactBias": [
+          "adrs",
+          "memos"
+        ]
       },
       "skills": [
         "compliance/license-audit",
@@ -789,11 +912,24 @@
       "reasoningEffort": "medium",
       "codexSandbox": "workspace-write",
       "claudeTools": "Read,Grep,Glob,LS,Bash,Edit,Write,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-release-manager.md",
+      "promptFile": "specialists/prompts/cx-release-manager.md",
       "embedOrientation": {
-        "focusAreas": ["release readiness", "rollback viability", "changelog completeness", "migration safety"],
-        "riskSignals": ["untested rollback", "irreversible migrations", "missing changelog entries", "canary without rollback trigger"],
-        "artifactBias": ["notes", "adrs"]
+        "focusAreas": [
+          "release readiness",
+          "rollback viability",
+          "changelog completeness",
+          "migration safety"
+        ],
+        "riskSignals": [
+          "untested rollback",
+          "irreversible migrations",
+          "missing changelog entries",
+          "canary without rollback trigger"
+        ],
+        "artifactBias": [
+          "notes",
+          "adrs"
+        ]
       },
       "skills": [
         "devops/git-workflow",
@@ -815,11 +951,25 @@
       "reasoningEffort": "medium",
       "codexSandbox": "workspace-write",
       "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-docs-keeper.md",
+      "promptFile": "specialists/prompts/cx-docs-keeper.md",
       "embedOrientation": {
-        "focusAreas": ["documentation freshness", "decision traceability", "context completeness", "onboarding clarity"],
-        "riskSignals": ["stale docs", "undocumented decisions", "missing context updates", "tribal knowledge growing"],
-        "artifactBias": ["adrs", "notes", "memos"]
+        "focusAreas": [
+          "documentation freshness",
+          "decision traceability",
+          "context completeness",
+          "onboarding clarity"
+        ],
+        "riskSignals": [
+          "stale docs",
+          "undocumented decisions",
+          "missing context updates",
+          "tribal knowledge growing"
+        ],
+        "artifactBias": [
+          "adrs",
+          "notes",
+          "memos"
+        ]
       },
       "skills": [
         "docs/adr-workflow",
@@ -842,11 +992,24 @@
       "reasoningEffort": "medium",
       "codexSandbox": "workspace-write",
       "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-designer.md",
+      "promptFile": "specialists/prompts/cx-designer.md",
       "embedOrientation": {
-        "focusAreas": ["interaction completeness", "state coverage", "design consistency", "accessibility compliance"],
-        "riskSignals": ["missing error states", "no empty states", "inconsistent patterns", "untested responsive breakpoints"],
-        "artifactBias": ["notes", "memos"]
+        "focusAreas": [
+          "interaction completeness",
+          "state coverage",
+          "design consistency",
+          "accessibility compliance"
+        ],
+        "riskSignals": [
+          "missing error states",
+          "no empty states",
+          "inconsistent patterns",
+          "untested responsive breakpoints"
+        ],
+        "artifactBias": [
+          "notes",
+          "memos"
+        ]
       },
       "skills": [
         "frontend-design/ui-aesthetics",
@@ -872,11 +1035,23 @@
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-accessibility.md",
+      "promptFile": "specialists/prompts/cx-accessibility.md",
       "embedOrientation": {
-        "focusAreas": ["keyboard navigability", "screen reader compatibility", "contrast compliance", "ARIA correctness"],
-        "riskSignals": ["ARIA added without testing", "keyboard traps", "contrast failures", "missing focus indicators"],
-        "artifactBias": ["notes"]
+        "focusAreas": [
+          "keyboard navigability",
+          "screen reader compatibility",
+          "contrast compliance",
+          "ARIA correctness"
+        ],
+        "riskSignals": [
+          "ARIA added without testing",
+          "keyboard traps",
+          "contrast failures",
+          "missing focus indicators"
+        ],
+        "artifactBias": [
+          "notes"
+        ]
       },
       "skills": [
         "frontend-design/accessibility"
@@ -904,14 +1079,29 @@
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
-      "promptFile": "agents/prompts/cx-explorer.md",
+      "promptFile": "specialists/prompts/cx-explorer.md",
       "embedOrientation": {
-        "focusAreas": ["codebase understanding", "pattern discovery", "dependency mapping", "drift detection"],
-        "riskSignals": ["assumptions without verification", "incomplete investigation", "outdated mental models", "undiscovered code paths"],
-        "artifactBias": ["notes"]
+        "focusAreas": [
+          "codebase understanding",
+          "pattern discovery",
+          "dependency mapping",
+          "drift detection"
+        ],
+        "riskSignals": [
+          "assumptions without verification",
+          "incomplete investigation",
+          "outdated mental models",
+          "undiscovered code paths"
+        ],
+        "artifactBias": [
+          "notes"
+        ]
       },
       "skills": [
-        "exploration/repo-map"
+        "exploration/repo-map",
+        "exploration/unknown-codebase-onboarding",
+        "exploration/tracer-bullet-method",
+        "exploration/dependency-graph-reading"
       ],
       "perspective": {
         "bias": "'I know where this is' without verifying, grep results without context, 5-minute investigations",
@@ -928,11 +1118,24 @@
       "modelTier": "reasoning",
       "reasoningEffort": "high",
       "claudeTools": "Read,Write,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score",
-      "promptFile": "agents/prompts/cx-trace-reviewer.md",
+      "promptFile": "specialists/prompts/cx-trace-reviewer.md",
       "embedOrientation": {
-        "focusAreas": ["agent performance trends", "variance detection", "degradation signals", "fleet health"],
-        "riskSignals": ["stable median hiding variance", "silent degradation", "promotion on few traces", "unreviewed failure clusters"],
-        "artifactBias": ["notes", "memos"]
+        "focusAreas": [
+          "agent performance trends",
+          "variance detection",
+          "degradation signals",
+          "fleet health"
+        ],
+        "riskSignals": [
+          "stable median hiding variance",
+          "silent degradation",
+          "promotion on few traces",
+          "unreviewed failure clusters"
+        ],
+        "artifactBias": [
+          "notes",
+          "memos"
+        ]
       },
       "skills": [
         "ai/prompt-optimizer"
@@ -952,11 +1155,24 @@
       "modelTier": "standard",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score",
-      "promptFile": "agents/prompts/cx-data-engineer.md",
+      "promptFile": "specialists/prompts/cx-data-engineer.md",
       "embedOrientation": {
-        "focusAreas": ["pipeline reliability", "data quality", "schema contract adherence", "idempotency"],
-        "riskSignals": ["non-idempotent pipelines", "missing data quality tests", "schema drift", "uncontracted outputs"],
-        "artifactBias": ["adrs", "notes"]
+        "focusAreas": [
+          "pipeline reliability",
+          "data quality",
+          "schema contract adherence",
+          "idempotency"
+        ],
+        "riskSignals": [
+          "non-idempotent pipelines",
+          "missing data quality tests",
+          "schema drift",
+          "uncontracted outputs"
+        ],
+        "artifactBias": [
+          "adrs",
+          "notes"
+        ]
       },
       "skills": [
         "devops/data-engineering",
@@ -978,11 +1194,23 @@
       "modelTier": "standard",
       "codexSandbox": "read-only",
       "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations,cx_trace,cx_score",
-      "promptFile": "agents/prompts/cx-test-automation.md",
+      "promptFile": "specialists/prompts/cx-test-automation.md",
       "embedOrientation": {
-        "focusAreas": ["test determinism", "flakiness trends", "automation ROI", "behavioral coverage"],
-        "riskSignals": ["flaky tests ignored", "arbitrary sleeps", "tests that never caught a bug", "intermittent failures dismissed"],
-        "artifactBias": ["notes"]
+        "focusAreas": [
+          "test determinism",
+          "flakiness trends",
+          "automation ROI",
+          "behavioral coverage"
+        ],
+        "riskSignals": [
+          "flaky tests ignored",
+          "arbitrary sleeps",
+          "tests that never caught a bug",
+          "intermittent failures dismissed"
+        ],
+        "artifactBias": [
+          "notes"
+        ]
       },
       "skills": [
         "devops/testing",
@@ -998,157 +1226,162 @@
       "canEdit": true
     }
   ],
-  "departments": {
-    "rnd": {
-      "name": "R&D (Research & Development)",
-      "description": "The entire product-building organization. You are the founder/CEO; R&D executes your vision.",
-      "subDepartments": {
-        "product": {
-          "name": "Product Department",
-          "mission": "Define what to build and why. Own the user outcome.",
-          "roles": ["product-manager", "designer", "ux-researcher", "accessibility"]
-        },
-        "engineering": {
-          "name": "Engineering Department",
-          "mission": "Build it right. Own the implementation.",
-          "roles": ["architect", "engineer", "debugger", "qa", "sre", "platform-engineer"]
-        },
-        "intelligence": {
-          "name": "Intelligence Department",
-          "mission": "Discover what's possible and what's broken. Own the learning loop.",
-          "roles": ["researcher", "data-analyst", "ai-engineer", "evaluator", "trace-reviewer"]
-        }
-      }
+  "models": {
+    "reasoning": {
+      "primary": null,
+      "fallback": []
     },
-    "governance": {
-      "name": "Governance",
-      "description": "Oversight, risk management, and compliance — independent from R&D.",
-      "subDepartments": {
-        "security": {
-          "name": "Security",
-          "mission": "Keep it safe. Own the threat surface.",
-          "roles": ["security", "legal-compliance"]
-        },
-        "quality": {
-          "name": "Quality Assurance",
-          "mission": "Challenge assumptions. Own the critical eye.",
-          "roles": ["reviewer", "devil-advocate"]
-        }
-      }
+    "standard": {
+      "primary": null,
+      "fallback": []
     },
-    "operations": {
-      "name": "Operations",
-      "description": "Shipping, documentation, and release management.",
-      "subDepartments": {
-        "release": {
-          "name": "Release Management",
-          "mission": "Ship smoothly. Own the release process.",
-          "roles": ["release-manager"]
-        },
-        "documentation": {
-          "name": "Documentation",
-          "mission": "Maintain institutional knowledge. Own the record.",
-          "roles": ["docs-keeper"]
-        }
-      }
+    "fast": {
+      "primary": null,
+      "fallback": []
     },
-    "strategy": {
-      "name": "Strategy",
-      "description": "Business alignment and execution planning.",
-      "subDepartments": {
-        "business": {
-          "name": "Business Strategy",
-          "mission": "Ensure market fit. Own the business model.",
-          "roles": ["business-strategist"]
+    "embeddings": {
+      "local": {
+        "provider": "onnx",
+        "model": "Xenova/all-MiniLM-L6-v2",
+        "dimensions": 384,
+        "description": "Free, offline, runs locally via ONNX Runtime"
+      },
+      "openai": {
+        "provider": "openai",
+        "model": "text-embedding-3-small",
+        "dimensions": 1536,
+        "description": "Best quality, requires OPENAI_API_KEY"
+      },
+      "ollama": {
+        "provider": "ollama",
+        "model": "nomic-embed-text",
+        "dimensions": 768,
+        "description": "Local Ollama server, requires OLLAMA_BASE_URL"
+      },
+      "hashing": {
+        "provider": "local",
+        "model": "hashing-bow-v1",
+        "dimensions": 256,
+        "description": "Legacy deterministic hash — fast but no semantic understanding"
+      }
+    }
+  },
+  "providers": {
+    "openrouter": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "OpenRouter",
+      "options": {
+        "baseURL": "https://openrouter.ai/api/v1",
+        "headers": {
+          "HTTP-Referer": "__OPENROUTER_REFERER__",
+          "X-Title": "__OPENROUTER_TITLE__"
+        }
+      },
+      "models": {
+        "google/gemma-3-27b-it:free": {
+          "name": "Google: Gemma 3 27B (free)"
         },
-        "planning": {
-          "name": "Operations Planning",
-          "mission": "Map dependencies. Own the execution plan.",
-          "roles": ["operations"]
+        "meta-llama/llama-3.3-70b-instruct:free": {
+          "name": "Meta: Llama 3.3 70B Instruct (free)"
+        },
+        "mistralai/mistral-7b-instruct:free": {
+          "name": "Mistral: Mistral 7B Instruct (free)"
+        },
+        "qwen/qwen3-coder:free": {
+          "name": "Qwen: Qwen3 Coder 480B A35B (free)"
         }
       }
     }
   },
-  "consolidatedRoles": {
-    "description": "Simplified 12-role structure for smaller projects. Each consolidated role absorbs multiple specialists.",
-    "roles": [
-      {
-        "id": "product-lead",
-        "absorbs": ["product-manager", "designer", "ux-researcher"],
-        "whenToUse": "Small teams, early-stage products"
-      },
-      {
-        "id": "tech-lead",
-        "absorbs": ["architect", "engineer", "debugger"],
-        "whenToUse": "Startups, MVP development"
-      },
-      {
-        "id": "quality-lead",
-        "absorbs": ["qa", "accessibility", "reviewer"],
-        "whenToUse": "Projects with compliance needs"
-      },
-      {
-        "id": "reliability-lead",
-        "absorbs": ["sre", "platform-engineer", "release-manager"],
-        "whenToUse": "Production systems"
-      },
-      {
-        "id": "research-lead",
-        "absorbs": ["researcher", "data-analyst", "evaluator"],
-        "whenToUse": "Data-driven products"
-      },
-      {
-        "id": "ai-lead",
-        "absorbs": ["ai-engineer", "trace-reviewer"],
-        "whenToUse": "AI/ML products"
-      },
-      {
-        "id": "security-lead",
-        "absorbs": ["security", "legal-compliance"],
-        "whenToUse": "Regulated industries"
-      },
-      {
-        "id": "strategy-lead",
-        "absorbs": ["business-strategist", "operations"],
-        "whenToUse": "Growth-stage companies"
-      },
-      {
-        "id": "docs-lead",
-        "absorbs": ["docs-keeper"],
-        "whenToUse": "Documentation-heavy projects"
-      },
-      {
-        "id": "orchestrator",
-        "absorbs": ["orchestrator", "rd-lead"],
-        "whenToUse": "Complex multi-team initiatives"
+  "mcpServers": {
+    "memory": {
+      "command": "node",
+      "args": [
+        "__CX_TOOLKIT_DIR__/lib/mcp/memory-bridge.mjs"
+      ],
+      "env": {
+        "CONSTRUCT_MEMORY_BRIDGE_URL": "http://127.0.0.1:__MEMORY_PORT__/"
       },
-      {
-        "id": "critic",
-        "absorbs": ["devil-advocate", "evaluator"],
-        "whenToUse": "High-stakes decisions"
+      "description": "Stdio MCP bridge for cass-memory: persistent cross-session knowledge graph for agent memory and handoffs"
+    },
+    "context7": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@upstash/context7-mcp@latest"
+      ],
+      "description": "Library and framework documentation lookup"
+    },
+    "playwright": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@playwright/mcp@latest"
+      ],
+      "description": "Browser automation and E2E testing"
+    },
+    "github": {
+      "type": "url",
+      "url": "https://api.githubcopilot.com/mcp/",
+      "headers": {
+        "Authorization": "Bearer __GITHUB_TOKEN__"
       },
-      {
-        "id": "generalist",
-        "absorbs": ["engineer"],
-        "whenToUse": "General purpose, default role"
-      }
-    ]
-  },
-  "roleSelection": {
-    "description": "User-configurable primary/secondary role preferences. Set via dashboard or CLI.",
-    "defaults": {
-      "primary": null,
-      "secondary": null
+      "description": "GitHub API: issues, PRs, code search"
+    },
+    "sequential-thinking": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-sequential-thinking"
+      ],
+      "description": "Complex multi-step reasoning chains"
     },
-    "perConversationOverride": true,
-    "cliSyntax": "@construct --primary=cx-pm --secondary=cx-arch"
+    "construct-mcp": {
+      "command": "node",
+      "args": [
+        "__CX_TOOLKIT_DIR__/lib/mcp/server.mjs"
+      ],
+      "description": "Agent health, diff summary, file scanner, project context, telemetry trace write"
+    }
   },
-  "modelGuidance": {
-    "claude": "If you are a Claude model: leverage extended thinking for deep analysis. Use artifact outputs for structured deliverables. You have strong tool-use — prefer parallel tool calls when tasks are independent.",
-    "deepseek": "If you are a DeepSeek model: use explicit chain-of-thought reasoning. Break complex logic into numbered steps before implementing. You excel at code generation — write complete implementations rather than pseudocode.",
-    "gemini": "If you are a Gemini model: leverage grounding for documentation lookups. Use structured output mode for data transformations. You have strong multimodal capabilities — reference visual context when available.",
-    "qwen": "If you are a Qwen model: you have strong multilingual and code capabilities. Use step-by-step reasoning for complex tasks. Be explicit about trade-offs when proposing solutions.",
-    "llama": "If you are a Llama model: be explicit about uncertainty. Prefer shorter, focused responses over long narratives. Break complex tasks into smaller verifiable steps.",
-    "gpt": "If you are a GPT model: use structured JSON mode for data transformations. Leverage system message for persistent context. You handle function calling well — use tools proactively."
+  "sharedGuidance": [
+    "Session Resumption: start every new chat by grounding in project_context, memory_search, AGENTS.md, plan.md, and the relevant repo docs. Apply results silently — never ask the user to repeat information that memory already holds.",
+    "Memory recording: after completing meaningful work, call memory_add_observations to record what you learned. Record: patterns discovered (category: pattern), decisions made with rationale (category: decision), anti-patterns found (category: anti-pattern), and open questions (category: insight). Summaries must be ≥30 characters and specific — avoid placeholders like 'task done' or 'completed'.",
+    "Project Identification: identify the current project from the workspace (basename of CWD) or memory MCP. Focus your expertise on the target repository you are currently in.",
+    "Loop guard: if you observe the same command or tool call being attempted more than 3 times with identical arguments and no state change, stop immediately and surface what blocked progress and what decision is needed.",
+    "Circuit breaker: after 3 failed attempts at the same approach, stop all edits. Revert to last known working state. Document what was tried and escalate to the user with full context.",
+    "Worker task contract: specialists return exactly one terminal state: DONE (with files changed and verification evidence), BLOCKED (with concrete blocker and attempted steps), or NEEDS_MAIN_INPUT ({ taskKey, worker, blocker, question, safeDefault, context }). Never conduct user interviews from child sessions.",
+    "Tool naming contract: use the exact tool names exposed by the current host — never emit names from other vendors catalogs. Claude-trained models map edits→edit, writes→write, shell→bash. OpenAI-trained models map python/code interpreter→unavailable, shell→bash, apply_patch→edit/write. The bash tool requires both command and description string fields: {\"command\":\"...\",\"description\":\"why this command is needed\"}. Prefer rg over find/grep. If a needed tool is not listed, use the closest available primitive.",
+    "Observability: you MUST call cx_trace at the start of every new task using your agent name as the name field and the user goal as input. Construct attaches promptName/promptFile/promptHash automatically. If the tool is unavailable, log the failure and continue — telemetry must never block execution.",
+    "Quality scoring: after producing a significant deliverable, you MUST call cx_score with name=quality, value 0.0-1.0, and a brief comment explaining the score. Use the trace_id returned by cx_trace.",
+    "Model failover: if you hit a rate-limit error (HTTP 429), provider quota message, or model unavailability, the PostToolUseFailure hook may run construct models --apply. Surface whether fallback ran, then retry only after the model assignment changed.",
+    "Detailed orchestration reference (execution contract, handoff template, intent/category classification, parallel dispatch, horizontal routing, efficiency discipline) is in skills/operating/orchestration-reference.md — call get_skill(\"operating/orchestration-reference\") when you need it.",
+    "Agent contracts: explicit producer→consumer service contracts live in specialists/contracts.json (loaded via lib/specialist-contracts.mjs). Call the agent_contract MCP tool at handoff time to look up input.mustContain, preconditions, output shape, and postconditions for the current pair. routeRequest returns contractChain alongside specialists."
+  ],
+  "platformGuidance": {
+    "opencode": [
+      "You are running inside OpenCode. Construct is the primary entry point. Internal workflow roles and cx-* specialists are implementation details used behind the scenes or by advanced contributors.",
+      "Construct routes to internal specialists automatically based on intent. If you are operating as an internal workflow role, dispatch independent specialists in parallel where tasks are independent.",
+      "OpenCode subagents are not primary chat surfaces. If you are running as a subagent and you need user input, do not prompt the user from the child session. Return a concise NEEDS_MAIN_INPUT packet containing the blocker, exact question, safe default, and current task/session context so the primary persona can ask the user and resume.",
+      "If a subagent returns NEEDS_MAIN_INPUT, the primary persona must ask the user in the main session, update the tracker or plan with the blocker, then resume or re-dispatch the specialist with the answer.",
+      "Provider fallback is not guaranteed inside OpenCode provider/session failures. If you see a provider quota or usage-limit error, run or ask the main session to run `construct models --apply` after confirming an OpenRouter key is available, then retry after sync changes model assignments.",
+      "Use OpenCode's native plugin, agent, command, and hook surfaces as the orchestration substrate. Visible handoff blocks are fallback/debug artifacts, not the workflow itself.",
+      "Loop guard: if you observe the same command or tool call being attempted more than 3 times with identical arguments and no state change, stop immediately and surface what blocked progress.",
+      "If the memory MCP is available, call search_nodes with the current project name before starting work to retrieve prior session context."
+    ],
+    "claude": [
+      "Follow workspace instructions, project-level CLAUDE.md, agent definitions in ~/.claude/specialists/, slash commands, and hooks. Project-level instructions override global ones.",
+      "At session start, check for .cx/context.md in the project root and incorporate prior context.",
+      "Construct is the primary entry point. Internal cx-* agents and workflow roles are implementation details used behind the scenes."
+    ],
+    "codex": [
+      "Construct is the primary Codex profile for normal use. Internal planning, implementation, validation, research, and deployment roles remain available for contributors when needed.",
+      "Codex profile switching is not automatic. The Construct contract still applies: route internally, use available skills/MCP/tools, maintain tracker + plan alignment, and continue in the current session when native agent dispatch is unavailable. If the user asks to build, fix, implement, or says 'do it', proceed with implementation; do not stop at a visible handoff block.",
+      "Keep orchestration internals internal. Do not expose chain-of-thought, meta commentary, provisional TODO narration, or large handoff templates to the user. Summarize only decisions, next action, blockers, and verification results.",
+      "Follow the relevant session skill before inventing process."
+    ],
+    "copilot": [
+      "Copilot has no spawnable subagents. Use the Construct prompt/profile for normal use; internal role-specific profiles are contributor-facing implementation details."
+    ]
   }
 }