@soleri/forge 5.13.0 → 5.14.0

package/dist/lib.d.ts

@@ -11,3 +11,4 @@ export { patchIndexTs, patchClaudeMdContent } from './patching.js';
 export type { AgentConfig, AgentConfigInput, SetupTarget, ScaffoldResult, ScaffoldPreview, AgentInfo, InstallKnowledgeResult, AddDomainResult, } from './types.js';
 export { AgentConfigSchema, SETUP_TARGETS } from './types.js';
 export { generateExtensionsIndex, generateExampleOp } from './templates/extensions.js';
+export { generateClaudeMdTemplate } from './templates/claude-md-template.js';

package/dist/lib.js

@@ -10,4 +10,5 @@ export { addDomain } from './domain-manager.js';
 export { patchIndexTs, patchClaudeMdContent } from './patching.js';
 export { AgentConfigSchema, SETUP_TARGETS } from './types.js';
 export { generateExtensionsIndex, generateExampleOp } from './templates/extensions.js';
+export { generateClaudeMdTemplate } from './templates/claude-md-template.js';
 //# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -1 +1 @@
-{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAC3F,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAWnE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAC3F,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAWnE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/templates/claude-md-template.js

@@ -47,30 +47,16 @@ export function generateClaudeMdTemplate(config) {
         `On every new session: ${bt}${toolPrefix}_core op:register params:{ projectPath: "." }${bt}`,
         '',
     ];
-    // ─── Curated Facade Table ──────────────────────────────
-    mdLines.push('## Key Operations', '', `Full list: ${bt}${toolPrefix}_core op:admin_tool_list${bt}`, '', '| Need | Facade | Op |', '|------|--------|----|');
-    // 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)
+    // ─── Compact Facade Table ───────────────────────────────
+    mdLines.push('## Essential Tools', `<!-- ${toolPrefix}:tools -->`, '', '| Facade | Key Ops |', '|--------|---------|', `| ${bt}${toolPrefix}_core${bt} | ${bt}health${bt}, ${bt}search${bt}, ${bt}identity${bt}, ${bt}register${bt}, ${bt}activate${bt} |`);
+    // 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} |`);
+        mdLines.push(`| ${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
-    mdLines.push(`| Governance dashboard | ${bt}${toolPrefix}_core${bt} | ${bt}governance_dashboard${bt} |`, `| Governance policy | ${bt}${toolPrefix}_core${bt} | ${bt}governance_policy${bt} |`);
-    mdLines.push('');
+    // Engine facades — compact, grouped by concern
+    mdLines.push(`| ${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('', `> Full list: ${bt}${toolPrefix}_core op:admin_tool_list${bt}`, '');
     // ─── Shared Behavioral Rules ───────────────────────────
     mdLines.push(...getSharedRules(toolPrefix));
     // ─── Hook Packs (conditional) ──────────────────────────

package/dist/templates/claude-md-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude-md-template.js","sourceRoot":"","sources":["../../src/templates/claude-md-template.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"claude-md-template.js","sourceRoot":"","sources":["../../src/templates/claude-md-template.ts"],"names":[],"mappings":"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"}

package/dist/templates/shared-rules.d.ts

@@ -1,14 +1,9 @@
 /**
  * Shared behavioral rules that every Soleri agent ships with.
  *
- * 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
+ * Mirrors the structure and quality of Salvador's global CLAUDE.md.
+ * Uses HTML comment section markers, MANDATORY keywords, compact
+ * formatting, and complete lifecycle documentation.
  */
 /** Returns markdown lines for all shared behavioral sections. */
 export declare function getSharedRules(toolPrefix: string): string[];

package/dist/templates/shared-rules.js

@@ -1,14 +1,9 @@
 /**
  * Shared behavioral rules that every Soleri agent ships with.
  *
- * 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
+ * Mirrors the structure and quality of Salvador's global CLAUDE.md.
+ * Uses HTML comment section markers, MANDATORY keywords, compact
+ * formatting, and complete lifecycle documentation.
  */
 /** Returns markdown lines for all shared behavioral sections. */
 export function getSharedRules(toolPrefix) {
@@ -16,41 +11,42 @@ export function getSharedRules(toolPrefix) {
     return [
         // ─── Vault-First Protocol ────────────────────────────────
         '## Vault as Source of Truth',
+        `<!-- ${toolPrefix}:vault-protocol -->`,
         '',
-        'Before every decision — planning, design, architecture, problem-solving — consult the vault.',
+        '- **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.',
         '',
-        '**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 ────────────────────────────────────────────
         '## Planning',
+        `<!-- ${toolPrefix}: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}`,
+        `- 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.',
         '',
-        '**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}`,
+        '### Lifecycle States',
         '',
-        'Wait for explicit user approval before proceeding past each gate.',
-        'Check activation response for recovered plans in `executing` state — remind the user.',
+        '| 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 |`,
         '',
-        '**Exceptions:** Read-only operations, user says "just do it", single-line fixes.',
+        '### Plan Presentation',
         '',
-        // ─── Output Formatting ───────────────────────────────────
-        '## Output Formatting',
+        'Every plan summary MUST include this format:',
         '',
-        '**Plan metadata** — always show at top of every plan summary:',
+        '```',
+        '## Plan: [Short Title]',
         '',
         '| Field | Value |',
         '|-------|-------|',
@@ -58,35 +54,105 @@ export function getSharedRules(toolPrefix) {
         '| **Check ID** | {checkId} |',
         '| **Grade** | {grade} ({score}/100) |',
         '| **Status** | {status} |',
+        '| **Lifecycle** | {lifecycleStatus} |',
         '',
-        '**Drift reports:**',
+        '**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 |',
-        '|------|-------------|--------|',
-        '| skipped | ... | medium |',
+        '| 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 -->`,
         '',
-        "When learning something that should persist, capture it — don't just promise to remember.",
+        "**MANDATORY**: Persist lessons, don't just promise them.",
         '',
-        `- 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}`,
+        '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 -->`,
         '',
-        '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',
+        `**Semantic-First**: Analyze user MEANING before calling ${bt}route_intent${bt}.`,
         '',
         '| Signal | Intent |',
         '|--------|--------|',
@@ -97,22 +163,41 @@ export function getSharedRules(toolPrefix) {
         '| Improvement requested ("make it faster") | IMPROVE |',
         '| Ready to ship ("deploy", "release") | DELIVER |',
         '',
-        // ─── Session Lifecycle ───────────────────────────────────
-        '## Session Lifecycle',
+        `Use ${bt}${toolPrefix}_core op:route_intent${bt} only to CONFIRM your analysis or when meaning is unclear.`,
         '',
-        'A PreCompact hook calls `session_capture` before context compaction.',
-        `Manual capture: ${bt}${toolPrefix}_core op:session_capture params:{ summary: "..." }${bt}`,
+        // ─── Validation Loop ─────────────────────────────────────
+        '## Iterative Validation Loop',
+        `<!-- ${toolPrefix}:validation-loop -->`,
         '',
-        // ─── Orchestration ───────────────────────────────────────
-        '## Orchestration',
+        `- 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.',
         '',
-        'For complex workflows, use the orchestration layer instead of manual planning:',
+        '| 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 |`,
         '',
-        `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}`,
+        // ─── Brain-Informed Work ─────────────────────────────────
+        '## Brain-Informed Work',
+        `<!-- ${toolPrefix}:brain -->`,
         '',
-        'The orchestrator handles vault lookup, brain recommendations, and knowledge capture automatically.',
+        '- 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}`,
         '',
     ];
 }

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.0",
+  "version": "5.14.0",
   "description": "Scaffold AI agents that learn, remember, and grow with you.",
   "keywords": [
     "agent",

package/src/lib.ts

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

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

@@ -54,84 +54,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 |',
-    '|------|--------|----|',
-  );
-
-  // 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} |`,
+    '| Facade | Key Ops |',
+    '|--------|---------|',
+    `| ${bt}${toolPrefix}_core${bt} | ${bt}health${bt}, ${bt}search${bt}, ${bt}identity${bt}, ${bt}register${bt}, ${bt}activate${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('');
+  mdLines.push('', `> Full list: ${bt}${toolPrefix}_core op:admin_tool_list${bt}`, '');
 
   // ─── Shared Behavioral Rules ───────────────────────────
   mdLines.push(...getSharedRules(toolPrefix));

package/src/templates/shared-rules.ts

@@ -1,14 +1,9 @@
 /**
  * Shared behavioral rules that every Soleri agent ships with.
  *
- * 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
+ * Mirrors the structure and quality of Salvador's global CLAUDE.md.
+ * Uses HTML comment section markers, MANDATORY keywords, compact
+ * formatting, and complete lifecycle documentation.
  */
 
 /** Returns markdown lines for all shared behavioral sections. */
@@ -18,43 +13,43 @@ export function getSharedRules(toolPrefix: string): string[] {
   return [
     // ─── Vault-First Protocol ────────────────────────────────
     '## Vault as Source of Truth',
+    `<!-- ${toolPrefix}:vault-protocol -->`,
     '',
-    '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.',
+    '- **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 Enforcement ────────────────────────────────
+    // ─── Planning ────────────────────────────────────────────
     '## Planning',
+    `<!-- ${toolPrefix}: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}`,
+    `- 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.',
     '',
-    '**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}`,
+    '### Lifecycle States',
     '',
-    'Wait for explicit user approval before proceeding past each gate.',
-    'Check activation response for recovered plans in `executing` state — remind the user.',
+    '| 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 |`,
     '',
-    '**Exceptions:** Read-only operations, user says "just do it", single-line fixes.',
+    '### Plan Presentation',
     '',
-
-    // ─── Output Formatting ───────────────────────────────────
-    '## Output Formatting',
+    'Every plan summary MUST include this format:',
     '',
-    '**Plan metadata** — always show at top of every plan summary:',
+    '```',
+    '## Plan: [Short Title]',
     '',
     '| Field | Value |',
     '|-------|-------|',
@@ -62,37 +57,110 @@ export function getSharedRules(toolPrefix: string): string[] {
     '| **Check ID** | {checkId} |',
     '| **Grade** | {grade} ({score}/100) |',
     '| **Status** | {status} |',
+    '| **Lifecycle** | {lifecycleStatus} |',
     '',
-    '**Drift reports:**',
+    '**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 |',
-    '|------|-------------|--------|',
-    '| skipped | ... | medium |',
+    '| 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 -->`,
     '',
-    "When learning something that should persist, capture it — don't just promise to remember.",
+    "**MANDATORY**: Persist lessons, don't just promise them.",
     '',
-    `- 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}`,
+    '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 -->`,
     '',
-    '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',
+    `**Semantic-First**: Analyze user MEANING before calling ${bt}route_intent${bt}.`,
     '',
     '| Signal | Intent |',
     '|--------|--------|',
@@ -103,24 +171,45 @@ export function getSharedRules(toolPrefix: string): string[] {
     '| 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.`,
+    '',
 
-    // ─── Session Lifecycle ───────────────────────────────────
-    '## Session Lifecycle',
+    // ─── Validation Loop ─────────────────────────────────────
+    '## Iterative Validation Loop',
+    `<!-- ${toolPrefix}:validation-loop -->`,
     '',
-    'A PreCompact hook calls `session_capture` before context compaction.',
-    `Manual capture: ${bt}${toolPrefix}_core op:session_capture params:{ summary: "..." }${bt}`,
+    `- 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 |`,
     '',
 
-    // ─── Orchestration ───────────────────────────────────────
-    '## Orchestration',
+    // ─── 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.",
     '',
-    'For complex workflows, use the orchestration layer instead of manual planning:',
+
+    // ─── Cross-Project Memory ────────────────────────────────
+    '## Cross-Project Memory',
+    `<!-- ${toolPrefix}:cross-project -->`,
     '',
-    `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}`,
+    `- 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}.`,
     '',
-    'The orchestrator handles vault lookup, brain recommendations, and knowledge capture automatically.',
+
+    // ─── 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}`,
     '',
   ];
 }