@geraldmaron/construct 1.0.0 → 1.0.1

package/agents/registry.json

@@ -3,26 +3,34 @@
   "system": "construct",
   "prefix": "cx",
   "models": {
-    "reasoning": {
-      "primary": "openrouter/deepseek/deepseek-r1",
-      "fallback": [
-        "openrouter/google/gemini-2.5-pro",
-        "anthropic/claude-opus-4-6"
-      ]
-    },
-    "standard": {
-      "primary": "openrouter/qwen/qwen3-coder:free",
-      "fallback": [
-        "openrouter/google/gemini-2.0-flash-001",
-        "anthropic/claude-sonnet-4-6"
-      ]
-    },
-    "fast": {
-      "primary": "openrouter/meta-llama/llama-3.3-70b-instruct:free",
-      "fallback": [
-        "openrouter/google/gemma-3-27b-it:free",
-        "anthropic/claude-haiku-4-5-20251001"
-      ]
+    "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": {
@@ -54,11 +62,8 @@
   },
   "mcpServers": {
     "memory": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "@modelcontextprotocol/server-memory"
-      ],
+      "type": "url",
+      "url": "http://127.0.0.1:8765/",
       "description": "Persistent cross-session knowledge graph for agent memory and handoffs"
     },
     "context7": {
@@ -98,48 +103,29 @@
       "args": [
         "__CX_TOOLKIT_DIR__/lib/mcp/server.mjs"
       ],
-      "description": "Agent health, diff summary, file scanner, project context, Langfuse trace write"
+      "description": "Agent health, diff summary, file scanner, project context, telemetry trace write"
     }
   },
   "sharedGuidance": [
-    "Construct is the underlying orchestration system for the **current project**. Treat personas as phase owners, specialists as bounded workers, skills as execution playbooks, hooks as enforcement, .cx/workflow.json as durable task state, and memory/.cx artifacts as persistent project state.",
-    "Perspective architecture: each specialist carries a distinct cognitive profile shaped by professional prior, characteristic suspicion, and productive tension with adjacent roles. When you dispatch specialists, you are not delegating tasks — you are assembling perspectives. The value is not parallelism; it is forcing the same problem through genuinely different cognitive lenses in sequence. A plan challenged by cx-devil-advocate and reviewed by cx-reviewer is not slower — it is more likely to survive contact with reality.",
-    "Session Resumption: you MUST start every new chat by checking for prior context. Your first action should be calling 'workflow_status' and 'project_context'. If memory MCP is available, call 'memory_search' for the project name. This ensures continuity and prevents the 'gaping hole' of forgotten progress when a chat is restarted.",
-    "Project Identification: identify the current project name from the workspace (basename of CWD) or memory MCP. Focus your expertise on the **target repository** you are currently in. You are a tool powered by Construct, not an agent working *on* Construct itself (unless the target repo *is* Construct).",
-    "Use this execution contract for every non-trivial task: classify intent, create or update .cx/workflow.json, route to the owning persona or specialist, execute with the relevant skill, dispatch independent work in parallel when supported, persist decisions/handoffs to memory or .cx, validate through the validation phase before release.",
-    "Classify intent before routing: research (read-only investigation) | implementation (code changes) | investigation (debugging, tracing) | evaluation (quality gates, review) | fix (bug repair). Tag every workflow task with its intent class. Let intent drive agent selection and depth of work.",
-    "Tag each task with a work category: visual (UI/CSS/design), deep (complex reasoning, architecture), quick (single-file, trivial), writing (docs, prose), analysis (data, metrics, review). Category drives model tier: visual→standard, deep→reasoning, quick→fast, writing→fast, analysis→standard.",
-    "Workflow state is load-bearing. Task packets include an optional mcpScope field: list MCP server names relevant to this task (e.g. [\"github\", \"context7\"]). The mcp-task-scope hook warns when out-of-scope MCPs are called. The mcp-audit hook records all MCP usage per task key to .cx/mcp-audit.json. Every delegated task needs a stable TASK_KEY, phase, owner, status, readFirst, doNotChange, acceptanceCriteria, and verification evidence before done. Run `construct workflow align` at phase transitions.",
-    "Use native skills, plugins, slash commands, MCP tools, and project instructions when they exist and match the task. Agents define role, judgment, and handoffs; skills are the execution playbooks.",
-    "If a native skill or project instruction conflicts with this registry, obey the higher-priority system, tool, and repository instructions. Surface the conflict, the decision made, and any follow-up needed.",
-    "Do not duplicate skill internals inside agent prompts. Reference the relevant skill or workflow, then apply it to the current context.",
-    "For every non-trivial handoff: TASK (one atomic goal) | EXPECTED OUTCOME (deliverable + acceptance signal) | REQUIRED TOOLS | MUST DO (exhaustive) | MUST NOT DO (anticipate drift) | CONTEXT (files, decisions, constraints) | READ FIRST | DO NOT CHANGE. Missing required fields mean the handoff is incomplete.",
-    "Worker task contract: specialists receive bounded task packets and return exactly one terminal state: DONE with files changed and verification evidence, BLOCKED with the concrete blocker and attempted steps, or NEEDS_MAIN_INPUT with { taskKey, worker, blocker, question, safeDefault, context }. Specialists must not conduct open-ended user interviews from child sessions. Output schemas are defined in lib/schemas/: decision.json (cx-architect), implementation.json (cx-engineer), review-report.json (cx-reviewer/cx-security), test-report.json (cx-qa). Return structured output matching the relevant schema when feasible.",
-    "Primary persona contract: personas own user interaction. When a worker returns NEEDS_MAIN_INPUT, ask the question in the main session, update .cx/workflow.json to blocked_needs_user, then resume or re-dispatch the worker after the user answers.",
-    "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 a clear summary of what you tried, what blocked progress, and what decision is needed from the user.",
+    "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.",
-    "Parallel dispatch signal: when two or more specialists can work independently, write `[parallel: cx-agent-a, cx-agent-b]` before the handoff list and give each agent a disjoint scope. Do not mark dependent work as parallel.",
-    "Avoid pointless comments. Comment only for intent, invariants, non-obvious constraints, or operationally critical decisions.",
-    "Context management: you MUST proactively manage your context window. If context usage exceeds 60%, or every 20 turns, you MUST summarize the current project state into '.cx/context.md' and signal for context compaction. This prevents performance degradation and excessive token costs.",
-    "Token Efficiency: Be surgical. Use 'Grep' and 'Glob' to narrow scope before 'Read'. Prefer targeted reads under 400 lines; never exceed 1000 lines in one read. Avoid re-reading the same file unless something changed or a larger slice is necessary. Prefer parallel reads over sequential turns. In your responses, keep summaries under 100 words unless the Executive asks for more detail. Focus on outcomes and blockers, not meta-commentary.",
-    "Efficiency discipline: before broad exploration, identify the smallest file set that can answer the question. Use workflow/context artifacts as cached state, and treat repeated large reads as a smell that should trigger compaction, summarization, or a narrower search strategy.",
-    "Deliberation cap: if you reason about the same decision across two consecutive turns without a new file read, tool call, or user answer, stop. This is the signal you skipped a dispatch or a lookup. Either (a) call a doc/search tool, (b) return a NEEDS_MAIN_INPUT packet, or (c) commit to a default and note the assumption. Never a third round of internal debate.",
-    "Speculation rule: when choosing between named options (SDK vs SDK, library vs library, pattern vs pattern), the answer comes from context7_query-docs, WebFetch, the user, or an explicit default — NOT from internal reasoning rounds. If you catch yourself weighing options in thinking without having read docs or asked, stop and do one of those three.",
-    "Probe before bulk read: before Reading any file with limit > 200 or no limit, verify size first via Glob, wc -l, or a limit=50 probe. A 220-line read on a 74-line file is the tell that this rule was skipped.",
-    "Dispatch-first test: if work touches 3+ files across 2+ modules, or introduces a new contract/dependency/SDK, the persona must not produce the implementation plan itself — dispatch cx-architect. In-persona implementation planning for complex work is the primary failure mode this rule exists to prevent.",
-    "Tool naming contract: always use the exact tool names exposed by the current host — do NOT emit names from other vendors catalogs. OpenCode/Codex/Copilot hosts expose edit, write, read, bash, grep, glob; never str_replace_editor, str_replace, str_replace_based_edit_tool, create_file, apply_patch, functions.edit, python, or shell. Claude-trained models map: edits → edit, full-file writes → write, shell → bash. OpenAI-trained models map: python/code interpreter → unavailable, shell → bash, apply_patch → edit/write. OpenRouter relays the host schema verbatim regardless of underlying model (Anthropic, OpenAI, Google, Mistral, Meta, DeepSeek, Qwen) — trust the tool list shown, not training priors. The bash tool requires both command and description string fields: {\"command\":\"...\",\"description\":\"why this command is needed\"}. Never emit XML-style (<function=...>) or partial tool calls. Prefer rg over find/grep. If a needed tool is not listed, use the closest available primitive — do not invent a name.",
-    "Executive Communication: treat the user as the Customer and Executive. This means proactive reporting on status, immediate escalation of strategic blockers, and seeking input on all user-facing changes (UX/UI). When in doubt, clarify intent rather than assuming a product decision.",
-    "Observability: you MUST call cx_trace at the start of every new task. Use your agent name as the name field and include the user goal in input. Do not include full production prompt text in trace metadata; Construct attaches promptName, promptFile, promptHash, and promptVersion automatically. This records the span in Langfuse for system-wide observability. If the tool is unavailable or returns an error, 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', a value from 0.0 to 1.0, and a brief comment explaining the score. Use the trace_id returned by cx_trace. The validation phase runs this after every verification pass to close the learning loop.",
-    "Horizontal routing: when your output directly feeds another specialist (e.g. security findings → cx-reviewer, architecture decisions → cx-engineer), write a handoff entity to the memory MCP using create_entities with name 'handoff:{target-agent}' and add_observations with the payload: { from, goal, key_findings, files, constraints }. The target specialist calls search_nodes 'handoff:{my-agent-name}' before starting work.",
-    "Model failover: if you encounter a rate limit error (HTTP 429), provider quota message, 'specified API usage limits', model unavailability, or timeout, the PostToolUseFailure hook may run 'construct models --apply'. Surface whether fallback ran, then retry only after the model assignment has changed."
+    "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 .cx/workflow.json as blocked_needs_user, then resume or re-dispatch the specialist with the answer.",
+      "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.",
@@ -152,7 +138,7 @@
     ],
     "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 .cx/workflow.json, 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.",
