@soleri/forge 5.13.1 → 5.14.1

package/dist/templates/shared-rules.js

@@ -1,119 +1,247 @@
 /**
- * Shared behavioral rules that every Soleri agent ships with.
+ * Shared Soleri engine rules — agent-agnostic.
  *
- * These rules are agent-agnostic and mirror the quality of Salvador's
- * hand-crafted CLAUDE.md behavioral sections. They cover:
- * - Vault-first knowledge protocol
- * - Planning enforcement (two-gate approval)
- * - Output formatting (plan metadata tables, drift reports)
- * - Knowledge capture discipline
- * - Intent routing
- * - Session lifecycle
+ * These rules are injected ONCE into global ~/.claude/CLAUDE.md under
+ * the `<!-- soleri:engine-rules -->` marker. They describe behavioral
+ * rules WITHOUT tool prefixes. The active agent's facade table (in its
+ * own `<!-- agent-id:mode -->` block) maps op names to actual tools.
+ *
+ * Uses op:name syntax — the active agent provides the tool prefix.
  */
-/** Returns markdown lines for all shared behavioral sections. */
-export function getSharedRules(toolPrefix) {
-    const bt = '`';
-    return [
-        // ─── Vault-First Protocol ────────────────────────────────
-        '## Vault as Source of Truth',
-        '',
-        'Before every decision — planning, design, architecture, problem-solving — consult the vault.',
-        '',
-        '**Lookup order:**',
-        `1. Vault — ${bt}${toolPrefix}_core op:search_intelligent params:{ query: "..." }${bt}`,
-        '2. Codebase — only if vault has nothing',
-        '3. Web / training knowledge — last resort',
-        '',
-        'If the vault has a pattern, follow it. If it has an anti-pattern, avoid it.',
-        '',
-        // ─── Planning Enforcement ────────────────────────────────
-        '## Planning',
-        '',
-        'For multi-step tasks, use the planning system. **Never skip gates.**',
-        '',
-        '**Lifecycle:**',
-        `${bt}draft → approved (Gate 1) → tasks approved (Gate 2) → executing → reconciling → completed${bt}`,
-        '',
-        '**Sequence:**',
-        `1. Create: ${bt}${toolPrefix}_core op:create_plan params:{ objective: "...", scope: "...", tasks: [...] }${bt}`,
-        `2. Approve plan (Gate 1): ${bt}${toolPrefix}_core op:approve_plan params:{ planId: "..." }${bt}`,
-        `3. Split tasks (Gate 2): ${bt}${toolPrefix}_core op:plan_split params:{ planId: "..." }${bt}`,
-        `4. Track: ${bt}${toolPrefix}_core op:update_task params:{ planId: "...", taskId: "...", status: "completed" }${bt}`,
-        `5. Reconcile: ${bt}${toolPrefix}_core op:plan_reconcile params:{ planId: "..." }${bt}`,
-        `6. Complete: ${bt}${toolPrefix}_core op:plan_complete_lifecycle params:{ planId: "..." }${bt}`,
-        '',
-        'Wait for explicit user approval before proceeding past each gate.',
-        'Check activation response for recovered plans in `executing` state — remind the user.',
-        '',
-        '**Exceptions:** Read-only operations, user says "just do it", single-line fixes.',
-        '',
-        // ─── Output Formatting ───────────────────────────────────
-        '## Output Formatting',
-        '',
-        '**Plan metadata** — always show at top of every plan summary:',
-        '',
-        '| Field | Value |',
-        '|-------|-------|',
-        '| **Plan ID** | {planId} |',
-        '| **Check ID** | {checkId} |',
-        '| **Grade** | {grade} ({score}/100) |',
-        '| **Status** | {status} |',
-        '',
-        '**Drift reports:**',
-        '',
-        '| Field | Value |',
-        '|-------|-------|',
-        '| **Accuracy** | {accuracyScore}/100 |',
-        '| **Drift Items** | {count} |',
-        '',
-        '| Type | Description | Impact |',
-        '|------|-------------|--------|',
-        '| skipped | ... | medium |',
-        '',
-        // ─── Knowledge Capture ───────────────────────────────────
-        '## Knowledge Capture',
-        '',
-        "When learning something that should persist, capture it — don't just promise to remember.",
-        '',
-        `- Domain knowledge: ${bt}${toolPrefix}_core op:capture_quick params:{ title: "...", description: "..." }${bt}`,
-        `- Batch capture: ${bt}${toolPrefix}_core op:capture_knowledge params:{ entries: [...] }${bt}`,
-        `- Intelligent search: ${bt}${toolPrefix}_core op:search_intelligent params:{ query: "..." }${bt}`,
-        '',
-        // ─── Intent Detection ────────────────────────────────────
-        '## Intent Detection',
-        '',
-        'A UserPromptSubmit hook auto-classifies prompts. When you see a `[MODE-NAME]` indicator:',
-        '',
-        `1. Call ${bt}${toolPrefix}_core op:route_intent params:{ prompt: "<user message>" }${bt}`,
-        '2. Follow the returned behavior rules',
-        '3. Briefly acknowledge mode changes',
-        '',
-        '| Signal | Intent |',
-        '|--------|--------|',
-        '| Problem described ("broken", "janky", "weird") | FIX |',
-        '| Need expressed ("I need", "we should have") | BUILD |',
-        '| Quality questioned ("is this right?") | REVIEW |',
-        '| Advice sought ("how should I", "best way") | PLAN |',
-        '| Improvement requested ("make it faster") | IMPROVE |',
-        '| Ready to ship ("deploy", "release") | DELIVER |',
-        '',
-        // ─── Session Lifecycle ───────────────────────────────────
-        '## Session Lifecycle',
-        '',
-        'A PreCompact hook calls `session_capture` before context compaction.',
-        `Manual capture: ${bt}${toolPrefix}_core op:session_capture params:{ summary: "..." }${bt}`,
-        '',
-        // ─── Orchestration ───────────────────────────────────────
-        '## Orchestration',
-        '',
-        'For complex workflows, use the orchestration layer instead of manual planning:',
-        '',
-        `1. Plan: ${bt}${toolPrefix}_core op:orchestrate_plan params:{ prompt: "...", projectPath: "." }${bt}`,
-        `2. Execute: ${bt}${toolPrefix}_core op:orchestrate_execute params:{ planId: "..." }${bt}`,
-        `3. Complete: ${bt}${toolPrefix}_core op:orchestrate_complete params:{ planId: "..." }${bt}`,
-        '',
-        'The orchestrator handles vault lookup, brain recommendations, and knowledge capture automatically.',
-        '',
-    ];
+const ENGINE_MARKER = 'soleri:engine-rules';
+export function getEngineMarker() {
+    return ENGINE_MARKER;
+}
+/** Returns the full engine rules markdown content (with markers). */
+export function getEngineRulesContent() {
+    return ENGINE_RULES_LINES.join('\n');
 }
+const ENGINE_RULES_LINES = [
+    `<!-- ${ENGINE_MARKER} -->`,
+    '',
+    '# Soleri Engine Rules',
+    '',
+    "Shared behavioral rules for all Soleri agents. The active agent's facade table provides tool names.",
+    '',
+    // ─── Response Integrity ─────────────────────────────────
+    '## Response Integrity',
+    '<!-- soleri:response-integrity -->',
+    '',
+    '- If you\'re not confident in your answer, say "I\'m not sure" and explain why. Never guess.',
+    '- After every response, rate your confidence from 1 to 10. Anything below 7, flag it.',
+    '',
+    // ─── Memory Quality Gate ───────────────────────────────
+    '## Memory Quality Gate',
+    '<!-- soleri:memory-quality -->',
+    '',
+    '**MANDATORY** before writing to auto memory: apply the **"Will I hit this again?"** test.',
+    '',
+    '**SAVE** — recurring bugs, non-obvious gotchas, structural issues, behavioral quirks that will resurface.',
+    "**NEVER SAVE** — one-time config, solved-and-done fixes, values already persisted in files, setup steps that won't repeat, anything where the fix is already in the codebase.",
+    '',
+    "If in doubt, don't save. Less memory with high signal beats more memory with noise.",
+    '',
+    // ─── Vault-First Protocol ────────────────────────────────
+    '## Vault as Source of Truth',
+    '<!-- soleri:vault-protocol -->',
+    '',
+    '- **MANDATORY**: Consult the vault BEFORE every decision — planning, design, architecture, patterns, problem-solving.',
+    '- Lookup order: 1) VAULT (`op:search_intelligent`) → 2) MEMORY (`op:memory_search`) → 3) CODEBASE → 4) WEB/TRAINING.',
+    '- If the vault has a pattern, follow it. If it has an anti-pattern, avoid it.',
+    '- Persist lessons: call `op:capture_knowledge` — don\'t just promise "I will remember this".',
+    '- Exceptions: runtime errors with stack traces → codebase first; user explicitly asks to search web.',
+    '',
+    // ─── Planning ────────────────────────────────────────────
+    '## Planning',
+    '<!-- soleri:planning -->',
+    '',
+    '- Use `op:create_plan` before writing ANY code. Show the plan, wait for approval.',
+    '- Two-gate approval: Gate 1 (`op:approve_plan`), Gate 2 (`op:plan_split`). Never skip either.',
+    '- Wait for explicit "yes" / "approve" before proceeding past each gate.',
+    '- After execution: `op:plan_reconcile` (drift report) then `op:plan_complete_lifecycle` (knowledge capture, archive).',
+    '- Never let a plan stay in `executing` or `reconciling` state without reminding the user.',
+    '- On session start: check for plans in `executing`/`reconciling` state and remind.',
+    '- Exceptions: read-only operations, user says "just do it", single-line fixes.',
+    '',
+    '### Lifecycle States',
+    '',
+    '| State | Expires | Next Action |',
+    '|-------|---------|-------------|',
+    '| `draft` | 30 min | `op:create_plan` (iterate) |',
+    '| `approved` | 30 min | `op:plan_split` |',
+    '| `executing` | Never | `op:plan_reconcile` |',
+    '| `reconciling` | Never | `op:plan_complete_lifecycle` |',
+    '| `completed` | — | Done |',
+    '',
+    '### Plan Presentation',
+    '',
+    'Every plan summary MUST include this format:',
+    '',
+    '```',
+    '## Plan: [Short Title]',
+    '',
+    '| Field | Value |',
+    '|-------|-------|',
+    '| **Plan ID** | {planId} |',
+    '| **Check ID** | {checkId} |',
+    '| **Grade** | {grade} ({score}/100) |',
+    '| **Status** | {status} |',
+    '| **Lifecycle** | {lifecycleStatus} |',
+    '',
+    '**Objective:** [One sentence]',
+    '',
+    '**Scope:**',
+    '| Included | Excluded |',
+    '|----------|----------|',
+    '| item 1   | item 1   |',
+    '',
+    '**Approach:**',
+    '| Step | Task |',
+    '|------|------|',
+    '| 1 | Description |',
+    '```',
+    '',
+    'Without visible IDs, users cannot resume, reference, or approve plans.',
+    '',
+    '### Drift Report',
+    '',
+    '```',
+    '| Field | Value |',
+    '|-------|-------|',
+    '| **Accuracy** | {accuracyScore}/100 |',
+    '| **Drift Items** | {count} |',
+    '',
+    '| Type | Description | Impact | Rationale |',
+    '|------|-------------|--------|-----------|',
+    '| skipped | ... | medium | ... |',
+    '```',
+    '',
+    // ─── Output Formatting ───────────────────────────────────
+    '## Output Formatting',
+    '<!-- soleri:output-formatting -->',
+    '',
+    '**MANDATORY**: Present tool outputs in human-readable format, NOT raw JSON.',
+    '',
+    '**Tasks** — show as numbered table:',
+    '```',
+    '| # | Type | Task | Complexity |',
+    '|---|------|------|------------|',
+    '| 1 | Impl | ... | High |',
+    '```',
+    '',
+    '**Completion** — show outcome, knowledge captured count, archive path.',
+    '',
+    '**Status lines** — `Persisted: X plans, Y tasks, Z checks` / `Recovered: X plans, Y tasks`',
+    '',
+    // ─── Clean Commits ───────────────────────────────────────
+    '## Clean Commits',
+    '<!-- soleri:clean-commits -->',
+    '',
+    '**MANDATORY**: No AI attribution in commit messages.',
+    '',
+    'Blocked patterns:',
+    '- `Co-Authored-By: Claude` (any variant)',
+    '- `noreply@anthropic.com`',
+    '- `Generated with Claude`, `AI-generated`',
+    '- Any mention of `Anthropic`, `Claude Opus`, `Claude Sonnet`, `Claude Haiku`',
+    '',
+    'Use conventional commits:',
+    '```',
+    'feat: add user authentication',
+    'fix: resolve login timeout issue',
+    'refactor: simplify data fetching logic',
+    '```',
+    '',
+    // ─── Knowledge Capture ───────────────────────────────────
+    '## Knowledge Capture',
+    '<!-- soleri:knowledge-capture -->',
+    '',
+    "**MANDATORY**: Persist lessons, don't just promise them.",
+    '',
+    'When you learn something that should persist:',
+    '1. **DON\'T** just say "I will remember this"',
+    '2. **DO** call `op:capture_knowledge` to persist to vault',
+    "3. **DO** update relevant files if it's a behavioral change",
+    '',
+    '| Type | Op | Persists To |',
+    '|------|-----|-------------|',
+    '| Patterns/Anti-patterns | `op:capture_knowledge` | vault |',
+    '| Quick capture | `op:capture_quick` | vault |',
+    '| Session summaries | `op:session_capture` | memory |',
+    '',
+    // ─── Work Task Routing ───────────────────────────────────
+    '## Work Task Routing',
+    '<!-- soleri:task-routing -->',
+    '',
+    'Use the orchestration layer for ALL work tasks:',
+    '- `op:orchestrate_plan` → vault + brain + structured plan.',
+    '- `op:orchestrate_execute` → execution tracking.',
+    '- `op:orchestrate_complete` → epilogue (vault, session).',
+    '',
+    'The orchestrator handles vault lookup, brain recommendations, and knowledge capture automatically.',
+    '',
+    // ─── Intent Detection ────────────────────────────────────
+    '## Intent Detection',
+    '<!-- soleri:intent-detection -->',
+    '',
+    '**Semantic-First**: Analyze user MEANING before calling `op:route_intent`.',
+    '',
+    '| Signal | Intent |',
+    '|--------|--------|',
+    '| Problem described ("broken", "janky", "weird") | FIX |',
+    '| Need expressed ("I need", "we should have") | BUILD |',
+    '| Quality questioned ("is this right?") | REVIEW |',
+    '| Advice sought ("how should I", "best way") | PLAN |',
+    '| Improvement requested ("make it faster") | IMPROVE |',
+    '| Ready to ship ("deploy", "release") | DELIVER |',
+    '',
+    'Use `op:route_intent` only to CONFIRM your analysis or when meaning is unclear.',
+    '',
+    // ─── Validation Loop ─────────────────────────────────────
+    '## Iterative Validation Loop',
+    '<!-- soleri:validation-loop -->',
+    '',
+    '- When a user gives a **work task**, start a loop: `op:loop_start params:{ prompt: "<task>", mode: "custom" }`',
+    '- Do NOT start loops for: questions, explanations, status checks, git operations, exploration, simple one-line fixes.',
+    '',
+    '| Mode | Op | Target | Max Iter |',
+    '|------|-----|--------|----------|',
+    '| `plan-iteration` | `op:create_plan` | grade >= A | 10 |',
+    '| `custom` | user-defined | promise-based | 20 |',
+    '',
+    // ─── Brain-Informed Work ─────────────────────────────────
+    '## Brain-Informed Work',
+    '<!-- soleri:brain -->',
+    '',
+    '- Brain patterns surface at session start. For relevant patterns, pull rules just-in-time from the vault.',
+    '- Brain tells you **which** patterns matter (names + strength scores). Vault tells you **what** they are (rules, examples).',
+    "- Pull only what's relevant to the current task — don't load everything at session start.",
+    '',
+    // ─── Cross-Project Memory ────────────────────────────────
+    '## Cross-Project Memory',
+    '<!-- soleri:cross-project -->',
+    '',
+    '- Use `crossProject: true` in `op:memory_search` for patterns across related projects.',
+    '- Promote universal patterns to global pool with `op:memory_promote_to_global`.',
+    '',
+    // ─── Session Lifecycle ───────────────────────────────────
+    '## Session Lifecycle',
+    '<!-- soleri:session -->',
+    '',
+    '### Session Start Protocol',
+    '',
+    'On EVERY new session:',
+    '1. Register project: `op:register params:{ projectPath: "." }`',
+    '2. Check activation response for `persistence.status`, `vault.connected`, `project.registered`.',
+    '3. Check for plans awaiting reconciliation via `op:check_persistence`:',
+    '   - `executing` → Remind user to call `op:plan_reconcile`.',
+    '   - `reconciling` → Remind user to call `op:plan_complete_lifecycle`.',
+    '',
+    '### Context Compaction',
+    '',
+    'A PreCompact hook calls `op:session_capture` before context compaction.',
+    'Manual capture: `op:session_capture params:{ summary: "..." }`',
+    '',
+    `<!-- /${ENGINE_MARKER} -->`,
+];
 //# sourceMappingURL=shared-rules.js.map

package/dist/templates/shared-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared-rules.js","sourceRoot":"","sources":["../../src/templates/shared-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,MAAM,EAAE,GAAG,GAAG,CAAC;IAEf,OAAO;QACL,4DAA4D;QAC5D,6BAA6B;QAC7B,EAAE;QACF,8FAA8F;QAC9F,EAAE;QACF,mBAAmB;QACnB,cAAc,EAAE,GAAG,UAAU,sDAAsD,EAAE,EAAE;QACvF,yCAAyC;QACzC,2CAA2C;QAC3C,EAAE;QACF,6EAA6E;QAC7E,EAAE;QAEF,4DAA4D;QAC5D,aAAa;QACb,EAAE;QACF,sEAAsE;QACtE,EAAE;QACF,gBAAgB;QAChB,GAAG,EAAE,4FAA4F,EAAE,EAAE;QACrG,EAAE;QACF,eAAe;QACf,cAAc,EAAE,GAAG,UAAU,+EAA+E,EAAE,EAAE;QAChH,6BAA6B,EAAE,GAAG,UAAU,iDAAiD,EAAE,EAAE;QACjG,4BAA4B,EAAE,GAAG,UAAU,+CAA+C,EAAE,EAAE;QAC9F,aAAa,EAAE,GAAG,UAAU,oFAAoF,EAAE,EAAE;QACpH,iBAAiB,EAAE,GAAG,UAAU,mDAAmD,EAAE,EAAE;QACvF,gBAAgB,EAAE,GAAG,UAAU,4DAA4D,EAAE,EAAE;QAC/F,EAAE;QACF,mEAAmE;QACnE,uFAAuF;QACvF,EAAE;QACF,kFAAkF;QAClF,EAAE;QAEF,4DAA4D;QAC5D,sBAAsB;QACtB,EAAE;QACF,+DAA+D;QAC/D,EAAE;QACF,mBAAmB;QACnB,mBAAmB;QACnB,4BAA4B;QAC5B,8BAA8B;QAC9B,uCAAuC;QACvC,2BAA2B;QAC3B,EAAE;QACF,oBAAoB;QACpB,EAAE;QACF,mBAAmB;QACnB,mBAAmB;QACnB,wCAAwC;QACxC,+BAA+B;QAC/B,EAAE;QACF,iCAAiC;QACjC,iCAAiC;QACjC,4BAA4B;QAC5B,EAAE;QAEF,4DAA4D;QAC5D,sBAAsB;QACtB,EAAE;QACF,2FAA2F;QAC3F,EAAE;QACF,uBAAuB,EAAE,GAAG,UAAU,qEAAqE,EAAE,EAAE;QAC/G,oBAAoB,EAAE,GAAG,UAAU,uDAAuD,EAAE,EAAE;QAC9F,yBAAyB,EAAE,GAAG,UAAU,sDAAsD,EAAE,EAAE;QAClG,EAAE;QAEF,4DAA4D;QAC5D,qBAAqB;QACrB,EAAE;QACF,0FAA0F;QAC1F,EAAE;QACF,WAAW,EAAE,GAAG,UAAU,4DAA4D,EAAE,EAAE;QAC1F,uCAAuC;QACvC,qCAAqC;QACrC,EAAE;QACF,qBAAqB;QACrB,qBAAqB;QACrB,0DAA0D;QAC1D,yDAAyD;QACzD,oDAAoD;QACpD,uDAAuD;QACvD,wDAAwD;QACxD,mDAAmD;QACnD,EAAE;QAEF,4DAA4D;QAC5D,sBAAsB;QACtB,EAAE;QACF,sEAAsE;QACtE,mBAAmB,EAAE,GAAG,UAAU,qDAAqD,EAAE,EAAE;QAC3F,EAAE;QAEF,4DAA4D;QAC5D,kBAAkB;QAClB,EAAE;QACF,gFAAgF;QAChF,EAAE;QACF,YAAY,EAAE,GAAG,UAAU,uEAAuE,EAAE,EAAE;QACtG,eAAe,EAAE,GAAG,UAAU,wDAAwD,EAAE,EAAE;QAC1F,gBAAgB,EAAE,GAAG,UAAU,yDAAyD,EAAE,EAAE;QAC5F,EAAE;QACF,oGAAoG;QACpG,EAAE;KACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"shared-rules.js","sourceRoot":"","sources":["../../src/templates/shared-rules.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleri/forge",
-  "version": "5.13.1",
+  "version": "5.14.1",
   "description": "Scaffold AI agents that learn, remember, and grow with you.",
   "keywords": [
     "agent",

package/src/lib.ts

@@ -21,3 +21,4 @@ export type {
 export { AgentConfigSchema, SETUP_TARGETS } from './types.js';
 export { generateExtensionsIndex, generateExampleOp } from './templates/extensions.js';
 export { generateClaudeMdTemplate } from './templates/claude-md-template.js';
+export { getEngineRulesContent, getEngineMarker } from './templates/shared-rules.js';

package/src/templates/claude-md-template.ts

@@ -1,18 +1,19 @@
 import type { AgentConfig } from '../types.js';
-import { getSharedRules } from './shared-rules.js';
+import { getEngineMarker, getEngineRulesContent } from './shared-rules.js';
 
 /**
  * Generates src/activation/claude-md-content.ts for a new agent.
  *
- * Architecture:
- * 1. Agent-specific identity (persona, domains, principles)
- * 2. Session start protocol
- * 3. Curated facade table (~30 key ops, grouped by category)
- * 4. Shared behavioral rules (vault-first, planning, output formatting)
- * 5. Hook packs (conditional)
+ * Architecture (split injection):
+ * 1. Engine rules — shared, prefix-free, injected once under `<!-- soleri:engine-rules -->`
+ * 2. Agent block — lightweight, agent-specific, under `<!-- agent-id:mode -->`
+ *    - Identity (persona, domains, principles)
+ *    - Session start protocol
+ *    - Curated facade table (~30 key ops, grouped by category)
+ *    - Hook packs (conditional)
  *
- * Full op list is always available via `admin_tool_list` — no need to
- * enumerate all 145+ ops in CLAUDE.md.
+ * The facade table maps `op:name` → actual `agentId_core op:name` tool calls.
+ * Full op list is always available via `admin_tool_list`.
  */
 export function generateClaudeMdTemplate(config: AgentConfig): string {
   const toolPrefix = config.id;
@@ -54,87 +55,38 @@ export function generateClaudeMdTemplate(config: AgentConfig): string {
     '',
   ];
 
-  // ─── Curated Facade Table ──────────────────────────────
+  // ─── Compact Facade Table ───────────────────────────────
   mdLines.push(
-    '## Key Operations',
+    '## Essential Tools',
+    `<!-- ${toolPrefix}:tools -->`,
     '',
-    `Full list: ${bt}${toolPrefix}_core op:admin_tool_list${bt}`,
-    '',
-    '| Need | Facade | Op |',
-    '|------|--------|----|',
+    '| Facade | Key Ops |',
+    '|--------|---------|',
+    `| ${bt}${toolPrefix}_core${bt} | ${bt}health${bt}, ${bt}search${bt}, ${bt}identity${bt}, ${bt}register${bt}, ${bt}activate${bt} |`,
   );
 
-  // Essential
-  mdLines.push(
-    `| Health check | ${bt}${toolPrefix}_core${bt} | ${bt}health${bt} |`,
-    `| Search all | ${bt}${toolPrefix}_core${bt} | ${bt}search${bt} |`,
-    `| Identity | ${bt}${toolPrefix}_core${bt} | ${bt}identity${bt} |`,
-  );
-
-  // Domain-specific (3 rows per domain)
+  // Domain facades — one row per domain
   for (const d of config.domains) {
     const toolName = `${toolPrefix}_${d.replace(/-/g, '_')}`;
     mdLines.push(
-      `| ${d} patterns | ${bt}${toolName}${bt} | ${bt}get_patterns${bt} |`,
-      `| Search ${d} | ${bt}${toolName}${bt} | ${bt}search${bt} |`,
-      `| Capture ${d} | ${bt}${toolName}${bt} | ${bt}capture${bt} |`,
+      `| ${bt}${toolName}${bt} | ${bt}get_patterns${bt}, ${bt}search${bt}, ${bt}capture${bt} |`,
     );
   }
 
-  // Knowledge & Search
-  mdLines.push(
-    `| Intelligent search | ${bt}${toolPrefix}_core${bt} | ${bt}search_intelligent${bt} |`,
-    `| Quick capture | ${bt}${toolPrefix}_core${bt} | ${bt}capture_quick${bt} |`,
-    `| Batch capture | ${bt}${toolPrefix}_core${bt} | ${bt}capture_knowledge${bt} |`,
-  );
-
-  // Memory
-  mdLines.push(
-    `| Memory search | ${bt}${toolPrefix}_core${bt} | ${bt}memory_search${bt} |`,
-    `| Memory capture | ${bt}${toolPrefix}_core${bt} | ${bt}memory_capture${bt} |`,
-    `| Session capture | ${bt}${toolPrefix}_core${bt} | ${bt}session_capture${bt} |`,
-  );
-
-  // Planning
-  mdLines.push(
-    `| Create plan | ${bt}${toolPrefix}_core${bt} | ${bt}create_plan${bt} |`,
-    `| Approve plan | ${bt}${toolPrefix}_core${bt} | ${bt}approve_plan${bt} |`,
-    `| Update task | ${bt}${toolPrefix}_core${bt} | ${bt}update_task${bt} |`,
-    `| Complete plan | ${bt}${toolPrefix}_core${bt} | ${bt}complete_plan${bt} |`,
-  );
-
-  // Orchestration
-  mdLines.push(
-    `| Orchestrate plan | ${bt}${toolPrefix}_core${bt} | ${bt}orchestrate_plan${bt} |`,
-    `| Orchestrate execute | ${bt}${toolPrefix}_core${bt} | ${bt}orchestrate_execute${bt} |`,
-    `| Orchestrate complete | ${bt}${toolPrefix}_core${bt} | ${bt}orchestrate_complete${bt} |`,
-  );
-
-  // Brain & Control
-  mdLines.push(
-    `| Brain stats | ${bt}${toolPrefix}_core${bt} | ${bt}brain_stats${bt} |`,
-    `| Brain feedback | ${bt}${toolPrefix}_core${bt} | ${bt}brain_feedback${bt} |`,
-    `| Route intent | ${bt}${toolPrefix}_core${bt} | ${bt}route_intent${bt} |`,
-    `| Get behavior rules | ${bt}${toolPrefix}_core${bt} | ${bt}get_behavior_rules${bt} |`,
-    `| Morph mode | ${bt}${toolPrefix}_core${bt} | ${bt}morph${bt} |`,
-  );
-
-  // Admin
-  mdLines.push(
-    `| Admin health | ${bt}${toolPrefix}_core${bt} | ${bt}admin_health${bt} |`,
-    `| Tool list | ${bt}${toolPrefix}_core${bt} | ${bt}admin_tool_list${bt} |`,
-  );
-
-  // Governance
+  // Engine facades — compact, grouped by concern
   mdLines.push(
-    `| Governance dashboard | ${bt}${toolPrefix}_core${bt} | ${bt}governance_dashboard${bt} |`,
-    `| Governance policy | ${bt}${toolPrefix}_core${bt} | ${bt}governance_policy${bt} |`,
+    `| ${bt}${toolPrefix}_core${bt} (vault) | ${bt}search_intelligent${bt}, ${bt}capture_knowledge${bt}, ${bt}capture_quick${bt}, ${bt}search_feedback${bt} |`,
+    `| ${bt}${toolPrefix}_core${bt} (memory) | ${bt}memory_search${bt}, ${bt}memory_capture${bt}, ${bt}session_capture${bt} |`,
+    `| ${bt}${toolPrefix}_core${bt} (planning) | ${bt}create_plan${bt}, ${bt}approve_plan${bt}, ${bt}plan_split${bt}, ${bt}plan_reconcile${bt}, ${bt}plan_complete_lifecycle${bt} |`,
+    `| ${bt}${toolPrefix}_core${bt} (orchestrate) | ${bt}orchestrate_plan${bt}, ${bt}orchestrate_execute${bt}, ${bt}orchestrate_complete${bt} |`,
+    `| ${bt}${toolPrefix}_core${bt} (brain) | ${bt}brain_stats${bt}, ${bt}brain_feedback${bt}, ${bt}rebuild_vocabulary${bt} |`,
+    `| ${bt}${toolPrefix}_core${bt} (control) | ${bt}route_intent${bt}, ${bt}morph${bt}, ${bt}get_behavior_rules${bt} |`,
+    `| ${bt}${toolPrefix}_core${bt} (loop) | ${bt}loop_start${bt}, ${bt}loop_iterate${bt}, ${bt}loop_status${bt}, ${bt}loop_cancel${bt} |`,
+    `| ${bt}${toolPrefix}_core${bt} (governance) | ${bt}governance_dashboard${bt}, ${bt}governance_policy${bt}, ${bt}governance_proposals${bt} |`,
+    `| ${bt}${toolPrefix}_core${bt} (admin) | ${bt}admin_health${bt}, ${bt}admin_tool_list${bt}, ${bt}admin_diagnostic${bt} |`,
   );
 
-  mdLines.push('');
-
-  // ─── Shared Behavioral Rules ───────────────────────────
-  mdLines.push(...getSharedRules(toolPrefix));
+  mdLines.push('', `> Full list: ${bt}${toolPrefix}_core op:admin_tool_list${bt}`, '');
 
   // ─── Hook Packs (conditional) ──────────────────────────
   appendHookPacks(mdLines, config);
@@ -148,11 +100,20 @@ export function generateClaudeMdTemplate(config: AgentConfig): string {
     return `    '${escaped}',`;
   });
 
+  // Generate engine rules as a quoted string literal
+  const engineContent = getEngineRulesContent();
+  const engineQuotedLines = engineContent.split('\n').map((line) => {
+    const escaped = line.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+    return `    '${escaped}',`;
+  });
+
   return [
     '/**',
     ` * CLAUDE.md content for ${config.name}.`,
     ' * Generated by Soleri — do not edit manually.',
     ' */',
+    '',
+    '/** Agent-specific block (identity + activation + facade table). */',
     'export function getClaudeMdContent(): string {',
     '  return [',
     ...quotedLines,
@@ -162,6 +123,17 @@ export function generateClaudeMdTemplate(config: AgentConfig): string {
     'export function getClaudeMdMarker(): string {',
     `  return '${marker}';`,
     '}',
+    '',
+    '/** Shared engine rules — injected once, skipped if already present. */',
+    'export function getEngineRulesContent(): string {',
+    '  return [',
+    ...engineQuotedLines,
+    "  ].join('\\n');",
+    '}',
+    '',
+    'export function getEngineRulesMarker(): string {',
+    `  return '${getEngineMarker()}';`,
+    '}',
   ].join('\n');
 }