@soleri/forge 9.4.0 → 9.5.0

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

@@ -69,12 +69,12 @@ YOLO mode deactivates when any of these occur:
 
 ## Quick Reference
 
-| Op                    | When to Use                          |
-| --------------------- | ------------------------------------ |
-| `admin_health`        | Verify safety hook pack is installed |
-| `morph`               | Activate/deactivate YOLO mode        |
-| `orchestrate_complete`| After every task (never skip)        |
-| `search_intelligent`  | Before every decision (never skip)   |
-| `plan_reconcile`      | After execution (never skip)         |
+| Op                     | When to Use                          |
+| ---------------------- | ------------------------------------ |
+| `admin_health`         | Verify safety hook pack is installed |
+| `morph`                | Activate/deactivate YOLO mode        |
+| `orchestrate_complete` | After every task (never skip)        |
+| `search_intelligent`   | Before every decision (never skip)   |
+| `plan_reconcile`       | After execution (never skip)         |
 
 **Related skills:** executing-plans, writing-plans

package/dist/templates/shared-rules.js

@@ -407,6 +407,23 @@ const ENGINE_RULES_LINES = [
     "- Results you browse but don't act on",
     '- Duplicate feedback for the same entry in the same task',
     '',
+    // ─── Model Routing Guidance ─────────────────────────────
+    '## Model Routing Guidance',
+    '<!-- soleri:model-routing -->',
+    '',
+    'Different workflow stages benefit from different model strengths. Use this as a default when multiple models are available.',
+    '',
+    '| Stage | Recommended Model | Why |',
+    '|-------|------------------|-----|',
+    '| Research / Exploration | Opus | Cross-file reasoning, broad context synthesis |',
+    '| Planning / Architecture | Opus | Complex tradeoff analysis, alternative evaluation |',
+    '| Implementation | Sonnet | Speed, cost-efficiency for focused coding |',
+    '| Code Review / Verification | Opus | Deep analysis, false-positive filtering |',
+    '| Validation Gates | Haiku | Fast, cheap pass/fail checks |',
+    '| Knowledge Capture | Sonnet | Structured extraction, good enough quality |',
+    '',
+    'This is guidance, not enforcement. Use the best model available. When only one model is available, use it for all stages.',
+    '',
     // ─── Cross-Project Memory ────────────────────────────────
     '## Cross-Project Memory',
     '<!-- soleri:cross-project -->',
@@ -514,6 +531,21 @@ const ENGINE_RULES_LINES = [
     'A PreCompact hook calls `op:session_capture` before context compaction.',
     'Manual capture: `op:session_capture params:{ summary: "..." }`',
     '',
+    '### Handoff Protocol',
+    '',
+    'Before crossing a context window boundary (`/clear`, context compaction, or switching tasks), generate a handoff document:',
+    '',
+    '1. **Before transition**: `op:handoff_generate` — produces a structured markdown document with active plan state, recent decisions, and pending tasks.',
+    '2. **After restart**: Reference the handoff document to restore context. It contains plan IDs, task status, decisions, and next actions.',
+    '',
+    'Handoff documents are **ephemeral** — they are returned as markdown, not persisted to vault or memory. They are a snapshot for context transfer only.',
+    '',
+    '| Trigger | Action |',
+    '|---------|--------|',
+    '| `/clear` or manual reset | `op:handoff_generate` before clearing |',
+    '| Context compaction warning | `op:handoff_generate` (alongside `op:session_capture`) |',
+    '| Switching to a different task mid-plan | `op:handoff_generate` to bookmark state |',
+    '',
     // ─── Soleri CLI ─────────────────────────────────────────
     '## Soleri CLI',
     '<!-- soleri:cli -->',

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;;;;;;;;;GASG;AAEH,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAE5C,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,qBAAqB;IACnC,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,kBAAkB,GAAa;IACnC,QAAQ,aAAa,MAAM;IAC3B,EAAE;IACF,uBAAuB;IACvB,EAAE;IACF,qGAAqG;IACrG,EAAE;IAEF,2DAA2D;IAC3D,mBAAmB;IACnB,gCAAgC;IAChC,EAAE;IACF,2MAA2M;IAC3M,EAAE;IACF,kIAAkI;IAClI,qHAAqH;IACrH,iFAAiF;IACjF,iGAAiG;IACjG,8GAA8G;IAC9G,EAAE;IACF,uBAAuB;IACvB,EAAE;IACF,2EAA2E;IAC3E,EAAE;IACF,4EAA4E;IAC5E,2DAA2D;IAC3D,qDAAqD;IACrD,gFAAgF;IAChF,gEAAgE;IAChE,EAAE;IACF,+BAA+B;IAC/B,EAAE;IACF,iFAAiF;IACjF,EAAE;IACF,oGAAoG;IACpG,oFAAoF;IACpF,wEAAwE;IACxE,EAAE;IACF,oIAAoI;IACpI,EAAE;IAEF,2DAA2D;IAC3D,uBAAuB;IACvB,oCAAoC;IACpC,EAAE;IACF,8FAA8F;IAC9F,uFAAuF;IACvF,EAAE;IAEF,2DAA2D;IAC3D,+BAA+B;IAC/B,wCAAwC;IACxC,EAAE;IACF,+GAA+G;IAC/G,EAAE;IACF,iGAAiG;IACjG,yEAAyE;IACzE,iGAAiG;IACjG,uEAAuE;IACvE,EAAE;IACF,yOAAyO;IACzO,EAAE;IACF,mBAAmB;IACnB,mBAAmB;IACnB,yFAAyF;IACzF,mGAAmG;IACnG,+FAA+F;IAC/F,EAAE;IAEF,0DAA0D;IAC1D,wBAAwB;IACxB,gCAAgC;IAChC,EAAE;IACF,2FAA2F;IAC3F,EAAE;IACF,2GAA2G;IAC3G,+KAA+K;IAC/K,EAAE;IACF,qFAAqF;IACrF,EAAE;IAEF,4DAA4D;IAC5D,4CAA4C;IAC5C,gCAAgC;IAChC,EAAE;IACF,2KAA2K;IAC3K,EAAE;IACF,8FAA8F;IAC9F,wHAAwH;IACxH,+HAA+H;IAC/H,uGAAuG;IACvG,qEAAqE;IACrE,sGAAsG;IACtG,EAAE;IACF,2BAA2B;IAC3B,EAAE;IACF,mHAAmH;IACnH,EAAE;IACF,0BAA0B;IAC1B,0BAA0B;IAC1B,oGAAoG;IACpG,oDAAoD;IACpD,gFAAgF;IAChF,6EAA6E;IAC7E,EAAE;IACF,qIAAqI;IACrI,EAAE;IAEF,4DAA4D;IAC5D,aAAa;IACb,0BAA0B;IAC1B,EAAE;IACF,8IAA8I;IAC9I,+FAA+F;IAC/F,yEAAyE;IACzE,uHAAuH;IACvH,2FAA2F;IAC3F,oFAAoF;IACpF,gFAAgF;IAChF,EAAE;IACF,0BAA0B;IAC1B,EAAE;IACF,iKAAiK;IACjK,EAAE;IACF,sCAAsC;IACtC,qCAAqC;IACrC,4EAA4E;IAC5E,+EAA+E;IAC/E,uFAAuF;IACvF,uFAAuF;IACvF,yFAAyF;IACzF,EAAE;IACF,wGAAwG;IACxG,EAAE;IACF,4HAA4H;IAC5H,EAAE;IACF,iJAAiJ;IACjJ,EAAE;IACF,wHAAwH;IACxH,EAAE;IACF,gBAAgB;IAChB,EAAE;IACF,6GAA6G;IAC7G,EAAE;IACF,wFAAwF;IACxF,8HAA8H;IAC9H,4GAA4G;IAC5G,6EAA6E;IAC7E,EAAE;IACF,sBAAsB;IACtB,EAAE;IACF,mCAAmC;IACnC,mCAAmC;IACnC,mDAAmD;IACnD,2CAA2C;IAC3C,+CAA+C;IAC/C,0DAA0D;IAC1D,4BAA4B;IAC5B,EAAE;IACF,uBAAuB;IACvB,EAAE;IACF,8CAA8C;IAC9C,EAAE;IACF,KAAK;IACL,wBAAwB;IACxB,EAAE;IACF,mBAAmB;IACnB,mBAAmB;IACnB,4BAA4B;IAC5B,8BAA8B;IAC9B,uCAAuC;IACvC,2BAA2B;IAC3B,uCAAuC;IACvC,EAAE;IACF,+BAA+B;IAC/B,EAAE;IACF,YAAY;IACZ,yBAAyB;IACzB,yBAAyB;IACzB,yBAAyB;IACzB,EAAE;IACF,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,qBAAqB;IACrB,KAAK;IACL,EAAE;IACF,wEAAwE;IACxE,EAAE;IACF,kBAAkB;IAClB,EAAE;IACF,KAAK;IACL,mBAAmB;IACnB,mBAAmB;IACnB,wCAAwC;IACxC,+BAA+B;IAC/B,EAAE;IACF,6CAA6C;IAC7C,6CAA6C;IAC7C,kCAAkC;IAClC,KAAK;IACL,EAAE;IAEF,2DAA2D;IAC3D,cAAc;IACd,2BAA2B;IAC3B,EAAE;IACF,sLAAsL;IACtL,EAAE;IACF,kBAAkB;IAClB,EAAE;IACF,4EAA4E;IAC5E,kGAAkG;IAClG,EAAE;IACF,0BAA0B;IAC1B,EAAE;IACF,mFAAmF;IACnF,mFAAmF;IACnF,uCAAuC;IACvC,4DAA4D;IAC5D,EAAE;IACF,mBAAmB;IACnB,EAAE;IACF,oFAAoF;IACpF,4HAA4H;IAC5H,8DAA8D;IAC9D,EAAE;IACF,+BAA+B;IAC/B,EAAE;IACF,qBAAqB;IACrB,qBAAqB;IACrB,yEAAyE;IACzE,yFAAyF;IACzF,EAAE;IAEF,4DAA4D;IAC5D,sBAAsB;IACtB,mCAAmC;IACnC,EAAE;IACF,6EAA6E;IAC7E,EAAE;IACF,qCAAqC;IACrC,KAAK;IACL,kCAAkC;IAClC,kCAAkC;IAClC,2BAA2B;IAC3B,KAAK;IACL,EAAE;IACF,wEAAwE;IACxE,EAAE;IACF,4FAA4F;IAC5F,EAAE;IAEF,4DAA4D;IAC5D,kBAAkB;IAClB,+BAA+B;IAC/B,EAAE;IACF,sDAAsD;IACtD,EAAE;IACF,mBAAmB;IACnB,0CAA0C;IAC1C,2BAA2B;IAC3B,2CAA2C;IAC3C,8EAA8E;IAC9E,EAAE;IACF,2BAA2B;IAC3B,KAAK;IACL,+BAA+B;IAC/B,kCAAkC;IAClC,wCAAwC;IACxC,KAAK;IACL,EAAE;IAEF,2DAA2D;IAC3D,sBAAsB;IACtB,mCAAmC;IACnC,EAAE;IACF,2FAA2F;IAC3F,EAAE;IACF,+CAA+C;IAC/C,+CAA+C;IAC/C,2DAA2D;IAC3D,2DAA2D;IAC3D,oEAAoE;IACpE,6DAA6D;IAC7D,EAAE;IACF,gEAAgE;IAChE,EAAE;IACF,6BAA6B;IAC7B,8BAA8B;IAC9B,6DAA6D;IAC7D,mEAAmE;IACnE,gDAAgD;IAChD,uDAAuD;IACvD,EAAE;IAEF,4DAA4D;IAC5D,sBAAsB;IACtB,8BAA8B;IAC9B,EAAE;IACF,mDAAmD;IACnD,EAAE;IACF,qBAAqB;IACrB,EAAE;IACF,4DAA4D;IAC5D,EAAE;IACF,6CAA6C;IAC7C,6CAA6C;IAC7C,8BAA8B;IAC9B,uCAAuC;IACvC,mCAAmC;IACnC,qDAAqD;IACrD,yDAAyD;IACzD,EAAE;IACF,aAAa;IACb,EAAE;IACF,4EAA4E;IAC5E,sGAAsG;IACtG,EAAE;IACF,6BAA6B;IAC7B,EAAE;IACF,mFAAmF;IACnF,yDAAyD;IACzD,kDAAkD;IAClD,6CAA6C;IAC7C,EAAE;IACF,8FAA8F;IAC9F,EAAE;IACF,oDAAoD;IACpD,EAAE;IACF,uDAAuD;IACvD,qCAAqC;IACrC,+CAA+C;IAC/C,8BAA8B;IAC9B,EAAE;IAEF,4DAA4D;IAC5D,qBAAqB;IACrB,kCAAkC;IAClC,EAAE;IACF,4EAA4E;IAC5E,EAAE;IACF,qBAAqB;IACrB,qBAAqB;IACrB,0DAA0D;IAC1D,yDAAyD;IACzD,oDAAoD;IACpD,uDAAuD;IACvD,wDAAwD;IACxD,mDAAmD;IACnD,EAAE;IACF,iFAAiF;IACjF,EAAE;IAEF,4DAA4D;IAC5D,8BAA8B;IAC9B,iCAAiC;IACjC,EAAE;IACF,gHAAgH;IAChH,uHAAuH;IACvH,EAAE;IACF,mCAAmC;IACnC,oCAAoC;IACpC,2DAA2D;IAC3D,kDAAkD;IAClD,EAAE;IAEF,4DAA4D;IAC5D,wBAAwB;IACxB,uBAAuB;IACvB,EAAE;IACF,2GAA2G;IAC3G,6HAA6H;IAC7H,2FAA2F;IAC3F,EAAE;IACF,2BAA2B;IAC3B,EAAE;IACF,0BAA0B;IAC1B,yBAAyB;IACzB,wKAAwK;IACxK,iJAAiJ;IACjJ,oHAAoH;IACpH,qLAAqL;IACrL,yIAAyI;IACzI,0HAA0H;IAC1H,kHAAkH;IAClH,EAAE;IACF,yBAAyB;IACzB,EAAE;IACF,8GAA8G;IAC9G,sCAAsC;IACtC,+CAA+C;IAC/C,wFAAwF;IACxF,iEAAiE;IACjE,EAAE;IACF,cAAc;IACd,gEAAgE;IAChE,uDAAuD;IACvD,oDAAoD;IACpD,EAAE;IACF,6BAA6B;IAC7B,iEAAiE;IACjE,uCAAuC;IACvC,0DAA0D;IAC1D,EAAE;IAEF,4DAA4D;IAC5D,yBAAyB;IACzB,+BAA+B;IAC/B,EAAE;IACF,wFAAwF;IACxF,iFAAiF;IACjF,EAAE;IAEF,0DAA0D;IAC1D,kBAAkB;IAClB,+BAA+B;IAC/B,EAAE;IACF,wJAAwJ;IACxJ,EAAE;IACF,kOAAkO;IAClO,EAAE;IACF,2BAA2B;IAC3B,EAAE;IACF,4CAA4C;IAC5C,2CAA2C;IAC3C,oJAAoJ;IACpJ,wJAAwJ;IACxJ,wIAAwI;IACxI,kJAAkJ;IAClJ,kHAAkH;IAClH,4HAA4H;IAC5H,0IAA0I;IAC1I,sJAAsJ;IACtJ,mIAAmI;IACnI,oHAAoH;IACpH,EAAE;IACF,oBAAoB;IACpB,EAAE;IACF,mHAAmH;IACnH,EAAE;IACF,qIAAqI;IACrI,EAAE;IAEF,6DAA6D;IAC7D,yCAAyC;IACzC,8BAA8B;IAC9B,EAAE;IACF,iLAAiL;IACjL,EAAE;IACF,gDAAgD;IAChD,EAAE;IACF,wBAAwB;IACxB,0IAA0I;IAC1I,6EAA6E;IAC7E,4FAA4F;IAC5F,iFAAiF;IACjF,wEAAwE;IACxE,4DAA4D;IAC5D,4EAA4E;IAC5E,gFAAgF;IAChF,qHAAqH;IACrH,EAAE;IACF,4BAA4B;IAC5B,EAAE;IACF,0GAA0G;IAC1G,wEAAwE;IACxE,+EAA+E;IAC/E,EAAE;IACF,2BAA2B;IAC3B,EAAE;IACF,0KAA0K;IAC1K,qFAAqF;IACrF,kDAAkD;IAClD,qFAAqF;IACrF,8EAA8E;IAC9E,EAAE;IACF,2CAA2C;IAC3C,oHAAoH;IACpH,EAAE;IACF,gKAAgK;IAChK,4HAA4H;IAC5H,qHAAqH;IACrH,uHAAuH;IACvH,EAAE;IACF,QAAQ;IACR,oEAAoE;IACpE,gGAAgG;IAChG,gEAAgE;IAChE,8FAA8F;IAC9F,0EAA0E;IAC1E,EAAE;IACF,qCAAqC;IACrC,EAAE;IACF,+EAA+E;IAC/E,iDAAiD;IACjD,+CAA+C;IAC/C,gDAAgD;IAChD,2DAA2D;IAC3D,EAAE;IAEF,4DAA4D;IAC5D,sBAAsB;IACtB,yBAAyB;IACzB,EAAE;IACF,4BAA4B;IAC5B,EAAE;IACF,qKAAqK;IACrK,uJAAuJ;IACvJ,yGAAyG;IACzG,EAAE;IACF,wBAAwB;IACxB,EAAE;IACF,yEAAyE;IACzE,gEAAgE;IAChE,EAAE;IAEF,2DAA2D;IAC3D,eAAe;IACf,qBAAqB;IACrB,EAAE;IACF,mJAAmJ;IACnJ,EAAE;IACF,qBAAqB;IACrB,EAAE;IACF,4BAA4B;IAC5B,2BAA2B;IAC3B,uFAAuF;IACvF,gGAAgG;IAChG,kHAAkH;IAClH,kFAAkF;IAClF,mEAAmE;IACnE,8DAA8D;IAC9D,+DAA+D;IAC/D,EAAE;IACF,uBAAuB;IACvB,EAAE;IACF,4BAA4B;IAC5B,2BAA2B;IAC3B,8FAA8F;IAC9F,kFAAkF;IAClF,kFAAkF;IAClF,qDAAqD;IACrD,sEAAsE;IACtE,2EAA2E;IAC3E,+DAA+D;IAC/D,EAAE;IACF,gBAAgB;IAChB,EAAE;IACF,4BAA4B;IAC5B,2BAA2B;IAC3B,4DAA4D;IAC5D,uEAAuE;IACvE,+EAA+E;IAC/E,mEAAmE;IACnE,EAAE;IACF,oBAAoB;IACpB,EAAE;IACF,4BAA4B;IAC5B,2BAA2B;IAC3B,4EAA4E;IAC5E,uFAAuF;IACvF,4DAA4D;IAC5D,uDAAuD;IACvD,2DAA2D;IAC3D,EAAE;IACF,0BAA0B;IAC1B,EAAE;IACF,4BAA4B;IAC5B,2BAA2B;IAC3B,kGAAkG;IAClG,wDAAwD;IACxD,+DAA+D;IAC/D,8FAA8F;IAC9F,mEAAmE;IACnE,EAAE;IACF,kCAAkC;IAClC,EAAE;IACF,2BAA2B;IAC3B,2BAA2B;IAC3B,4FAA4F;IAC5F,6FAA6F;IAC7F,oFAAoF;IACpF,wCAAwC;IACxC,wEAAwE;IACxE,EAAE;IAEF,+DAA+D;IAC/D,wBAAwB;IACxB,qCAAqC;IACrC,EAAE;IACF,6EAA6E;IAC7E,EAAE;IACF,qGAAqG;IACrG,4KAA4K;IAC5K,sHAAsH;IACtH,EAAE;IACF,yBAAyB;IACzB,EAAE;IACF,qBAAqB;IACrB,qBAAqB;IACrB,qEAAqE;IACrE,6DAA6D;IAC7D,6CAA6C;IAC7C,iEAAiE;IACjE,2CAA2C;IAC3C,4DAA4D;IAC5D,0DAA0D;IAC1D,2DAA2D;IAC3D,oDAAoD;IACpD,kDAAkD;IAClD,+CAA+C;IAC/C,EAAE;IACF,8BAA8B;IAC9B,EAAE;IACF,8DAA8D;IAC9D,oCAAoC;IACpC,qDAAqD;IACrD,EAAE;IAEF,8DAA8D;IAC9D,0BAA0B;IAC1B,uCAAuC;IACvC,EAAE;IACF,mEAAmE;IACnE,EAAE;IACF,cAAc;IACd,EAAE;IACF,mDAAmD;IACnD,wEAAwE;IACxE,0DAA0D;IAC1D,EAAE;IACF,mBAAmB;IACnB,EAAE;IACF,uEAAuE;IACvE,uDAAuD;IACvD,yDAAyD;IACzD,6NAA6N;IAC7N,EAAE;IACF,WAAW;IACX,EAAE;IACF,mDAAmD;IACnD,iEAAiE;IACjE,0DAA0D;IAC1D,EAAE;IAEF,SAAS,aAAa,MAAM;CAC7B,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": "9.4.0",
+  "version": "9.5.0",
   "description": "Scaffold AI agents that learn, remember, and grow with you.",
   "keywords": [
     "agent",

package/src/scaffold-filetree.ts

@@ -189,6 +189,48 @@ When reviewing code, auditing quality, or checking for issues.
   - soleri_vault op:search_intelligent
   - soleri_vault op:capture_knowledge
   - soleri_brain op:recommend
+`,
+  },
+  {
+    name: 'context-handoff',
+    prompt: `# Context Handoff
+
+## When to Use
+Before crossing a context window boundary — \`/clear\`, context compaction, or switching tasks mid-plan.
+
+## Steps
+
+### 1. Generate Handoff
+- Call \`op:handoff_generate\` to produce a structured markdown document
+- The document captures: active plan state, recent decisions, pending tasks, session context
+
+### 2. Capture Session (if not auto-captured)
+- Call \`op:session_capture\` to persist session summary to memory
+- The handoff document is ephemeral — session capture provides durable persistence
+
+### 3. Transition
+- Share the handoff markdown with the new context window
+- The new session can reference plan IDs, task status, and decisions from the handoff
+
+### 4. Resume
+- On restart, read the handoff document
+- Use plan IDs to look up active plans: \`op:orchestrate_status\`
+- Continue from where the handoff left off
+`,
+    gates: `gates:
+  - phase: pre-transition
+    requirement: Handoff document generated with current state
+    check: handoff-generated
+
+  - phase: post-transition
+    requirement: New context has loaded handoff and can reference active plans
+    check: context-restored
+`,
+    tools: `tools:
+  - soleri_memory op:handoff_generate
+  - soleri_memory op:session_capture
+  - soleri_orchestrate op:orchestrate_status
+  - soleri_plan op:create_plan
 `,
   },
 ];

package/src/scaffolder.ts

@@ -396,9 +396,11 @@ export function scaffold(config: AgentConfig): ScaffoldResult {
     filesCreated.push(path);
   }
 
-  // Make scripts executable
-  chmodSync(join(agentDir, 'scripts', 'setup.sh'), 0o755);
-  chmodSync(join(agentDir, 'scripts', 'clean-worktrees.sh'), 0o755);
+  // Make scripts executable (skip on Windows — no POSIX permissions)
+  if (process.platform !== 'win32') {
+    chmodSync(join(agentDir, 'scripts', 'setup.sh'), 0o755);
+    chmodSync(join(agentDir, 'scripts', 'clean-worktrees.sh'), 0o755);
+  }
 
   // Write source files
   const sourceFiles: Array<[string, string]> = [
@@ -789,6 +791,11 @@ function createOpencodeLauncher(
   agentId: string,
   agentDir: string,
 ): { created: boolean; path: string; error?: string } {
+  // Launcher scripts and symlinks to /usr/local/bin are Unix-only
+  if (process.platform === 'win32') {
+    return { created: false, path: '', error: 'Launcher scripts are not supported on Windows' };
+  }
+
   const launcherPath = join('/usr', 'local', 'bin', agentId);
   const script = [
     '#!/usr/bin/env bash',

package/src/skills/agent-issues/SKILL.md

@@ -8,7 +8,6 @@ description: >
   structured work items from conversation context.
 ---
 
-
 # Agent-Optimized Issue Creation
 
 Create GitHub issues that AI agents can parse, execute, and verify without ambiguity. Every issue is a self-contained work order — an agent reading it has everything needed to start, execute, and prove completion.
@@ -33,32 +32,40 @@ An agent cannot act on "improve avatar handling." It can act on: "Add PNG upload
 
 ```markdown
 # Objective
+
 <one sentence: what's broken and what "fixed" looks like>
 
 ## Type: bug
+
 ## Component: <package or module name>
+
 ## Priority: P0 | P1 | P2 | P3
 
 ## Context
+
 - Impact: <who/what is affected>
 - Related: <links to issues, PRs, vault entries>
 - First seen: <date or commit>
 
 ## Steps to Reproduce
+
 1. <exact command or action>
 2. <exact command or action>
 3. Observe: <what happens>
 
 ## Expected vs Actual
-| | Behavior |
-|--|----------|
+
+|              | Behavior           |
+| ------------ | ------------------ |
 | **Expected** | <correct behavior> |
-| **Actual** | <broken behavior> |
+| **Actual**   | <broken behavior>  |
 
 ## Error Output
 ```
+
 <paste exact error, stack trace, or log output>
-```
+
+````
 
 ## Root Cause (if known)
 - File: `path/to/file.ts` — `functionName()` or line reference
@@ -85,8 +92,9 @@ An agent cannot act on "improve avatar handling." It can act on: "Add PNG upload
 ```bash
 <exact test command>
 <exact build/lint command>
-```
-```
+````
+
+````
 
 ### Feature
 
@@ -132,14 +140,16 @@ An agent cannot act on "improve avatar handling." It can act on: "Add PNG upload
 ```bash
 <exact test command>
 <exact build command>
-```
+````
 
 ## Definition of Done
+
 - [ ] Acceptance criteria satisfied
 - [ ] `npm test` passes
 - [ ] `npm run typecheck` passes
 - [ ] Changes scoped to "In Scope" only
-```
+
+````
 
 ### Milestone
 
@@ -165,16 +175,16 @@ An agent cannot act on "improve avatar handling." It can act on: "Add PNG upload
 - [ ] All sub-issues closed
 - [ ] Integration test passes end-to-end
 - [ ] <milestone-level verification>
-```
+````
 
 ## Field Guide
 
 ### Writing Good Objectives
 
-| Bad | Good |
-|-----|------|
-| "Fix the login" | "Login returns 401 instead of session token when OAuth callback has valid code" |
-| "Add dark mode" | "Add `prefers-color-scheme` media query support to all semantic color tokens" |
+| Bad                   | Good                                                                            |
+| --------------------- | ------------------------------------------------------------------------------- |
+| "Fix the login"       | "Login returns 401 instead of session token when OAuth callback has valid code" |
+| "Add dark mode"       | "Add `prefers-color-scheme` media query support to all semantic color tokens"   |
 | "Improve performance" | "Reduce cold-start vault search from 800ms to <200ms by lazy-loading FTS index" |
 
 ### Writing Good Acceptance Criteria
@@ -182,9 +192,11 @@ An agent cannot act on "improve avatar handling." It can act on: "Add PNG upload
 Use Given/When/Then for behavioral criteria. Use plain checkboxes for structural criteria.
 
 **Behavioral:**
+
 - [ ] Given a user with valid OAuth code, when POST /auth/callback, then returns 200 with session token
 
 **Structural:**
+
 - [ ] Unit test covers happy path + error case
 - [ ] No new `any` types introduced
 - [ ] Public API documented in JSDoc
@@ -192,6 +204,7 @@ Use Given/When/Then for behavioral criteria. Use plain checkboxes for structural
 ### Writing Good Code Locations
 
 Always include:
+
 1. **File path** — repo-root relative
 2. **Anchor** — function name, class name, route, or config key
 3. **Context** — what the agent should look at there
@@ -228,27 +241,36 @@ When creating issues from a plan, the plan is the source of truth — GitHub iss
 
 ### Plan-Sourced Task Template
 
-```markdown
+````markdown
 # Objective
+
 <one sentence: what this task delivers>
 
 ## Plan: `<plan-id>` | Task <N> of <total>
+
 ## Parent: #<epic-issue-number>
+
 ## Complexity: Low | Medium | High
+
 ## Depends on: <task dependencies or "nothing">
 
 ## Code Locations
+
 - `path/to/file.ts` — `symbolOrFunction`
 
 ## Acceptance Criteria
+
 - [ ] <testable outcome>
 - [ ] <testable outcome>
 - [ ] Tests pass
 
 ## Verification
+
 ```bash
 <exact command>
 ```
+````
+
 ```
 
 ### Rules for Plan-Sourced Issues
@@ -266,3 +288,4 @@ Always apply at least:
 - Type: `bug`, `feature`, `refactor`, `chore`
 - Priority: `P0`, `P1`, `P2`, `P3` (if using priority labels)
 - Component: package or module name (if using component labels)
+```

package/src/skills/discovery-phase/SKILL.md

@@ -30,13 +30,13 @@ Do NOT create a plan, write code, or take any implementation action until the di
 
 For each option:
 
-| Field | Content |
-| ----- | ------- |
+| Field        | Content              |
+| ------------ | -------------------- |
 | **Approach** | One-sentence summary |
-| **Pros** | What it gives us |
-| **Cons** | What it costs |
-| **Risk** | What could go wrong |
-| **Effort** | S / M / L |
+| **Pros**     | What it gives us     |
+| **Cons**     | What it costs        |
+| **Risk**     | What could go wrong  |
+| **Effort**   | S / M / L            |
 
 ## After Discovery
 

package/src/skills/finishing-a-development-branch/SKILL.md

@@ -33,16 +33,16 @@ Verify no uncommitted changes: `git status` should be clean. Commit or stash bef
    - **Reviewers**: add if the user specifies or the repo has CODEOWNERS
    - **Labels/milestone**: add if relevant
 
-Keep the description focused on *why* the change exists, not a file-by-file diff recap.
+Keep the description focused on _why_ the change exists, not a file-by-file diff recap.
 
 ## Step 3: Squash vs Merge Commit
 
-| Signal | Strategy | Rationale |
-|--------|----------|-----------|
-| Many WIP/fixup commits | **Squash** | Clean history, one logical change |
-| Each commit is a meaningful unit | **Merge commit** | Preserves granular history |
-| Single commit on branch | Either | No difference |
-| Team convention exists | **Follow it** | Consistency wins |
+| Signal                           | Strategy         | Rationale                         |
+| -------------------------------- | ---------------- | --------------------------------- |
+| Many WIP/fixup commits           | **Squash**       | Clean history, one logical change |
+| Each commit is a meaningful unit | **Merge commit** | Preserves granular history        |
+| Single commit on branch          | Either           | No difference                     |
+| Team convention exists           | **Follow it**    | Consistency wins                  |
 
 Default to **squash** unless the user or repo convention says otherwise.
 

package/src/skills/mcp-doctor/SKILL.md

@@ -19,6 +19,7 @@ cat .mcp.json
 ```
 
 For each server entry, record:
+
 - Server name
 - Command (`command` field)
 - Arguments (`args` field)
@@ -41,11 +42,13 @@ If the binary is missing, report it and suggest installation.
 ### 2b. Entry point exists?
 
 For `node` commands, check the script file exists:
+
 ```bash
 ls -la <args[0]>
 ```
 
 For `npx`/`uvx` commands, check the package resolves:
+
 ```bash
 npx --yes <package> --help 2>&1 | head -5
 # or
@@ -63,6 +66,7 @@ kill %1 2>/dev/null
 ```
 
 Look for:
+
 - Startup success messages (e.g. "Starting MCP server", "tools loaded")
 - Error messages (missing dependencies, port conflicts, config errors)
 - Crash/exit codes
@@ -80,6 +84,7 @@ If a stale process holds the port, report the PID and suggest killing it.
 ### 2e. Dependencies met?
 
 For Node.js servers, check if `node_modules` exist:
+
 ```bash
 ls <cwd>/node_modules/.package-lock.json 2>/dev/null
 ```
@@ -92,15 +97,15 @@ For Python (uvx) servers, the virtual env is managed by uvx — check if the pac
 
 For each issue found, apply the appropriate fix:
 
-| Issue | Fix |
-|-------|-----|
-| Binary not found | Suggest install command |
-| Entry point missing | `npm run build` or check path |
-| Port conflict (stale process) | `kill <PID>` (ask user first) |
-| Missing node_modules | `npm install` in the right directory |
-| Config error in .mcp.json | Show the fix, apply with user approval |
-| Package resolution failure | Clear cache, retry install |
-| Server crashes on start | Show error log, diagnose root cause |
+| Issue                         | Fix                                    |
+| ----------------------------- | -------------------------------------- |
+| Binary not found              | Suggest install command                |
+| Entry point missing           | `npm run build` or check path          |
+| Port conflict (stale process) | `kill <PID>` (ask user first)          |
+| Missing node_modules          | `npm install` in the right directory   |
+| Config error in .mcp.json     | Show the fix, apply with user approval |
+| Package resolution failure    | Clear cache, retry install             |
+| Server crashes on start       | Show error log, diagnose root cause    |
 
 **IMPORTANT:** Never kill processes without user confirmation. Always show the PID and process name first.
 
@@ -109,6 +114,7 @@ For each issue found, apply the appropriate fix:
 After repairs, instruct the user:
 
 > Repairs complete. Please restart MCP connections:
+>
 > 1. Type `/mcp` in the prompt
 > 2. Toggle the repaired server(s) off and back on
 > 3. Verify tools appear with a ToolSearch
@@ -145,10 +151,10 @@ Present findings as a table:
 
 ## Quick Reference
 
-| Check | Command | What it tells you |
-|-------|---------|-------------------|
-| Binary exists | `which <cmd>` | Is the runtime installed? |
-| Script exists | `ls <path>` | Is the entry point built? |
-| Port free | `lsof -i :<port>` | Is something blocking the port? |
-| Deps installed | `ls node_modules` | Are npm packages present? |
-| Server starts | `timeout 10 <cmd>` | Does initialization succeed? |
+| Check          | Command            | What it tells you               |
+| -------------- | ------------------ | ------------------------------- |
+| Binary exists  | `which <cmd>`      | Is the runtime installed?       |
+| Script exists  | `ls <path>`        | Is the entry point built?       |
+| Port free      | `lsof -i :<port>`  | Is something blocking the port? |
+| Deps installed | `ls node_modules`  | Are npm packages present?       |
+| Server starts  | `timeout 10 <cmd>` | Does initialization succeed?    |

package/src/skills/subagent-driven-development/SKILL.md

@@ -14,14 +14,14 @@ Decompose work into isolated units, dispatch subagents via the Agent tool, merge
 
 ## When to Dispatch
 
-| Signal | Dispatch? |
-|--------|-----------|
+| Signal                                        | Dispatch?                                |
+| --------------------------------------------- | ---------------------------------------- |
 | 2+ independent tasks touching different files | Yes — no conflict risk, parallel speedup |
-| Risky/experimental work (spike, prototype) | Yes — isolate blast radius in a worktree |
-| Large refactor across unrelated modules | Yes — each module is a clean unit |
-| Single-file change or trivial fix | **No** — overhead exceeds benefit |
-| Tasks with sequential dependencies | **No** — cannot parallelize |
-| Tasks modifying the same file | **No** — guaranteed merge conflicts |
+| Risky/experimental work (spike, prototype)    | Yes — isolate blast radius in a worktree |
+| Large refactor across unrelated modules       | Yes — each module is a clean unit        |
+| Single-file change or trivial fix             | **No** — overhead exceeds benefit        |
+| Tasks with sequential dependencies            | **No** — cannot parallelize              |
+| Tasks modifying the same file                 | **No** — guaranteed merge conflicts      |
 
 ## The Process
 
@@ -42,12 +42,14 @@ Launch all independent subagents in a **single message** so they run in parallel
 ### Step 3: Review and Merge
 
 For each returning subagent:
+
 1. **Review** — read actual file changes (do not trust self-reports alone), verify tests pass, check scope compliance
 2. **Merge** — `git merge` or `git cherry-pick` from the worktree branch, one at a time
 3. **Test** — run the full suite after each merge; only proceed if green
 4. **Conflicts** — resolve manually, re-run tests, capture as anti-pattern for future planning
 
 After all merges, capture learnings:
+
 ```
 YOUR_AGENT_core op:capture_quick params:{
   title: "subagent dispatch outcome",
@@ -57,21 +59,21 @@ YOUR_AGENT_core op:capture_quick params:{
 
 ## Anti-Patterns
 
-| Anti-Pattern | Why It Fails |
-|-------------|--------------|
-| Dispatching for a 5-line fix | Startup overhead exceeds the work |
-| Parallel dispatch of dependent tasks | Second agent works on stale assumptions |
-| Skipping worktree isolation for nearby files | Silent overwrites between agents |
-| Trusting self-reports without reading code | Agents miss edge cases or misunderstand scope |
-| Dispatching 10+ agents at once | Review bottleneck shifts to the controller |
+| Anti-Pattern                                 | Why It Fails                                  |
+| -------------------------------------------- | --------------------------------------------- |
+| Dispatching for a 5-line fix                 | Startup overhead exceeds the work             |
+| Parallel dispatch of dependent tasks         | Second agent works on stale assumptions       |
+| Skipping worktree isolation for nearby files | Silent overwrites between agents              |
+| Trusting self-reports without reading code   | Agents miss edge cases or misunderstand scope |
+| Dispatching 10+ agents at once               | Review bottleneck shifts to the controller    |
 
 ## Merge Strategy
 
-| Situation | Strategy |
-|-----------|----------|
-| Completely separate directories | Fast-forward merge, no conflicts expected |
-| Different files in the same package | Merge one by one, test after each |
-| Unexpected conflict | Resolve manually, re-run tests, capture as anti-pattern |
-| Subagent result fails review | Dispatch fix subagent into same worktree (max 2 retries) |
+| Situation                           | Strategy                                                 |
+| ----------------------------------- | -------------------------------------------------------- |
+| Completely separate directories     | Fast-forward merge, no conflicts expected                |
+| Different files in the same package | Merge one by one, test after each                        |
+| Unexpected conflict                 | Resolve manually, re-run tests, capture as anti-pattern  |
+| Subagent result fails review        | Dispatch fix subagent into same worktree (max 2 retries) |
 
 **Related skills:** parallel-execute, executing-plans, verification-before-completion

package/src/skills/using-git-worktrees/SKILL.md

@@ -60,6 +60,7 @@ git worktree list                      # confirm removal
 ```
 
 ## Anti-Patterns
+
 - Creating worktrees for single-file changes or one-liner fixes
 - Leaving orphan worktrees after tasks complete — always clean up
 - Deleting the worktree directory manually instead of `git worktree remove`
@@ -68,13 +69,13 @@ git worktree list                      # confirm removal
 
 ## Quick Reference
 
-| Action           | Command                                          |
-| ---------------- | ------------------------------------------------ |
-| Create           | `git worktree add ../<name> -b <branch>`         |
-| List             | `git worktree list`                              |
-| Remove           | `git worktree remove ../<name>`                  |
-| Prune            | `git worktree prune`                             |
-| Check unpushed   | `git log origin/<branch>..<branch>`              |
-| Claude Code      | Sub-agent with `isolation: "worktree"` parameter |
+| Action         | Command                                          |
+| -------------- | ------------------------------------------------ |
+| Create         | `git worktree add ../<name> -b <branch>`         |
+| List           | `git worktree list`                              |
+| Remove         | `git worktree remove ../<name>`                  |
+| Prune          | `git worktree prune`                             |
+| Check unpushed | `git log origin/<branch>..<branch>`              |
+| Claude Code    | Sub-agent with `isolation: "worktree"` parameter |
 
 **Related skills:** executing-plans, parallel-execute

package/src/skills/yolo-mode/SKILL.md

@@ -69,12 +69,12 @@ YOLO mode deactivates when any of these occur:
 
 ## Quick Reference
 
-| Op                    | When to Use                          |
-| --------------------- | ------------------------------------ |
-| `admin_health`        | Verify safety hook pack is installed |
-| `morph`               | Activate/deactivate YOLO mode        |
-| `orchestrate_complete`| After every task (never skip)        |
-| `search_intelligent`  | Before every decision (never skip)   |
-| `plan_reconcile`      | After execution (never skip)         |
+| Op                     | When to Use                          |
+| ---------------------- | ------------------------------------ |
+| `admin_health`         | Verify safety hook pack is installed |
+| `morph`                | Activate/deactivate YOLO mode        |
+| `orchestrate_complete` | After every task (never skip)        |
+| `search_intelligent`   | Before every decision (never skip)   |
+| `plan_reconcile`       | After execution (never skip)         |
 
 **Related skills:** executing-plans, writing-plans