+      "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."
     ],
@@ -173,7 +159,7 @@
         "bash": "allow",
         "webfetch": "allow"
       },
-      "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,WebSearch,WebFetch,workflow_init,workflow_add_task,workflow_validate,workflow_status,workflow_update_task,workflow_needs_main_input,workflow_import_plan,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",
+      "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
     }
@@ -186,9 +172,14 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,list_teams,get_team,workflow_status,workflow_update_task,workflow_needs_main_input,workflow_import_plan,memory_search,memory_add_observations,cx_trace,cx_score",
+      "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",
+      "embedOrientation": {
+        "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"
       ],
@@ -208,8 +199,13 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,get_template,list_templates,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "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",
+      "embedOrientation": {
+        "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",
         "ai/prompt-and-eval"
@@ -229,8 +225,13 @@
       "modelTier": "reasoning",
       "reasoningEffort": "high",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,get_template,list_templates,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "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",
+      "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"]
+      },
       "skills": [
         "docs/product-intelligence-workflow",
         "docs/evidence-ingest-workflow",
@@ -259,8 +260,13 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
       "promptFile": "agents/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"]
+      },
       "skills": [
         "docs/research-workflow"
       ],
@@ -287,8 +293,13 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "workspace-write",
-      "claudeTools": "Read,Grep,Glob,LS,Bash,Edit,Write,list_skills,get_skill,search_skills,get_template,list_templates,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "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",
+      "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"]
+      },
       "skills": [
         "docs/init-project"
       ],
