@soleri/forge 9.15.0 → 9.16.7

package/dist/skills/soleri-intake/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: soleri-intake
+tier: default
+description: >
+  Use when the user says "ingest this", "add this URL", "import this book",
+  "read and capture", "ingest batch", or when processing external content
+  into the vault. Handles URLs, text, books, and batch imports with
+  automatic knowledge extraction.
+---
+
+# Intake — Ingest External Content
+
+Import external content (URLs, books, text, batch files) into the vault with automatic knowledge extraction. The intake skill handles chunking, entity extraction, and vault persistence so you don't have to do it manually.
+
+## When to Use
+
+- User pastes a URL ("save this article to vault")
+- User shares a book or long document ("ingest this book into your knowledge base")
+- User wants to capture raw text from an external source
+- Batch importing multiple sources at once
+
+## Orchestration
+
+### Step 1: Identify Content Type
+
+Determine what the user is providing:
+
+| Type             | Use Op         | When                             |
+| ---------------- | -------------- | -------------------------------- |
+| URL              | `ingest_url`   | User pastes a web link           |
+| Book / long doc  | `ingest_book`  | PDF, long markdown, or file path |
+| Raw text         | `ingest_text`  | User pastes text directly        |
+| Multiple sources | `ingest_batch` | List of URLs or file paths       |
+
+### Step 2: Ingest
+
+**URL:**
+
+```
+YOUR_AGENT_intake op:ingest_url
+  params: {
+    url: "<url>",
+    domain: "<inferred domain>",
+    tags: ["<tag1>", "<tag2>"]
+  }
+```
+
+**Book / Long Document:**
+
+```
+YOUR_AGENT_intake op:ingest_book
+  params: {
+    path: "<file path or url>",
+    title: "<document title>",
+    domain: "<domain>",
+    chunkStrategy: "chapter"
+  }
+```
+
+**Raw Text:**
+
+```
+YOUR_AGENT_intake op:ingest_text
+  params: {
+    text: "<content>",
+    title: "<descriptive title>",
+    domain: "<domain>",
+    tags: ["<tag>"]
+  }
+```
+
+**Batch:**
+
+```
+YOUR_AGENT_intake op:ingest_batch
+  params: {
+    sources: [
+      { type: "url", value: "<url1>" },
+      { type: "url", value: "<url2>" }
+    ],
+    domain: "<domain>"
+  }
+```
+
+### Step 3: Report Results
+
+Present a summary table:
+
+| Field               | Value             |
+| ------------------- | ----------------- |
+| **Entries created** | {count}           |
+| **Domain**          | {domain}          |
+| **Tags**            | {tags.join(', ')} |
+| **Status**          | {status}          |
+
+If any sources failed, list them with reasons so the user can retry.
+
+## Exit Criteria
+
+All content ingested, entry IDs confirmed, results reported to user.

package/dist/skills/soleri-knowledge-harvest/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-knowledge-harvest
+tier: default
 description: >
   Use when the user says "learn from this", "harvest knowledge", "ingest this",
   or "extract patterns from". Extracts multiple patterns from a source like

