@soleri/forge 5.14.0 → 5.14.1

package/dist/templates/shared-rules.js

@@ -1,204 +1,247 @@
 /**
- * Shared behavioral rules that every Soleri agent ships with.
+ * Shared Soleri engine rules — agent-agnostic.
  *
- * Mirrors the structure and quality of Salvador's global CLAUDE.md.
- * Uses HTML comment section markers, MANDATORY keywords, compact
- * formatting, and complete lifecycle documentation.
+ * 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',
-        `<!-- ${toolPrefix}:vault-protocol -->`,
-        '',
-        '- **MANDATORY**: Consult the vault BEFORE every decision — planning, design, architecture, patterns, problem-solving.',
-        `- Lookup order: 1) VAULT (${bt}${toolPrefix}_core op:search_intelligent${bt}) → 2) MEMORY (${bt}${toolPrefix}_core op:memory_search${bt}) → 3) CODEBASE → 4) WEB/TRAINING.`,
-        '- If the vault has a pattern, follow it. If it has an anti-pattern, avoid it.',
-        `- Persist lessons: call ${bt}${toolPrefix}_core op:capture_knowledge${bt} — don't just promise "I will remember this".`,
-        '- Exceptions: runtime errors with stack traces → codebase first; user explicitly asks to search web.',
-        '',
-        // ─── Planning ────────────────────────────────────────────
-        '## Planning',
-        `<!-- ${toolPrefix}:planning -->`,
-        '',
-        `- Use ${bt}${toolPrefix}_core op:create_plan${bt} before writing ANY code. Show the plan, wait for approval.`,
-        `- Two-gate approval: Gate 1 (${bt}op:approve_plan${bt}), Gate 2 (${bt}op:plan_split${bt}). Never skip either.`,
-        '- Wait for explicit "yes" / "approve" before proceeding past each gate.',
-        `- After execution: ${bt}op:plan_reconcile${bt} (drift report) then ${bt}op:plan_complete_lifecycle${bt} (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 |',
-        '|-------|---------|-------------|',
-        `| ${bt}draft${bt} | 30 min | ${bt}${toolPrefix}_core op:create_plan${bt} (iterate) |`,
-        `| ${bt}approved${bt} | 30 min | ${bt}${toolPrefix}_core op:plan_split${bt} |`,
-        `| ${bt}executing${bt} | Never | ${bt}${toolPrefix}_core op:plan_reconcile${bt} |`,
-        `| ${bt}reconciling${bt} | Never | ${bt}${toolPrefix}_core op:plan_complete_lifecycle${bt} |`,
-        `| ${bt}completed${bt} | — | 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',
-        `<!-- ${toolPrefix}: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',
-        `<!-- ${toolPrefix}: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',
-        `<!-- ${toolPrefix}: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 ${bt}${toolPrefix}_core op:capture_knowledge${bt} to persist to vault`,
-        "3. **DO** update relevant files if it's a behavioral change",
-        '',
-        '| Type | Tool | Persists To |',
-        '|------|------|-------------|',
-        `| Patterns/Anti-patterns | ${bt}${toolPrefix}_core op:capture_knowledge${bt} | vault |`,
-        `| Quick capture | ${bt}${toolPrefix}_core op:capture_quick${bt} | vault |`,
-        `| Session summaries | ${bt}${toolPrefix}_core op:session_capture${bt} | memory |`,
-        '',
-        // ─── Work Task Routing ───────────────────────────────────
-        '## Work Task Routing',
-        `<!-- ${toolPrefix}:task-routing -->`,
-        '',
-        'Use the orchestration layer for ALL work tasks:',
-        `- ${bt}${toolPrefix}_core op:orchestrate_plan${bt} → vault + brain + structured plan.`,
-        `- ${bt}${toolPrefix}_core op:orchestrate_execute${bt} → execution tracking.`,
-        `- ${bt}${toolPrefix}_core op:orchestrate_complete${bt} → epilogue (vault, session).`,
-        '',
-        'The orchestrator handles vault lookup, brain recommendations, and knowledge capture automatically.',
-        '',
-        // ─── Intent Detection ────────────────────────────────────
-        '## Intent Detection',
-        `<!-- ${toolPrefix}:intent-detection -->`,
-        '',
-        `**Semantic-First**: Analyze user MEANING before calling ${bt}route_intent${bt}.`,
-        '',
-        '| 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 ${bt}${toolPrefix}_core op:route_intent${bt} only to CONFIRM your analysis or when meaning is unclear.`,
-        '',
-        // ─── Validation Loop ─────────────────────────────────────
-        '## Iterative Validation Loop',
-        `<!-- ${toolPrefix}:validation-loop -->`,
-        '',
-        `- When a user gives a **work task**, start a loop: ${bt}${toolPrefix}_core op:loop_start params:{ prompt: "<task>", mode: "custom" }${bt}`,
-        '- Do NOT start loops for: questions, explanations, status checks, git operations, exploration, simple one-line fixes.',
-        '',
-        '| Mode | Tool | Target | Max Iter |',
-        '|------|------|--------|----------|',
-        `| ${bt}plan-iteration${bt} | ${bt}${toolPrefix}_core op:create_plan${bt} | grade >= A | 10 |`,
-        `| ${bt}custom${bt} | user-defined | promise-based | 20 |`,
-        '',
-        // ─── Brain-Informed Work ─────────────────────────────────
-        '## Brain-Informed Work',
-        `<!-- ${toolPrefix}: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',
-        `<!-- ${toolPrefix}:cross-project -->`,
-        '',
-        `- Use ${bt}crossProject: true${bt} in ${bt}${toolPrefix}_core op:memory_search${bt} for patterns across related projects.`,
-        `- Promote universal patterns to global pool with ${bt}${toolPrefix}_core op:memory_promote_to_global${bt}.`,
-        '',
-        // ─── Session Lifecycle ───────────────────────────────────
-        '## Session Lifecycle',
-        `<!-- ${toolPrefix}:session -->`,
-        '',
-        'A PreCompact hook calls `session_capture` before context compaction.',
-        `Manual capture: ${bt}${toolPrefix}_core op:session_capture params:{ summary: "..." }${bt}`,
-        '',
-    ];
+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":"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"}
+{"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.14.0",
+  "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;
@@ -87,9 +88,6 @@ export function generateClaudeMdTemplate(config: AgentConfig): string {
 
   mdLines.push('', `> Full list: ${bt}${toolPrefix}_core op:admin_tool_list${bt}`, '');
 
-  // ─── Shared Behavioral Rules ───────────────────────────
-  mdLines.push(...getSharedRules(toolPrefix));
-
   // ─── Hook Packs (conditional) ──────────────────────────
   appendHookPacks(mdLines, config);
 
@@ -102,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,
@@ -116,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');
 }