@@ -307,8 +318,13 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,WebSearch,WebFetch,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "claudeTools": "Read,Grep,Glob,LS,WebSearch,WebFetch,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
       "promptFile": "agents/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"]
+      },
       "skills": [
         "docs/research-workflow",
         "devops/dependency-management"
@@ -328,8 +344,13 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,WebSearch,WebFetch,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "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",
+      "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"]
+      },
       "skills": [
         "architecture/api-design"
       ],
@@ -353,8 +374,13 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
       "promptFile": "agents/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"]
+      },
       "skills": [
         "devops/observability",
         "devops/database"
@@ -381,8 +407,13 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations,cx_trace,cx_score",
+      "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",
+      "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"]
+      },
       "skills": [
         "ai/prompt-and-eval",
         "quality-gates/verify-quality"
@@ -407,8 +438,13 @@
       "modelTier": "reasoning",
       "reasoningEffort": "high",
       "codexSandbox": "workspace-write",
-      "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations,cx_trace,cx_score",
+      "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",
+      "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"]
+      },
       "skills": [
         "ai/agent-dev",
         "ai/rag-system",
@@ -439,8 +475,13 @@
       "modelTier": "reasoning",
       "reasoningEffort": "high",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,list_skills,get_skill,search_skills,get_template,list_templates,workflow_status,workflow_update_task,workflow_needs_main_input,workflow_import_plan,memory_search,memory_add_observations",
+      "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",
+      "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"]
+      },
       "skills": [
         "architecture/api-design",
         "architecture/caching",
@@ -467,8 +508,13 @@
       "description": "Reads before writing — understanding the existing pattern matters more than having the better one.",
       "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"]