package/dist/skills/soleri-loop/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: soleri-loop
+tier: default
+description: >
+  Use when the user says "start a loop", "run until done", "iterate until X",
+  "loop status", or "cancel loop". Manages iterative execution loops that
+  repeat a task until a condition is met or a grade threshold is reached.
+---
+
+# Loop — Iterative Execution
+
+Run a task in a loop until a condition is met — grade threshold, promise fulfilled, or explicit cancellation. Useful for plan refinement, quality iteration, and autonomous improvement cycles.
+
+## When to Use
+
+- Improving a plan until it reaches grade A
+- Running validation until all tests pass
+- Any task that needs to repeat with self-correction until done
+
+## Orchestration
+
+### Step 1: Start Loop
+
+```
+YOUR_AGENT_loop op:loop_start
+  params: {
+    prompt: "<task description>",
+    mode: "<plan-iteration | custom>",
+    maxIterations: <number, default 10>
+  }
+```
+
+**Modes:**
+
+- `plan-iteration` — repeats `create_plan` until grade >= A (target-based)
+- `custom` — user-defined stop condition; loop continues until promise satisfied
+
+Note the `loopId` from the response — needed for status and cancel.
+
+### Step 2: Monitor
+
+At each iteration, check status:
+
+```
+YOUR_AGENT_loop op:loop_status
+  params: { loopId: "<loopId>" }
+```
+
+Report progress to user:
+
+| Field              | Value                                |
+| ------------------ | ------------------------------------ |
+| **Iteration**      | {currentIteration} / {maxIterations} |
+| **Status**         | {status}                             |
+| **Last result**    | {lastResult}                         |
+| **Stop condition** | {stopCondition}                      |
+
+### Step 3: Cancel (if needed)
+
+If the user wants to stop early:
+
+```
+YOUR_AGENT_loop op:loop_cancel
+  params: { loopId: "<loopId>", reason: "<why stopping>" }
+```
+
+## Exit Criteria
+
+Loop completes when: stop condition is met, max iterations reached, or user explicitly cancels. Report final outcome and iteration count.

package/dist/skills/soleri-mcp-doctor/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-mcp-doctor
+tier: default
 description: >
   Use when the user says "MCP not working", "tools missing", "fix MCP",
   "mcp doctor", or "server not connecting". Diagnoses and repairs MCP server

package/dist/skills/soleri-onboard-me/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-onboard-me
+tier: default
 description: >
   Use when the user says "onboard me", "I'm new here", "project overview",
   or "what should I know about this codebase". Provides a structured tour

package/dist/skills/soleri-orchestrate/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: soleri-orchestrate
+tier: default
+description: >
+  Use when the user gives a work task: "implement X", "build Y", "fix Z",
+  "add feature", or any request that requires planning and execution.
+  Runs the full orchestration loop: plan → execute → complete with vault
+  context and brain recommendations built in.
+---
+
+# Orchestrate — Full Work Loop
+
+Run the full work loop with vault intelligence: plan the task, execute it step by step, and close with knowledge capture. Use this for any non-trivial task where missing context or skipping steps would cost time.
+
+## When to Use
+
+- User gives a concrete work task ("implement auth", "refactor the parser", "fix the flaky test")
+- Task spans multiple files or has cross-cutting concerns
+- You want vault patterns and brain recommendations surfaced automatically
+
+## Orchestration
+
+### Step 1: Plan
+
+```
+YOUR_AGENT_orchestrate op:orchestrate_plan
+  params: {
+    prompt: "<user task description>",
+    context: { domain: "<inferred domain>" }
+  }
+```
+
+Present the plan to the user. If grade < A-, ask for approval before proceeding.
+
+### Step 2: Execute
+
+Once approved, begin execution. For each task in the plan:
+
+```
+YOUR_AGENT_orchestrate op:orchestrate_execute
+  params: {
+    planId: "<planId from step 1>",
+    taskId: "<current task id>",
+    output: "<what you did>"
+  }
+```
+
+Log progress after each task: show completed count / total and current task title.
+
+### Step 3: Complete
+
+After all tasks are done:
+
+```
+YOUR_AGENT_orchestrate op:orchestrate_complete
+  params: {
+    planId: "<planId>",
+    summary: "<one-line outcome>",
+    operatorSignals: {
+      qualityNotes: "<any quality observations>",
+      unexpectedComplexity: <true|false>
+    }
+  }
+```
+
+Report the completion summary and any knowledge captured.
+
+## Exit Criteria
+
+All plan tasks executed, `orchestrate_complete` called with outcome, knowledge persisted to vault.

package/dist/skills/soleri-parallel-execute/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-parallel-execute
+tier: default
 description: >
   Use when the user says "run in parallel", "fan out", "concurrent execution",
   "batch execute", or "dispatch subagents". Executes independent plan tasks

package/dist/skills/soleri-research-scout/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-research-scout
+tier: default
 description: >
   Use when the user says "scout", "research scout", "find new info",
   "what's new", or "scan the web". Discovers new information that challenges

