0xray 3.3.1 → 3.4.2

package/.xray/features.json

@@ -0,0 +1,146 @@
+{
+  "$schema": "./features.schema.json",
+  "description": "0xRay Framework - Unified Feature Configuration",
+  "token_optimization": {
+    "enabled": true,
+    "max_context_tokens": 20000,
+    "prune_after_task": true,
+    "summarize_tool_outputs": true,
+    "context_compression": {
+      "enabled": true,
+      "threshold_tokens": 15000,
+      "compression_ratio": 0.4
+    }
+  },
+  "model_routing": {
+    "enabled": true
+  },
+  "batch_operations": {
+    "enabled": true,
+    "prefer_sed_for_replacements": true,
+    "parallel_file_updates": true,
+    "max_concurrent_edits": 10,
+    "auto_batch_threshold": 5
+  },
+  "multi_agent_orchestration": {
+    "enabled": true,
+    "coordination_model": "async-multi-agent",
+    "max_concurrent_agents": 3,
+    "task_distribution_strategy": "capability-based",
+    "conflict_resolution": "expert-priority",
+    "progress_tracking": true,
+    "session_persistence": true,
+    "lead_dev_mode": true,
+    "per_suite_test_triage": true,
+    "phased_plan_threshold": 25,
+    "auto_consult_major_work": true,
+    "no_new_surface": true
+  },
+  "autonomous_reporting": {
+    "enabled": true,
+    "interval_minutes": 60,
+    "auto_schedule": true,
+    "include_health_assessment": true,
+    "include_agent_activities": true,
+    "include_pipeline_operations": true,
+    "include_critical_issues": true,
+    "include_recommendations": true,
+    "report_retention_days": 30,
+    "notification_channels": [
+      "console"
+    ]
+  },
+  "agent_management": {
+    "disabled_agents": [],
+    "agent_models": {},
+    "performance_limits": {
+      "max_task_duration_ms": 30000,
+      "max_memory_usage_mb": 512,
+      "max_tokens_per_request": 16000
+    }
+  },
+  "refactoring": {
+    "enabled": true,
+    "automatic_detection": true,
+    "require_user_approval": false,
+    "max_complexity_threshold": 80,
+    "safe_mode": true,
+    "batch_mode": true
+  },
+  "activity_logging": {
+    "enabled": true,
+    "level": "info",
+    "include_performance_metrics": true,
+    "include_agent_states": false,
+    "include_token_usage": true,
+    "retention_days": 3,
+    "log_to_file": true,
+    "log_path": ".opencode/logs"
+  },
+  "security": {
+    "enabled": true,
+    "prompt_sanitization": true,
+    "vulnerability_scanning": true,
+    "code_review_enforcement": true,
+    "security_score_threshold": 70
+  },
+  "performance_monitoring": {
+    "enabled": true,
+    "real_time_metrics": true,
+    "benchmark_tracking": true,
+    "token_tracking": true,
+    "cost_tracking": true,
+    "alerting": {
+      "enabled": true,
+      "performance_degradation_threshold": 20,
+      "error_rate_threshold": 5,
+      "cost_threshold_daily": 10
+    }
+  },
+  "caching": {
+    "enabled": true,
+    "file_content_cache": true,
+    "search_result_cache": true,
+    "cache_ttl_seconds": 60,
+    "max_cache_size_mb": 25
+  },
+  "agent_spawn": {
+    "max_concurrent": 8,
+    "max_per_type": 3,
+    "spawn_cooldown_ms": 500,
+    "rate_limit_per_minute": 20
+  },
+  "delegation": {
+    "confidence_threshold": 0.5,
+    "enable_intelligent_routing": true
+  },
+  "complexity_thresholds": {
+    "simple": 15,
+    "moderate": 25,
+    "complex": 50,
+    "enterprise": 100
+  },
+  "analytics": {
+    "enabled": true,
+    "default_limit": 500,
+    "min_samples_for_calibration": 3,
+    "track_complexity_accuracy": true,
+    "track_agent_performance": true
+  },
+  "pattern_learning": {
+    "enabled": true,
+    "learning_interval_ms": 300000,
+    "auto_apply_threshold": 0.9,
+    "min_success_rate": 0.7
+  },
+  "memory_routing": {
+    "enabled": true,
+    "provider": "repertoire",
+    "module_path": "../repertoire/dist/provider/memory-routing-provider.js",
+    "config": {
+      "dataDir": "../repertoire/data",
+      "signalsPath": "../repertoire/data/curated_signals.json",
+      "logDir": "../repertoire/logs/groover-inference"
+    }
+  }
+}