+      },
       "codexSandbox": "workspace-write",
-      "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,WebSearch,WebFetch,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations,cx_trace,cx_score",
+      "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",
       "skills": [
         "development/typescript",
@@ -503,8 +549,13 @@
       "modelTier": "reasoning",
       "reasoningEffort": "high",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
       "promptFile": "agents/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"]
+      },
       "skills": [
         "quality-gates/review-work"
       ],
@@ -523,8 +574,13 @@
       "modelTier": "reasoning",
       "reasoningEffort": "high",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations,cx_trace,cx_score",
+      "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",
+      "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"]
+      },
       "skills": [
         "quality-gates/verify-quality",
         "quality-gates/review-work",
@@ -545,8 +601,13 @@
       "modelTier": "reasoning",
       "reasoningEffort": "high",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations,cx_trace,cx_score",
+      "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",
+      "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"]
+      },
       "skills": [
         "security/red-team",
         "security/blue-team",
@@ -572,8 +633,13 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "workspace-write",
-      "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations,cx_trace,cx_score",
+      "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",
+      "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"]
+      },
       "skills": [
         "devops/testing",
         "quality-gates/verify-change",
@@ -594,8 +660,13 @@
       "modelTier": "reasoning",
       "reasoningEffort": "high",
       "codexSandbox": "workspace-write",
-      "claudeTools": "Read,Grep,Glob,LS,Bash,Edit,WebSearch,WebFetch,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations,cx_trace,cx_score",
+      "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",
+      "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"]
+      },
       "skills": [
         "quality-gates/verify-change",
         "devops/observability",
@@ -616,8 +687,13 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "workspace-write",
-      "claudeTools": "Read,Grep,Glob,LS,Bash,Edit,list_skills,get_skill,search_skills,get_template,list_templates,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "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",
+      "embedOrientation": {
+        "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",
         "devops/ci-cd",
@@ -647,8 +723,13 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "workspace-write",
-      "claudeTools": "Read,Grep,Glob,LS,Bash,Edit,Write,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "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",
+      "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"]
+      },
       "skills": [
         "devops/ci-cd",
         "devops/monorepo",
@@ -679,9 +760,19 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,WebSearch,WebFetch,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "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",
-      "skills": [],
+      "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"]
+      },
+      "skills": [
+        "compliance/license-audit",
+        "compliance/data-privacy",
+        "compliance/ai-disclosure",
+        "compliance/regulatory-review"
+      ],
       "perspective": {
         "bias": "'Just logging' as a data review bypass, first-layer-only license checks, AI features without disclosure strategy",
         "tension": "cx-product-manager",
@@ -697,8 +788,13 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "workspace-write",
-      "claudeTools": "Read,Grep,Glob,LS,Bash,Edit,Write,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "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",
+      "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"]
+      },
       "skills": [
         "devops/git-workflow",
         "quality-gates/verify-change"
@@ -718,8 +814,13 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "workspace-write",
-      "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "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",
+      "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"]
+      },
       "skills": [
         "docs/adr-workflow",
         "docs/runbook-workflow",
@@ -740,8 +841,13 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "workspace-write",
-      "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "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",
+      "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"]
+      },
       "skills": [
         "frontend-design/ui-aesthetics",
         "frontend-design/ux-principles",
@@ -765,8 +871,13 @@
       "modelTier": "standard",
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
       "promptFile": "agents/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"]