package/dist/skills/soleri-retrospective/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-retrospective
+tier: default
 description: >
   Use when the user says "sprint retro", "weekly summary", "what went well",
   "end of sprint", or "monthly report". Time-bound reflection on recent work

package/dist/skills/soleri-second-opinion/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-second-opinion
+tier: default
 description: >
   Use when the user says "second opinion", "technical decision",
   "comparing approaches", or "which approach". Provides informed recommendations

package/dist/skills/soleri-subagent-driven-development/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-subagent-driven-development
+tier: default
 description: >
   Use when the user says "use subagents", "parallel agents",
   "subagent driven", or "isolated execution". Decomposes work into isolated

package/dist/skills/soleri-systematic-debugging/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-systematic-debugging
+tier: default
 description: >
   Use as the FIRST response when something is broken — "bug", "failing test",
   "not working", "debug this", "error", "crash", or "weird issue". Diagnoses

package/dist/skills/soleri-test-driven-development/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-test-driven-development
+tier: default
 description: >
   Use when the user says "TDD", "write tests first", "red green refactor",
   or "test driven". Write failing tests before implementation code for any

package/dist/skills/soleri-using-git-worktrees/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-using-git-worktrees
+tier: default
 description: >
   Use when the user says "worktree", "parallel branch", "safe branch",
   or "isolated branch". Provides the protocol for creating, working in,

package/dist/skills/soleri-vault-capture/SKILL.md

@@ -1,11 +1,12 @@
 ---
 name: soleri-vault-capture
+tier: default
 description: >
-  Use when the user says "save this", "capture this", "remember this pattern",
-  "add to vault", "vault capture", or when persisting learnings from a work
-  session. Validated capture with tier scoping, duplicate detection, and
-  abstraction review. For bulk extraction from documents, code, or PRs, use
-  knowledge-harvest instead.
+  Use when the user says "save this to vault", "capture this", "remember this pattern",
+  "add to vault", "vault capture", or when persisting learnings from a work session.
+  Priority over memory_capture for durable knowledge (patterns, decisions, anti-patterns).
+  For quick session notes say "save this as a memory" to use memory_capture instead.
+  For bulk extraction from documents, code, or PRs, use knowledge-harvest.
 ---
 
 # Vault Capture — Validated Knowledge Persistence

package/dist/skills/soleri-vault-curate/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-vault-curate
+tier: default
 description: >
   Use when the user says "clean vault", "deduplicate vault", "groom knowledge",
   "merge patterns", or "vault maintenance". Maintains vault quality through

package/dist/skills/soleri-vault-navigator/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-vault-navigator
+tier: default
 description: >
   Use when the user says "search the vault", "find patterns for",
   "have we seen this before", "vault search", or "best practice for".

package/dist/skills/soleri-vault-smells/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-vault-smells
+tier: default
 description: >
   Use when the user says "vault quality", "vault analysis", "knowledge quality",
   "knowledge debt", "stale patterns", or "find contradictions". Deep knowledge

package/dist/skills/soleri-verification-before-completion/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-verification-before-completion
+tier: default
 description: >
   Use when the user says "verify this works", "check output", "quality gate",
   or "run tests before done". Internal quality gate before claiming any task

package/dist/skills/soleri-writing-plans/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: soleri-writing-plans
+tier: default
 description: >
-  Use when the user says "create a plan", "break this down", or
-  "plan the implementation". Creates structured implementation plans when
-  requirements are already known. For exploration, use brainstorming.
+  Use when the user says "create a plan", "write up a plan", "break this down",
+  or "plan the implementation". Produces a human-readable markdown plan file.
+  Takes priority over orchestrate_plan MCP op for explicit plan-writing requests.
+  For exploration or ideation, use brainstorming. For automated task orchestration,
+  the engine uses orchestrate_plan directly without this skill.
 ---
 
 # Writing Plans

package/dist/skills/soleri-yolo-mode/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-yolo-mode
+tier: default
 description: >
   Use when the user says "yolo", "autonomous", "skip approvals",
   "full auto", or "hands off". Activates autonomous execution mode

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