package/.xray/features.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://0xray.ai/schemas/features.schema.json",
+  "title": "0xRay Features Configuration",
+  "type": "object",
+  "properties": {
+    "version": { "type": "string" },
+    "description": { "type": "string" },
+    "memory_routing": {
+      "type": "object",
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "provider": {
+          "type": "string",
+          "enum": ["null", "repertoire", "custom"]
+        },
+        "module_path": { "type": "string" },
+        "config": { "type": "object" }
+      },
+      "required": ["enabled", "provider"],
+      "if": {
+        "properties": {
+          "enabled": { "const": true },
+          "provider": { "enum": ["repertoire", "custom"] }
+        }
+      },
+      "then": {
+        "required": ["module_path"]
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/AGENTS-consumer.md

@@ -1,31 +1,59 @@
 # 0xRay AI Agents
 
-Quick reference for the 0xRay AI orchestration framework (v16 MCPs-centric three-subsystem).
+Quick reference for the 0xRay AI orchestration framework (shipped to your project on `npm install 0xray`).
+
+**v3.4.2** — 7 MCP servers · 45 skills · 68 codex terms · 4 platform bridges
+
+## Postinstall (automatic)
+
+`npm install 0xray` runs `install-bridges.cjs` and:
+
+- Copies this file → **`AGENTS.md`** in your project root
+- Ships root **`SKILLS.md`** and syncs **45 skills** to platform skill directories
+- Seeds **`.gitignore`** (from template, if absent)
+- Deploys **`.xray/`** (`codex.json`, `features.json`, `config.json`)
+- Writes **`.mcp.json`** with 7 MCPs servers (`npx -y 0xray mcp …`)
+- Installs bridges: **OpenCode**, **Grok**, **Hermes**, **OpenClaw**
+
+Optional extras: `npx 0xray setup`
 
 ## Available MCP Servers
 
+All seven servers use `npx -y 0xray mcp <cmd>` — configured in your project `.mcp.json`:
+
 | Server | Role |
 |--------|------|
 | `xray-governance` | Proposal governance, codex snapshot, quality gates |
-| `xray-skills` | Skill invocation, agent-specific knowledge servers |
+| `xray-skills` | Skill invocation, 45 knowledge skills |
+| `xray-orchestrator` | thinDispatch routing, AsideContext, confidence gate |
 | `xray-enforcer` | Codex compliance enforcement, rule validation |
-| `xray-orchestrator` | Multi-agent workflow coordination, task delegation |
+| `xray-researcher` | Codebase exploration, memory-routing enrichment |
+| `xray-code-review` | Proposal quality, code review deliberation |
+| `xray-architect-tools` | System design, architecture decisions |
+
+Governance deliberation uses **code-review**, **security-audit** (via enforcer/skills), and **researcher** within this 7-server surface.
 
 ## CLI Commands
 
 | Command | Description |
 |---------|-------------|
-| `xray setup` | Full framework setup (hooks, Hermes, symlinks) |
-| `xray validate` | Validate codex compliance |
-| `xray codex check` | Check codex rules |
-| `xray health` | Framework health check |
-| `xray hooks` | Manage lifecycle hooks |
+| `npx 0xray setup` | Symlinks, hook extras, Hermes skill sync |
+| `npx 0xray status` | Verify installation |
+| `npx 0xray opencode install` | OpenCode bridge (also runs on postinstall) |
+| `npx 0xray grok install` | Grok plugin + 7 MCPs servers + skill sync |
+| `npx 0xray hermes install` | Hermes plugin bridge |
+| `npx 0xray openclaw install` | OpenClaw config + skills |
+| `npx 0xray skill:install` | Install starter skills |
+| `npx 0xray validate` | Validate codex compliance |
+| `npx 0xray codex check` | Check codex rules |
+| `npx 0xray health` | Framework health check |
+| `npx 0xray mcp <server>` | Start an MCP server (stdio) |
 
 ## Governance
 
-xray operates under the three-subsystem model: Inference + External Governance (Dynamo Solar SSOT) + Autonomous Engine (thinDispatch 7-flow in MCP orchestrator). All actions are validated against the Universal Development Codex before execution.
+xray operates under the three-subsystem model: **Inference** + **External Governance** (Dynamo Solar SSOT) + **Autonomous Engine** (thinDispatch 7-flow in MCP orchestrator). All actions are validated against the Universal Development Codex before execution.
 
-**Codex**: The codex lives in `.xray/codex.json` and enforces 60 terms across all agent interactions.
+**Codex**: `.xray/codex.json` — **68 terms** across all agent interactions.
 
 ## thinDispatch Routing
 
@@ -34,6 +62,83 @@ xray operates under the three-subsystem model: Inference + External Governance (
 - Complex (≤50): Multi-agent coordination
 - Enterprise (>50): Orchestrator-led team
 
+## AsideContext (v3.2+)
+
+Bounded orchestrator subcontexts via `xray-orchestrator` MCP — `spawnAside` / `closeAside` on multi-step tasks. Repertoire memory routing (when enabled) flows through `inheritedContext.memoryRouting`.
+
+## Memory Routing + Repertoire (optional, v3.3+)
+
+Configure in `.xray/features.json`:
+
+```json
+"memory_routing": {
+  "enabled": true,
+  "provider": "repertoire",
+  "module_path": "../repertoire/dist/provider/memory-routing-provider.js",
+  "config": {
+    "signalsPath": "../repertoire/data/curated_signals.json"
+  }
+}
+```
+
+Without Repertoire: `{ "enabled": false, "provider": "null" }`.
+
+**External MCP** (Hermes/Grok): add Repertoire alongside 0xRay servers:
+
+```json
+"repertoire": {
+  "command": "npx",
+  "args": ["-y", "@0xray/repertoire", "mcp"]
+}
+```
+
+Tools: `repertoire__get_task_confidence`, `repertoire__get_high_confidence_signals`, `repertoire__search_primitives`, `repertoire__ingest_feedback`.
+
+## Codex OS (always on — not optional)
+
+The Universal Development Codex (`.xray/codex.json`, **69 terms**) is enforced by **PreToolUse** (blocks) and this section (brain). MCP enforcer is audit — not the gate.
+
+| Term | Rule | Enforcement |
+|------|------|-------------|
+| 11 | No `any`, `@ts-ignore`, `@ts-expect-error` | PreToolUse deny on edits |
+| 29 | Security by design — no `eval()` | PreToolUse deny |
+| 59 | Complex work → orchestrator intake | PreToolUse deny `spawn_subagent` without plan |
+| 67–68 | Best subagents + lead dev ownership | `analyze-complexity` + orchestrator skill |
+| **69** | **No new MCP/skill/handler surface** | PreToolUse deny new `*.server.ts`, `SKILL.md` |
+
+`features.json` → `multi_agent_orchestration.no_new_surface` (default **true**). Rewire existing hooks/MCPs/skills — do not add parallel APIs.
+
+## Default operating mode: lead dev (rewired — no new MCP)
+
+When the suit is worn, **lead dev mode** is ON via existing config + hooks:
+
+| Layer | Existing piece | Rewire |
+|-------|----------------|--------|
+| Config | `features.json` → `multi_agent_orchestration.lead_dev_mode` | Extended, not new block |
+| SessionStart + UserPromptSubmit | Grok hooks → `session-start.js` | Writes `.xray/state/session-boot.json` + `logs/framework/activity.log` |
+| **OS gate** | **PreToolUse hook** | Codex patterns, surface area, spawn gate — `{"decision":"deny"}` + activity.log |
+| Intake + plan | `xray-orchestrator` → **`analyze-complexity`** | Persists `.xray/state/lead-dev-plan.json` |
+| Test triage | PreToolUse hook | Per-suite hint on full `npm test` |
+| Playbook | **`orchestrator`** skill | Codex 59, 67–69 rules |
+
+**First substantive task:** `analyze-complexity` with `tasks` array — **required before** `spawn_subagent`. You are the **lead developer**. Users speak in goals, not keywords.
+
+| # | Rule |
+|---|------|
+| 1 | Phased plan + detailed todos; assign best subagent; monitor output |
+| 2 | Take the helm — loop test fix until complete; no permission pings |
+| 3 | Per-suite test triage after major changes; full suite last |
+| 4 | Lead stays main thread; subagents execute; update todos continuously |
+| 5 | Read all console and test output; triage fix rerun |
+| 6 | Never defer errors as "pre-existing" — add todo and resolve |
+| 7 | Resolve all errors before phase completion |
+
+**Major work:** invoke `researcher` + `architect-tools` + `code-review` before planning/refactors — automatically.
+
+## Skills
+
+Full catalog in root **`SKILLS.md`** (shipped on postinstall). **`orchestrator`** skill documents lead-dev mode. Invoke via `@orchestrator` or `xray-skills` MCP (`invoke-skill`, `list-skills`).
+
 ## File Organization
 
 | File Type | Save To |
@@ -44,3 +149,15 @@ xray operates under the three-subsystem model: Inference + External Governance (
 | Test Files | `src/__tests__/` |
 | Source Code | `src/` |
 | Config | `config/` or `.xray/` |
+
+## Documentation
+
+| Topic | URL |
+|-------|-----|
+| Getting started | https://0xrayai.github.io/xray/docs/guides/getting-started |
+| Platform integrations | https://0xrayai.github.io/xray/docs/guides/integrations |
+| Features since 3.1 | https://0xrayai.github.io/xray/docs/guides/features-since-3.1 |
+| AsideContext | https://0xrayai.github.io/xray/docs/guides/aside-context |
+| Memory routing | https://0xrayai.github.io/xray/docs/guides/memory-routing |
+| Repertoire | https://0xrayai.github.io/xray/docs/guides/repertoire |
+| Autonomy command | https://0xrayai.github.io/xray/docs/guides/autonomy-command |

package/AGENTS.md

@@ -1,87 +1,203 @@
 # xray Agents
 
-Quick reference for xray AI orchestration framework (v16 MCPs-centric three-subsystem).
+Quick reference for the xray AI orchestration framework (**v3.4.2**).
+
+**42 agents** · **45 skills** · **7 consumer MCP servers** · **68 codex terms** · **3,226 tests**
 
 ## What is xray?
 
-xray provides intelligent multi-agent orchestration with automatic delegation and Codex compliance validation under the pure v2 three-subsystem model (Inference + External Governance via Dynamo + Autonomous Engine via thinDispatch 7-flow in MCP orchestrator). Agents operate via `.opencode/agents/*.yml` YML surfaces and 3 dedicated MCP skill servers — no manual setup needed.
+xray provides intelligent multi-agent orchestration with automatic delegation and Codex compliance validation under the pure v2 three-subsystem model:
 
-## v16 MCPs-Centric Architecture
+- **Inference** — proposals, reflection, memory routing (optional)
+- **External Governance** — Dynamo Solar SSOT, 68-term Codex
+- **Autonomous Engine** — thinDispatch 7-flow, AsideContext, confidence gate
 
-The v2 release centers on **MCP (Model Context Protocol)** as the primary surface for agent skills. Three agent MCP servers handle governance deliberation:
+Agents are declared in `src/opencode/agents/*.yml` — the YML SSOT. Skills live in `src/skills/*/SKILL.md` — see [SKILLS.md](SKILLS.md). Consumer projects receive slimmed copies via postinstall (`AGENTS-consumer.md` → `AGENTS.md`, skills synced to platform dirs).
 
-- `code-review` — Proposal quality, code analysis, best practices
-- `security-audit` — Vulnerability detection, threat modeling
-- `researcher` — Codebase exploration, pattern discovery, implementation lookup
+## Consumer MCP surface (7 servers)
 
-These MCP servers integrate with the three-subsystem pipeline for governance-gated execution.
+Registered in `.mcp.json`, invoked via `npx -y 0xray mcp <cmd>`:
 
-## xray Three-Subsystem Operation
+| Server | Role |
+|--------|------|
+| `xray-governance` | Proposal governance, codex snapshot, quality gates |
+| `xray-skills` | 45 knowledge skills + `invoke-skill` |
+| `xray-orchestrator` | thinDispatch, AsideContext, confidence gate |
+| `xray-enforcer` | Codex compliance, rule validation |
+| `xray-researcher` | Codebase exploration, memory-routing enrichment |
+| `xray-code-review` | Proposal quality, code review deliberation |
+| `xray-architect-tools` | System design, architecture decisions |
 
-xray operates under the pure three-subsystem model: Inference + External Governance (Dynamo Solar SSOT) + Autonomous Engine (thinDispatch 7-flow in MCP orchestrator). Agents are declared in `.opencode/agents/*.yml` YML surfaces with zero manual setup.
+Governance deliberation: **code-review**, **security-audit**, **researcher** within the 7-server set.
 
-### Core Tenets
-- YML declarations are the SSOT
-- Zero manual setup or registration
-- Governance precedes action via Dynamo
-- Automatic delegation via thinDispatch
-- MCP surfaces are the primary skill interface
-- fwLogger / frameworkLogger structured logging ONLY (never console.*) to logs/framework/activity.log + .opencode/logs/
+## Postinstall (v3.4.1)
 
-### File Organization Guidelines
+`postinstall.cjs` → `installAllBridges()`:
 
-**IMPORTANT**: Save all generated files to their proper directories. Do NOT save to root.
+1. `AGENTS-consumer.md` → `AGENTS.md`
+2. `SKILLS.md` + 46 skills → platform skill directories
+3. `.gitignore.default` → `.gitignore` (if absent)
+4. `.xray/` config (`codex.json`, `features.json`, `config.json`)
+5. `.mcp.json` (7 servers)
+6. Four bridges: OpenCode, Grok, Hermes, OpenClaw
+7. Optional git hooks
 
-| File Type | Save To | Example |
-|-----------|---------|---------|
-| **Reflections** | `docs/reflections/` | `docs/reflections/my-fix-reflection.md` |
-| **Logs** | `logs/` | `logs/framework/activity.log` |
-| **Scripts** | `scripts/` or `scripts/bash/` | `scripts/bash/my-script.sh` |
-| **Test Files** | `src/__tests__/` | `src/__tests__/unit/my-test.test.ts` |
-| **Source Code** | `src/` | `src/my-module.ts` |
-| **Config** | `config/` or `.xray/` | `.xray/config.json` |
+## Memory routing + Repertoire (v3.3+)
 
-**Never save to root** - Root directory is for essential files only:
-- `README.md`, `CHANGELOG.md`, `package.json`, `tsconfig.json`
+`xray/features.json` → `memory_routing` (schema: `features.schema.json`):
 
-## Available Agents
+```json
+"memory_routing": {
+  "enabled": true,
+  "provider": "repertoire",
+  "module_path": "../repertoire/dist/provider/memory-routing-provider.js",
+  "config": {
+    "dataDir": "../repertoire/data",
+    "signalsPath": "../repertoire/data/curated_signals.json",
+    "logDir": "../repertoire/logs/groover-inference"
+  }
+}
+```
 
-| Agent | Purpose | Invoke |
-|-------|---------|--------|
-| `@enforcer` | Codex compliance & error prevention | `@enforcer analyze this code` |
-| `@orchestrator` | Complex multi-step task coordination | `@orchestrator implement feature` |
-| `@architect` | System design & technical decisions | `@architect design API` |
-| `@security-auditor` | Vulnerability detection | `@security-auditor scan` |
-| `@code-reviewer` | Quality assessment | `@code-reviewer review PR` |
-| `@refactorer` | Technical debt elimination | `@refactorer optimize code` |
-| `@testing-lead` | Testing strategy | `@testing-lead plan tests` |
-| `@bug-triage-specialist` | Error investigation | `@bug-triage-specialist debug error` |
-| `@researcher` | Codebase exploration | `@researcher find implementation` |
+| Integration | Surface |
+|-------------|---------|
+| ExecutionPlanner | `enrichTasks`, `getTaskConfidence`, `selectAgent` |
+| thinDispatch | `resolveThinDispatch` |
+| Researcher | `researcher-confidence.ts`, `MEMORY_ROUTING:` block |
+| AsideContext | `buildInheritedContext` → `inheritedContext.memoryRouting` |
+| Feedback | Per-task `ingestFeedback` |
 
-## MCP Skill Servers
+**External MCP:** `npx @0xray/repertoire mcp` — `repertoire__get_task_confidence`, etc.
 
-xray ships dedicated MCP servers that provide agent skills:
+## AsideContext (v3.2+)
 
-| Server | Role |
-|--------|------|
-| `code-review` | Proposal quality analysis, code review |
-| `security-audit` | Vulnerability scanning, threat assessment |
-| `researcher` | Codebase exploration, implementation lookup |
-| `orchestrator` | thinDispatch 7-flow delegation routing |
-| `enforcer-tools` | Codex compliance enforcement |
-| `governance` | Proposal governance, codex snapshot |
+`src/mcps/orchestrator/aside-context.ts` — bounded subcontexts for orchestration:
+
+- `spawnAside` / `closeAside` on `orchestrate-task`, `analyze-complexity`, `govern-and-apply`
+- Observation extractors: governance, orchestration, complexity
+- Repertoire context flows via `ExecutionPlan.memoryContext`
+
+## Confidence gate (v3.3.1)
+
+`ExecutionPlanner.calculateTaskComplexity()` + `getTaskConfidence()` — complexity boost and ontological-trap routing.
+
+## Nucleus exports (v3.4.0)
 
-## thinDispatch Routing
+`0xray/nucleus` and `0xray/nucleus/*` — `handleGovernRequest`, plugin-registry, thinDispatch.
 
-The Autonomous Engine routes via complexity:
+## Changes since 3.1
+
+| Version | Change |
+|---------|--------|
+| **3.4.1** | `install-bridges.cjs`, 7 MCPs `npx`, release pipeline + docs sync |
+| **3.4.0** | Nucleus exports, governance closure, verify gate |
+| **3.3.1** | Confidence gate, repertoire researcher wiring |
+| **3.3.0** | Memory routing + Repertoire provider |
+| **3.2.0** | AsideContext wired, SelfProposalEngine, pre-tool-use hook |
+| **3.1.1** | 0xRay rename, marketplace, AGENTS/SKILLS consumer seeding |
+
+**Removed:** `hermes bridge`, `.opencode/xray/` fallback, `advanced-features/` on consumer boot.
+
+## Default operating mode: autonomy-command
+
+When the suit is worn, **autonomy-command** is ON by default (codex 67–68). Lead dev: phased todos, subagent dispatch, per-suite test triage, loop until green. Ships to consumers via `AGENTS-consumer.md`.
+
+Docs: [guides/autonomy-command](docs-site/docs/guides/autonomy-command.md) · Skill: `src/skills/autonomy-command/SKILL.md`
+
+## Core tenets
+
+- YML agents + SKILL.md are the SSOT
+- Zero manual registration
+- Governance precedes action (Dynamo)
+- MCP surfaces are the primary skill interface
+- frameworkLogger only (never `console.*`)
+
+## File organization
+
+| File Type | Save To |
+|-----------|---------|
+| Reflections | `docs/reflections/` |
+| Logs | `logs/` |
+| Scripts | `scripts/` or `scripts/bash/` |
+| Tests | `src/__tests__/` |
+| Source | `src/` |
+| Config | `.xray/` or `config/` |
+
+**Root essentials only:** `README.md`, `CHANGELOG.md`, `package.json`, `AGENTS.md`, `SKILLS.md`, `tsconfig.json`.
+
+## Available agents (42 YML surfaces)
+
+Invoke via `@agent-name` in OpenCode:
+
+| Agent | Purpose |
+|-------|---------|
+| `@enforcer` | Codex compliance & error prevention |
+| `@orchestrator` | Multi-step task coordination |
+| `@architect` | System design & technical decisions |
+| `@security-auditor` | Vulnerability detection |
+| `@code-reviewer` | Quality assessment |
+| `@refactorer` | Technical debt elimination |
+| `@testing-lead` | Testing strategy |
+| `@bug-triage-specialist` | Error investigation |
+| `@researcher` | Codebase exploration |
+| `@frontend-engineer` | React, Vue, Angular, responsive design |
+| `@backend-engineer` | REST/GraphQL APIs, microservices |
+| `@database-engineer` | Schema design, query optimization |
+| `@devops-engineer` | CI/CD, infrastructure, containers |
+| `@mobile-developer` | iOS, Android, React Native, Flutter |
+| `@storyteller` | Narrative reflections, technical stories |
+| `@strategist` | Architecture decisions, risk analysis |
+| `@performance-engineer` | Profiling, benchmarking |
+| `@frontend-ui-ux-engineer` | Visual design, accessibility |
+| `@multimodal-looker` | Media / screenshot analysis |
+| `@log-monitor` | Log diagnostics |
+| `@code-analyzer` | Code metrics, pattern detection |
+| `@content-creator` | SEO copy, technical content |
+| `@growth-strategist` | Marketing strategy |
+| `@seo-consultant` | Technical SEO |
+| `@tech-writer` | API docs, READMEs, changelogs |
+| `@hermes-agent` | Hermes bridge operations |
+| `@boot-orchestrator` | Framework boot orchestration |
+| `@processor-pipeline` | Data processing pipelines |
+| `@state-manager` | Session / state persistence |
+| `@session-management` | Session lifecycle |
+| `@inference-improve` | Autonomous inference improvement |
+| `@model-health-check` | Model health diagnostics |
+| `@framework-compliance-audit` | Framework compliance |
+| `@lint` | Code linting |
+| `@auto-format` | Automated formatting |
+| `@git-workflow` | Git workflow management |
+| `@api-design` | REST/GraphQL API design |
+| `@architecture-patterns` | Architecture patterns |
+| `@performance-analysis` | Performance analysis |
+| `@performance-optimization` | Performance optimization |
+| `@project-analysis` | Project health metrics |
+| `@security-scan` | Security vulnerability scanning |
+| `@testing-best-practices` | Testing QA |
+| `@ui-ux-design` | UI/UX design |
+
+Full skill mapping: [SKILLS.md](SKILLS.md).
+
+## thinDispatch routing
 
 - Simple (≤15): Single agent
 - Moderate (≤25): Single agent with tools
 - Complex (≤50): Multi-agent coordination
 - Enterprise (>50): Orchestrator-led team
 
-## Codex
+## Documentation
+
+| Topic | Path |
+|-------|------|
+| Features since 3.1 | `docs-site/docs/guides/features-since-3.1.md` |
+| features.json | `docs-site/docs/guides/features-json.md` |
+| Platform integrations | `docs-site/docs/guides/integrations.md` |
+| Memory routing | `docs-site/docs/guides/memory-routing.md` |
+| Repertoire | `docs-site/docs/guides/repertoire.md` |
+| AsideContext | `docs-site/docs/guides/aside-context.md` |
+| Consumer migration | `docs-site/docs/guides/consumer-migration.md` |
+| Docusaurus site | https://0xrayai.github.io/xray/ |
 
-xray enforces the Universal Development Codex (60 terms) via Dynamo governance. The codex lives in `.xray/codex.json`.
+## Release artifacts
 
-Pure v16 MCPs. Clean. Complete.
+`npm run release:patch` updates: `package.json`, `CHANGELOG.md`, `README.md`, `AGENTS.md`, `AGENTS-consumer.md`, `SKILLS.md`, Docusaurus guides.