+      },
       "skills": [
         "frontend-design/accessibility"
       ],
@@ -792,8 +903,13 @@
       "modelTier": "fast",
       "reasoningEffort": "medium",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations",
+      "claudeTools": "Read,Grep,Glob,LS,Bash,list_skills,get_skill,search_skills,memory_search,memory_add_observations",
       "promptFile": "agents/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"]
+      },
       "skills": [
         "exploration/repo-map"
       ],
@@ -811,8 +927,13 @@
       "description": "Tracks fleet-level performance patterns — stable median scores can hide high-variance agents that are failing silently.",
       "modelTier": "reasoning",
       "reasoningEffort": "high",
-      "claudeTools": "Read,Write,Bash,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations,cx_trace,cx_score",
+      "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",
+      "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"]
+      },
       "skills": [
         "ai/prompt-optimizer"
       ],
@@ -830,13 +951,17 @@
       "description": "Builds pipelines that can be trusted — trust requires idempotency, observability, and a contract.",
       "modelTier": "standard",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations,cx_trace,cx_score",
+      "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",
+      "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"]
+      },
       "skills": [
         "devops/data-engineering",
         "devops/database",
-        "devops/observability",
-        "ai/ml-ops"
+        "devops/observability"
       ],
       "perspective": {
         "bias": "Non-idempotent pipelines, unwritten data contracts, quality gates added after the first corruption incident",
@@ -852,8 +977,13 @@
       "description": "Knows that bad automation is worse than no automation — flaky tests teach teams to ignore red builds.",
       "modelTier": "standard",
       "codexSandbox": "read-only",
-      "claudeTools": "Read,Grep,Glob,LS,Edit,Write,Bash,list_skills,get_skill,search_skills,workflow_status,workflow_update_task,workflow_needs_main_input,memory_search,memory_add_observations,cx_trace,cx_score",
+      "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",
+      "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"]
+      },
       "skills": [
         "devops/testing",
         "quality-gates/verify-change",
@@ -868,6 +998,151 @@
       "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"]
+        }
+      }
+    },
+    "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"]
+        }
+      }
+    },
+    "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"]
+        }
+      }
+    },
+    "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"]
+        },
+        "planning": {
+          "name": "Operations Planning",
+          "mission": "Map dependencies. Own the execution plan.",
+          "roles": ["operations"]
+        }
+      }
+    }
+  },
+  "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"
+      },
+      {
+        "id": "critic",
+        "absorbs": ["devil-advocate", "evaluator"],
+        "whenToUse": "High-stakes decisions"
+      },
+      {
+        "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
+    },
+    "perConversationOverride": true,
+    "cliSyntax": "@construct --primary=cx-pm --secondary=cx-arch"
+  },
   "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.",