@@ -62,35 +62,8 @@ export function generateClaudeMdTemplate(config) {
         `On every new session: ${bt}${toolPrefix}_orchestrate op:session_start params:{ projectPath: "." }${bt}`,
         '',
     ];
-    // ─── 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}session_start${bt}, ${bt}activate${bt} |`);
-    // Domain facades — one row per domain
-    for (const d of config.domains) {
-        const toolName = `${toolPrefix}_${d.replace(/-/g, '_')}`;
-        mdLines.push(`| ${bt}${toolName}${bt} | ${bt}get_patterns${bt}, ${bt}search${bt}, ${bt}capture${bt} |`);
-    }
-    // Domain pack facades (if any)
-    if (config.domainPacks?.length) {
-        mdLines.push('', '**Domain Pack Facades:**', '');
-        for (const ref of config.domainPacks) {
-            mdLines.push(`| ${bt}${ref.name}${bt} (pack: ${bt}${ref.package}${bt}) | *custom ops — see ${bt}admin_tool_list${bt}* |`);
-        }
-    }
-    // Engine facades — use actual tool names (standalone facades, NOT _core sub-groups)
-    mdLines.push(
-    // Vault — knowledge lifecycle, capture, search, management
-    `| ${bt}${toolPrefix}_vault${bt} | ${bt}search_intelligent${bt}, ${bt}capture_knowledge${bt}, ${bt}capture_quick${bt}, ${bt}search_feedback${bt} |`, `| ${bt}${toolPrefix}_vault${bt} (keeper) | ${bt}knowledge_audit${bt}, ${bt}knowledge_health${bt}, ${bt}knowledge_merge${bt}, ${bt}knowledge_reorganize${bt} |`, `| ${bt}${toolPrefix}_vault${bt} (mgmt) | ${bt}vault_get${bt}, ${bt}vault_update${bt}, ${bt}vault_remove${bt}, ${bt}vault_tags${bt}, ${bt}vault_domains${bt}, ${bt}vault_recent${bt} |`, 
-    // Curator — quality, dedup, contradictions, grooming
-    `| ${bt}${toolPrefix}_curator${bt} | ${bt}curator_status${bt}, ${bt}curator_detect_duplicates${bt}, ${bt}curator_contradictions${bt}, ${bt}curator_groom_all${bt}, ${bt}curator_consolidate${bt}, ${bt}curator_health_audit${bt} |`, `| ${bt}${toolPrefix}_curator${bt} (advanced) | ${bt}curator_enrich${bt}, ${bt}curator_hybrid_contradictions${bt}, ${bt}curator_entry_history${bt}, ${bt}curator_queue_stats${bt} |`, 
-    // Planning, orchestration, brain
-    `| ${bt}${toolPrefix}_plan${bt} | ${bt}create_plan${bt}, ${bt}approve_plan${bt}, ${bt}plan_split${bt}, ${bt}plan_reconcile${bt}, ${bt}plan_complete_lifecycle${bt} |`, `| ${bt}${toolPrefix}_orchestrate${bt} | ${bt}orchestrate_plan${bt}, ${bt}orchestrate_execute${bt}, ${bt}orchestrate_complete${bt} |`, `| ${bt}${toolPrefix}_brain${bt} | ${bt}brain_stats${bt}, ${bt}brain_feedback${bt}, ${bt}rebuild_vocabulary${bt}, ${bt}brain_strengths${bt}, ${bt}brain_recommend${bt} |`, 
-    // Memory, control, loop
-    `| ${bt}${toolPrefix}_memory${bt} | ${bt}memory_search${bt}, ${bt}memory_capture${bt}, ${bt}session_capture${bt} |`, `| ${bt}${toolPrefix}_control${bt} | ${bt}route_intent${bt}, ${bt}morph${bt}, ${bt}get_behavior_rules${bt}, ${bt}governance_dashboard${bt}, ${bt}governance_policy${bt} |`, `| ${bt}${toolPrefix}_loop${bt} | ${bt}loop_start${bt}, ${bt}loop_iterate${bt}, ${bt}loop_status${bt}, ${bt}loop_cancel${bt} |`, 
-    // Intelligence — context, agency
-    `| ${bt}${toolPrefix}_context${bt} | ${bt}context_extract_entities${bt}, ${bt}context_retrieve_knowledge${bt}, ${bt}context_analyze${bt} |`, `| ${bt}${toolPrefix}_agency${bt} | ${bt}agency_enable${bt}, ${bt}agency_status${bt}, ${bt}agency_surface_patterns${bt}, ${bt}agency_warnings${bt}, ${bt}agency_clarify${bt} |`, 
-    // Admin
-    `| ${bt}${toolPrefix}_admin${bt} | ${bt}admin_health${bt}, ${bt}admin_tool_list${bt}, ${bt}admin_diagnostic${bt} |`);
-    mdLines.push('', `> Full list: ${bt}${toolPrefix}_admin op:admin_tool_list${bt}`, '');
+    // ─── Skill pointer (replaces inline facade table) ───────
+    mdLines.push(`> Command reference: use the ${bt}${toolPrefix}-agent-mode${bt} skill or run ${bt}${toolPrefix}_admin op:admin_tool_list${bt}`, '');
     // ─── Hook Packs (conditional) ──────────────────────────
     appendHookPacks(mdLines, config);
     // ─── Closing marker ────────────────────────────────────

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/package-json.js

@@ -7,6 +7,7 @@ export function generatePackageJson(config) {
         main: 'dist/index.js',
         bin: { [`${config.id}-mcp`]: 'dist/index.js' },
         scripts: {
+            postinstall: 'soleri hooks sync || true',
             dev: 'tsx src/index.ts',
             build: 'tsc && node scripts/copy-assets.js',
             start: 'node dist/index.js',
@@ -37,6 +38,7 @@ export function generatePackageJson(config) {
             '@anthropic-ai/sdk': '^0.39.0',
         },
         devDependencies: {
+            '@soleri/cli': '^9.0.0',
             '@types/node': '^22.13.4',
             '@vitest/coverage-v8': '^3.0.5',
             tsx: '^4.19.2',

package/dist/templates/package-json.js.map

@@ -1 +1 @@
-{"version":3,"file":"package-json.js","sourceRoot":"","sources":["../../src/templates/package-json.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,MAAM,GAAG,GAAG;QACV,IAAI,EAAE,MAAM,CAAC,EAAE;QACf,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,eAAe;QACrB,GAAG,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,eAAe,EAAE;QAC9C,OAAO,EAAE;YACP,GAAG,EAAE,kBAAkB;YACvB,KAAK,EAAE,oCAAoC;YAC3C,KAAK,EAAE,oBAAoB;YAC3B,SAAS,EAAE,cAAc;YACzB,IAAI,EAAE,YAAY;YAClB,YAAY,EAAE,QAAQ;YACtB,eAAe,EAAE,uBAAuB;YACxC,GAAG,CAAC,MAAM,CAAC,QAAQ;gBACjB,CAAC,CAAC;oBACE,gBAAgB,EAAE,kCAAkC;oBACpD,cAAc,EAAE,yBAAyB;iBAC1C;gBACH,CAAC,CAAC,EAAE,CAAC;SACR;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QAC7B,YAAY,EAAE;YACZ,2BAA2B,EAAE,SAAS;YACtC,cAAc,EAAE,QAAQ;YACxB,GAAG,EAAE,SAAS;YACd,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM;gBAC5B,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC;gBAC3F,CAAC,CAAC,EAAE,CAAC;SACR;QACD,oBAAoB,EAAE;YACpB,mBAAmB,EAAE,SAAS;SAC/B;QACD,eAAe,EAAE;YACf,aAAa,EAAE,UAAU;YACzB,qBAAqB,EAAE,QAAQ;YAC/B,GAAG,EAAE,SAAS;YACd,UAAU,EAAE,QAAQ;YACpB,MAAM,EAAE,QAAQ;SACjB;KACF,CAAC;IAEF,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"package-json.js","sourceRoot":"","sources":["../../src/templates/package-json.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,MAAM,GAAG,GAAG;QACV,IAAI,EAAE,MAAM,CAAC,EAAE;QACf,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,eAAe;QACrB,GAAG,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,eAAe,EAAE;QAC9C,OAAO,EAAE;YACP,WAAW,EAAE,2BAA2B;YACxC,GAAG,EAAE,kBAAkB;YACvB,KAAK,EAAE,oCAAoC;YAC3C,KAAK,EAAE,oBAAoB;YAC3B,SAAS,EAAE,cAAc;YACzB,IAAI,EAAE,YAAY;YAClB,YAAY,EAAE,QAAQ;YACtB,eAAe,EAAE,uBAAuB;YACxC,GAAG,CAAC,MAAM,CAAC,QAAQ;gBACjB,CAAC,CAAC;oBACE,gBAAgB,EAAE,kCAAkC;oBACpD,cAAc,EAAE,yBAAyB;iBAC1C;gBACH,CAAC,CAAC,EAAE,CAAC;SACR;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QAC7B,YAAY,EAAE;YACZ,2BAA2B,EAAE,SAAS;YACtC,cAAc,EAAE,QAAQ;YACxB,GAAG,EAAE,SAAS;YACd,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM;gBAC5B,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC;gBAC3F,CAAC,CAAC,EAAE,CAAC;SACR;QACD,oBAAoB,EAAE;YACpB,mBAAmB,EAAE,SAAS;SAC/B;QACD,eAAe,EAAE;YACf,aAAa,EAAE,QAAQ;YACvB,aAAa,EAAE,UAAU;YACzB,qBAAqB,EAAE,QAAQ;YAC/B,GAAG,EAAE,SAAS;YACd,UAAU,EAAE,QAAQ;YACpB,MAAM,EAAE,QAAQ;SACjB;KACF,CAAC;IAEF,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACtC,CAAC"}

package/dist/templates/setup-script.js

@@ -32,72 +32,15 @@ echo "Registering ${config.name} with Claude Code..."
 claude mcp add --scope user "$AGENT_NAME" -- node "$AGENT_DIR/dist/index.js"
 echo "[ok] Registered ${config.name} as MCP server (Claude Code)"
 
-# Configure PreCompact hook for session capture
-SETTINGS_FILE="$HOME/.claude/settings.json"
+# Sync lifecycle hooks into ~/.claude/settings.json
 echo ""
-echo "Configuring Claude session capture hook..."
-
-if [ ! -d "$HOME/.claude" ]; then
-  mkdir -p "$HOME/.claude"
-fi
-
-if [ ! -f "$SETTINGS_FILE" ]; then
-  cat > "$SETTINGS_FILE" << SETTINGS
-{
-  "hooks": {
-    "PreCompact": [
-      {
-        "type": "prompt",
-        "prompt": "Before context is compacted, capture a session summary by calling ${config.id}_core op:session_capture with a brief summary of what was accomplished, the topics covered, files modified, and tools used."
-      }
-    ],
-    "SessionStart": [
-      {
-        "type": "command",
-        "command": "sh $AGENT_DIR/scripts/clean-worktrees.sh",
-        "timeout": 10
-      }
-    ]
-  }
-}
-SETTINGS
-  echo "[ok] Created $SETTINGS_FILE with PreCompact + SessionStart hooks"
+echo "Syncing lifecycle hooks..."
+if command -v soleri &>/dev/null; then
+  soleri hooks sync
 else
-  if grep -q "PreCompact" "$SETTINGS_FILE" 2>/dev/null; then
-    echo "[ok] PreCompact hook already configured — skipping"
-  else
-    node -e "
-      const fs = require('fs');
-      const settings = JSON.parse(fs.readFileSync('$SETTINGS_FILE', 'utf-8'));
-      if (!settings.hooks) settings.hooks = {};
-      if (!settings.hooks.PreCompact) settings.hooks.PreCompact = [];
-      settings.hooks.PreCompact.push({
-        type: 'prompt',
-        prompt: 'Before context is compacted, capture a session summary by calling ${config.id}_core op:session_capture with a brief summary of what was accomplished, the topics covered, files modified, and tools used.'
-      });
-      fs.writeFileSync('$SETTINGS_FILE', JSON.stringify(settings, null, 2) + '\\n');
-    "
-    echo "[ok] Added PreCompact hook to $SETTINGS_FILE"
-  fi
-  # Add SessionStart worktree cleanup hook
-  if grep -q "clean-worktrees" "$SETTINGS_FILE" 2>/dev/null; then
-    echo "[ok] SessionStart worktree cleanup hook already configured"
-  else
-    node -e "
-      const fs = require('fs');
-      const settings = JSON.parse(fs.readFileSync('$SETTINGS_FILE', 'utf-8'));
-      if (!settings.hooks) settings.hooks = {};
-      if (!settings.hooks.SessionStart) settings.hooks.SessionStart = [];
-      settings.hooks.SessionStart.push({
-        type: 'command',
-        command: 'sh $AGENT_DIR/scripts/clean-worktrees.sh',
-        timeout: 10
-      });
-      fs.writeFileSync('$SETTINGS_FILE', JSON.stringify(settings, null, 2) + '\\n');
-    "
-    echo "[ok] Added SessionStart worktree cleanup hook"
-  fi
+  npx --yes soleri hooks sync
 fi
+echo "[ok] Lifecycle hooks synced"
 
 # Install skills to ~/.claude/skills/
 SKILLS_DIR="$AGENT_DIR/skills"

package/dist/templates/setup-script.js.map

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

package/dist/templates/shared-rules.js

@@ -168,12 +168,20 @@ const ENGINE_RULES_LINES = [
     '',
     'The vault is a **Zettelkasten** — a connected knowledge graph. Every knowledge operation follows Zettelkasten principles: atomic entries, typed links, dense connections.',
     '',
-    '- **SHOULD**: Consult the vault BEFORE every decision — search + traverse the link graph.',
-    '- Lookup order: 1) VAULT search → 2) VAULT traverse (follow links 2 hops) → 3) MEMORY → 4) CODEBASE → 5) WEB/TRAINING.',
+    '**SHOULD follow this lookup order for every question, problem, or task — regardless of whether agent MCP is active:**',
+    '',
+    '1. **Vault** — `op:search_intelligent` + traverse links 2 hops (when agent MCP is active)',
+    '2. **Web** — `WebSearch` tool (always — never skip if vault returns no answer)',
+    '3. **Memory** — `op:memory_search` (when agent MCP is active)',
+    '4. **Codebase** — read relevant files',
+    '5. **Training data** — last resort; flag as potentially outdated',
+    '',
+    '- Web search is **not optional**. If vault is unavailable or returns no relevant results, search the web before answering from training data alone.',
+    '- If the vault has a pattern, follow it. If it has an anti-pattern, avoid it.',
     "- **Search + Traverse**: Don't just search — traverse from the best result to discover connected knowledge and anti-patterns.",
     '- Check `contradicts` links to know what to avoid. Check `sequences` links for ordering dependencies.',
     '- Persist lessons: capture + link. An unlinked entry is incomplete.',
-    '- Exceptions: runtime errors with stack traces → codebase first; user explicitly asks to search web.',
+    '- Exception: runtime errors with stack traces → codebase first.',
     '',
     '### Vault Search Strategy',
     '',
@@ -619,7 +627,6 @@ const ENGINE_RULES_LINES = [
     '',
     '### Character Persistence',
     '',
-    '- **SHOULD**: Prefix every response with `{AgentName} >` when activated (e.g., `Ernesto >`, `Salvador >`). This signals to the user that the agent persona is active.',
     "- All communication flows through your persona's voice — tone, vocabulary, opinions",
     '- Stay in character until explicitly deactivated',
     '- Context compaction does not change who you are — these rules persist in CLAUDE.md',