@soleri/forge 5.2.0 → 5.5.0

package/dist/templates/readme.js

@@ -80,6 +80,44 @@ ${domainRows}
 
 ${principleLines}
 
+## Built-in Skills
+
+${config.name} ships with 17 structured workflow skills, invocable via \`/<skill-name>\` in Claude Code:
+
+**Development Workflows:**
+
+| Skill | Description |
+|-------|-------------|
+| \`/test-driven-development\` | Red-green-refactor TDD workflow with vault-informed test patterns |
+| \`/systematic-debugging\` | Root cause investigation — vault search, web search, then diagnose |
+| \`/verification-before-completion\` | Evidence-based completion claims with system diagnostics |
+| \`/brainstorming\` | Collaborative design exploration with vault + web research first |
+| \`/writing-plans\` | Implementation plans with quality grading and auto-improvement |
+| \`/executing-plans\` | Batch execution with loop tracking and plan reconciliation |
+| \`/fix-and-learn\` | Fix bugs and capture root cause — vault search before any fix |
+| \`/code-patrol\` | Review code against YOUR vault patterns, not generic lint rules |
+
+**Knowledge Management:**
+
+| Skill | Description |
+|-------|-------------|
+| \`/vault-navigator\` | Intelligent vault search — tags, domains, age reports, cross-project |
+| \`/vault-capture\` | Persist knowledge with curator grooming and governance |
+| \`/knowledge-harvest\` | Point at any doc/code — auto-extract patterns into vault |
+| \`/brain-debrief\` | Intelligence report — strengths, gaps, cross-project insights |
+
+**Magic UX:**
+
+| Skill | Description |
+|-------|-------------|
+| \`/context-resume\` | "What was I working on?" — full context reconstruction |
+| \`/second-opinion\` | Decision support from vault + brain + web combined |
+| \`/retrospective\` | Data-driven sprint/week retro from actual metrics |
+| \`/onboard-me\` | Instant project knowledge tour for newcomers |
+| \`/health-check\` | Vault maintenance — duplicates, contradictions, stale entries |
+
+Skills are installed to \`~/.claude/commands/\` during setup. Run \`./scripts/setup.sh\` to install or reinstall.
+
 ## Features
 
 ### Knowledge Vault

package/dist/templates/readme.js.map

@@ -1 +1 @@
-{"version":3,"file":"readme.js","sourceRoot":"","sources":["../../src/templates/readme.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,oCAAoC,CAAC;SACtD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEzE,OAAO,KAAK,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,IAAI;;EAExC,MAAM,CAAC,WAAW;;SAEX,MAAM,CAAC,IAAI;;;;EAIlB,MAAM,CAAC,IAAI;;;;;;;6EAOgE,MAAM,CAAC,IAAI;;;;;;KAMnF,MAAM,CAAC,EAAE;;;;;;;;eAQC,MAAM,CAAC,IAAI;;;aAGb,MAAM,CAAC,IAAI;;;;;;;uCAOe,MAAM,CAAC,IAAI;;KAE7C,MAAM,CAAC,IAAI;uBACO,MAAM,CAAC,IAAI;KAC7B,MAAM,CAAC,IAAI;;;;;;;;;;OAUT,MAAM,CAAC,EAAE;;;kCAGkB,MAAM,CAAC,EAAE;;;;;;;;;;;;EAYzC,UAAU;;;;EAIV,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+BF,MAAM,CAAC,EAAE;;;;;;;;;;sCAUe,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;cAejC,MAAM,CAAC,IAAI,8CAA8C,MAAM,CAAC,IAAI;gBAClE,MAAM,CAAC,IAAI;;;;eAIZ,MAAM,CAAC,IAAI;;yBAED,MAAM,CAAC,IAAI;;;EAGlC,MAAM,CAAC,IAAI;;;8EAGiE,MAAM,CAAC,IAAI;;;EAGvF,MAAM,CAAC,IAAI;;;+CAGkC,MAAM,CAAC,IAAI;;;EAGxD,MAAM,CAAC,IAAI;;;;;;;;2BAQc,MAAM,CAAC,IAAI;;;EAGpC,MAAM,CAAC,IAAI;;;;;;EAMX,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;EAgBX,MAAM,CAAC,IAAI;;;;0BAIa,MAAM,CAAC,IAAI;;;;;;EAMnC,MAAM,CAAC,IAAI;;;;;;;mJAOsI,MAAM,CAAC,IAAI;;;;;;;EAO5J,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CX,MAAM,CAAC,IAAI;;;;;sCAKyB,MAAM,CAAC,IAAI;;;2CAGN,MAAM,CAAC,IAAI;;;;EAIpD,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCZ,CAAC;AACF,CAAC"}
+{"version":3,"file":"readme.js","sourceRoot":"","sources":["../../src/templates/readme.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,oCAAoC,CAAC;SACtD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEzE,OAAO,KAAK,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,IAAI;;EAExC,MAAM,CAAC,WAAW;;SAEX,MAAM,CAAC,IAAI;;;;EAIlB,MAAM,CAAC,IAAI;;;;;;;6EAOgE,MAAM,CAAC,IAAI;;;;;;KAMnF,MAAM,CAAC,EAAE;;;;;;;;eAQC,MAAM,CAAC,IAAI;;;aAGb,MAAM,CAAC,IAAI;;;;;;;uCAOe,MAAM,CAAC,IAAI;;KAE7C,MAAM,CAAC,IAAI;uBACO,MAAM,CAAC,IAAI;KAC7B,MAAM,CAAC,IAAI;;;;;;;;;;OAUT,MAAM,CAAC,EAAE;;;kCAGkB,MAAM,CAAC,EAAE;;;;;;;;;;;;EAYzC,UAAU;;;;EAIV,cAAc;;;;EAId,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAiEC,MAAM,CAAC,EAAE;;;;;;;;;;sCAUe,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;cAejC,MAAM,CAAC,IAAI,8CAA8C,MAAM,CAAC,IAAI;gBAClE,MAAM,CAAC,IAAI;;;;eAIZ,MAAM,CAAC,IAAI;;yBAED,MAAM,CAAC,IAAI;;;EAGlC,MAAM,CAAC,IAAI;;;8EAGiE,MAAM,CAAC,IAAI;;;EAGvF,MAAM,CAAC,IAAI;;;+CAGkC,MAAM,CAAC,IAAI;;;EAGxD,MAAM,CAAC,IAAI;;;;;;;;2BAQc,MAAM,CAAC,IAAI;;;EAGpC,MAAM,CAAC,IAAI;;;;;;EAMX,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;EAgBX,MAAM,CAAC,IAAI;;;;0BAIa,MAAM,CAAC,IAAI;;;;;;EAMnC,MAAM,CAAC,IAAI;;;;;;;mJAOsI,MAAM,CAAC,IAAI;;;;;;;EAO5J,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CX,MAAM,CAAC,IAAI;;;;;sCAKyB,MAAM,CAAC,IAAI;;;2CAGN,MAAM,CAAC,IAAI;;;;EAIpD,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCZ,CAAC;AACF,CAAC"}

package/dist/templates/setup-script.js

@@ -99,7 +99,58 @@ else
   fi
 fi
 
-echo ""
+# Install skills to ~/.claude/commands/
+SKILLS_DIR="$AGENT_DIR/skills"
+COMMANDS_DIR="$HOME/.claude/commands"
+
+if [ -d "$SKILLS_DIR" ]; then
+  echo ""
+  echo "Installing skills..."
+  mkdir -p "$COMMANDS_DIR"
+  skill_installed=0
+  skill_skipped=0
+  for skill_dir in "$SKILLS_DIR"/*/; do
+    [ -d "$skill_dir" ] || continue
+    skill_file="$skill_dir/SKILL.md"
+    [ -f "$skill_file" ] || continue
+    skill_name="$(basename "$skill_dir")"
+    dest="$COMMANDS_DIR/$skill_name.md"
+    if [ -f "$dest" ]; then
+      skill_skipped=$((skill_skipped + 1))
+    else
+      cp "$skill_file" "$dest"
+      skill_installed=$((skill_installed + 1))
+    fi
+  done
+  echo "[ok] Skills: $skill_installed installed, $skill_skipped already present"
+fi
+
+${config.hookPacks?.length
+        ? `# Install hook packs to global ~/.claude/
+AGENT_CLAUDE_DIR="$AGENT_DIR/.claude"
+GLOBAL_CLAUDE_DIR="$HOME/.claude"
+
+if [ -d "$AGENT_CLAUDE_DIR" ]; then
+  echo ""
+  echo "Installing hook packs..."
+  mkdir -p "$GLOBAL_CLAUDE_DIR"
+  installed=0
+  skipped=0
+  for hook_file in "$AGENT_CLAUDE_DIR"/hookify.*.local.md; do
+    [ -f "$hook_file" ] || continue
+    dest="$GLOBAL_CLAUDE_DIR/$(basename "$hook_file")"
+    if [ -f "$dest" ]; then
+      skipped=$((skipped + 1))
+    else
+      cp "$hook_file" "$dest"
+      installed=$((installed + 1))
+    fi
+  done
+  echo "[ok] Hooks: $installed installed, $skipped already present"
+fi
+
+`
+        : ''}echo ""
 echo "=== Setup Complete ==="
 echo ""
 echo "Next:"

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

@@ -1 +1 @@
-{"version":3,"file":"setup-script.js","sourceRoot":"","sources":["../../src/templates/setup-script.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,OAAO;;;;cAIK,MAAM,CAAC,EAAE;;YAEX,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;mBAmBJ,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;gCAeE,MAAM,CAAC,IAAI;;;;;;;;oBAQvB,MAAM,CAAC,IAAI;;;wBAGP,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;uFAkBoD,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;qFAmBX,MAAM,CAAC,EAAE;;;;;;;;;;;;;4BAalE,MAAM,CAAC,IAAI;;QAE/B,MAAM,CAAC,IAAI;CAClB,CAAC;AACF,CAAC"}
+{"version":3,"file":"setup-script.js","sourceRoot":"","sources":["../../src/templates/setup-script.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,OAAO;;;;cAIK,MAAM,CAAC,EAAE;;YAEX,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;mBAmBJ,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;gCAeE,MAAM,CAAC,IAAI;;;;;;;;oBAQvB,MAAM,CAAC,IAAI;;;wBAGP,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;uFAkBoD,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;qFAmBX,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmC5F,MAAM,CAAC,SAAS,EAAE,MAAM;QACtB,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;CAuBL;QACG,CAAC,CAAC,EACN;;;;;4BAK4B,MAAM,CAAC,IAAI;;QAE/B,MAAM,CAAC,IAAI;CAClB,CAAC;AACF,CAAC"}

package/dist/templates/skills.d.ts

@@ -0,0 +1,16 @@
+import type { AgentConfig } from '../types.js';
+/**
+ * Generate skill files for the scaffolded agent.
+ * Returns [relativePath, content] tuples for each skill.
+ *
+ * - Superpowers-adapted skills (MIT): copied as-is
+ * - Engine-adapted skills: YOUR_AGENT_core → {config.id}_core
+ */
+export declare function generateSkills(config: AgentConfig): Array<[string, string]>;
+/**
+ * List all bundled skill names with their descriptions (from YAML frontmatter).
+ */
+export declare function listSkillDescriptions(): Array<{
+    name: string;
+    description: string;
+}>;

package/dist/templates/skills.js

@@ -0,0 +1,73 @@
+import { readFileSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SKILLS_DIR = join(__dirname, '..', 'skills');
+/** Skills that use YOUR_AGENT_core placeholder and need agent-specific substitution. */
+const AGENT_SPECIFIC_SKILLS = new Set([
+    'brain-debrief',
+    'brainstorming',
+    'code-patrol',
+    'context-resume',
+    'executing-plans',
+    'fix-and-learn',
+    'health-check',
+    'knowledge-harvest',
+    'onboard-me',
+    'retrospective',
+    'second-opinion',
+    'systematic-debugging',
+    'test-driven-development',
+    'vault-capture',
+    'vault-navigator',
+    'verification-before-completion',
+    'writing-plans',
+]);
+/**
+ * Generate skill files for the scaffolded agent.
+ * Returns [relativePath, content] tuples for each skill.
+ *
+ * - Superpowers-adapted skills (MIT): copied as-is
+ * - Engine-adapted skills: YOUR_AGENT_core → {config.id}_core
+ */
+export function generateSkills(config) {
+    const files = [];
+    let skillFiles;
+    try {
+        skillFiles = readdirSync(SKILLS_DIR).filter((f) => f.endsWith('.md'));
+    }
+    catch {
+        return files;
+    }
+    for (const file of skillFiles) {
+        const skillName = file.replace('.md', '');
+        let content = readFileSync(join(SKILLS_DIR, file), 'utf-8');
+        if (AGENT_SPECIFIC_SKILLS.has(skillName)) {
+            content = content.replace(/YOUR_AGENT_core/g, `${config.id}_core`);
+        }
+        files.push([`skills/${skillName}/SKILL.md`, content]);
+    }
+    return files;
+}
+/**
+ * List all bundled skill names with their descriptions (from YAML frontmatter).
+ */
+export function listSkillDescriptions() {
+    let skillFiles;
+    try {
+        skillFiles = readdirSync(SKILLS_DIR).filter((f) => f.endsWith('.md'));
+    }
+    catch {
+        return [];
+    }
+    return skillFiles.map((file) => {
+        const content = readFileSync(join(SKILLS_DIR, file), 'utf-8');
+        const nameMatch = content.match(/^name:\s*(.+)$/m);
+        const descMatch = content.match(/^description:\s*"?(.+?)"?\s*$/m);
+        return {
+            name: nameMatch?.[1]?.trim() ?? file.replace('.md', ''),
+            description: descMatch?.[1]?.trim() ?? '',
+        };
+    });
+}
+//# sourceMappingURL=skills.js.map

package/dist/templates/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/templates/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAEnD,wFAAwF;AACxF,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,eAAe;IACf,eAAe;IACf,aAAa;IACb,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,cAAc;IACd,mBAAmB;IACnB,YAAY;IACZ,eAAe;IACf,gBAAgB;IAChB,sBAAsB;IACtB,yBAAyB;IACzB,eAAe;IACf,iBAAiB;IACjB,gCAAgC;IAChC,eAAe;CAChB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,IAAI,UAAoB,CAAC;IAEzB,IAAI,CAAC;QACH,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAE5D,IAAI,qBAAqB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;QACrE,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,SAAS,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,UAAoB,CAAC;IAEzB,IAAI,CAAC;QACH,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAClE,OAAO;YACL,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YACvD,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;SAC1C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/templates/test-facades.js

@@ -123,6 +123,29 @@ ${domainDescribes}
             if (stats.totalEntries === 0) {
               recommendations.push('Vault is empty');
             }
+            // Check hook status
+            const { readdirSync } = await import('node:fs');
+            const agentClaudeDir = joinPath(__dirname, '..', '.claude');
+            const globalClaudeDir = joinPath(homedir(), '.claude');
+            const hookStatus = { agent: [] as string[], global: [] as string[], missing: [] as string[] };
+            if (exists(agentClaudeDir)) {
+              try {
+                const agentHooks = readdirSync(agentClaudeDir)
+                  .filter((f: string) => f.startsWith('hookify.') && f.endsWith('.local.md'))
+                  .map((f: string) => f.replace('hookify.', '').replace('.local.md', ''));
+                hookStatus.agent = agentHooks;
+                for (const hook of agentHooks) {
+                  if (exists(joinPath(globalClaudeDir, \`hookify.\${hook}.local.md\`))) {
+                    hookStatus.global.push(hook);
+                  } else {
+                    hookStatus.missing.push(hook);
+                  }
+                }
+              } catch { /* ignore */ }
+            }
+            if (hookStatus.missing.length > 0) {
+              recommendations.push(\`\${hookStatus.missing.length} hook(s) not installed globally — run scripts/setup.sh\`);
+            }
             if (recommendations.length === 0) {
               recommendations.push('${config.name} is fully set up and ready!');
             }
@@ -133,6 +156,7 @@ ${domainDescribes}
                 global: { exists: exists(globalClaudeMd), has_agent_section: hasAgentMarker(globalClaudeMd) },
               },
               vault: { entries: stats.totalEntries, domains: Object.keys(stats.byDomain) },
+              hooks: hookStatus,
               recommendations,
             };
           },
@@ -169,6 +193,10 @@ ${domainDescribes}
       expect(opNames).toContain('brain_archive_sessions');
       expect(opNames).toContain('brain_promote_proposals');
       expect(opNames).toContain('brain_lifecycle');
+      // Enhanced brain ops (3)
+      expect(opNames).toContain('brain_feedback');
+      expect(opNames).toContain('brain_feedback_stats');
+      expect(opNames).toContain('brain_reset_extracted');
       // Agent-specific ops (5)
       expect(opNames).toContain('health');
       expect(opNames).toContain('identity');
@@ -184,8 +212,122 @@ ${domainDescribes}
       expect(opNames).toContain('route_intent');
       expect(opNames).toContain('morph');
       expect(opNames).toContain('get_behavior_rules');
-      // Total: 50
-      expect(facade.ops.length).toBe(50);
+      // Cognee ops (5)
+      expect(opNames).toContain('cognee_status');
+      expect(opNames).toContain('cognee_search');
+      expect(opNames).toContain('cognee_add');
+      expect(opNames).toContain('cognee_cognify');
+      expect(opNames).toContain('cognee_config');
+      // LLM ops (2)
+      expect(opNames).toContain('llm_rotate');
+      expect(opNames).toContain('llm_call');
+      // Governance ops (5)
+      expect(opNames).toContain('governance_policy');
+      expect(opNames).toContain('governance_proposals');
+      expect(opNames).toContain('governance_stats');
+      expect(opNames).toContain('governance_expire');
+      expect(opNames).toContain('governance_dashboard');
+      // Planning Extra ops (9)
+      expect(opNames).toContain('plan_iterate');
+      expect(opNames).toContain('plan_split');
+      expect(opNames).toContain('plan_reconcile');
+      expect(opNames).toContain('plan_complete_lifecycle');
+      expect(opNames).toContain('plan_dispatch');
+      expect(opNames).toContain('plan_review');
+      expect(opNames).toContain('plan_archive');
+      expect(opNames).toContain('plan_list_tasks');
+      expect(opNames).toContain('plan_stats');
+      // Memory Extra ops (8)
+      expect(opNames).toContain('memory_delete');
+      expect(opNames).toContain('memory_stats');
+      expect(opNames).toContain('memory_export');
+      expect(opNames).toContain('memory_import');
+      expect(opNames).toContain('memory_prune');
+      expect(opNames).toContain('memory_deduplicate');
+      expect(opNames).toContain('memory_topics');
+      expect(opNames).toContain('memory_by_project');
+      // Vault Extra ops (12)
+      expect(opNames).toContain('vault_get');
+      expect(opNames).toContain('vault_update');
+      expect(opNames).toContain('vault_remove');
+      expect(opNames).toContain('vault_bulk_add');
+      expect(opNames).toContain('vault_bulk_remove');
+      expect(opNames).toContain('vault_tags');
+      expect(opNames).toContain('vault_domains');
+      expect(opNames).toContain('vault_recent');
+      expect(opNames).toContain('vault_import');
+      expect(opNames).toContain('vault_seed');
+      expect(opNames).toContain('vault_backup');
+      expect(opNames).toContain('vault_age_report');
+      // Admin ops (8)
+      expect(opNames).toContain('admin_health');
+      expect(opNames).toContain('admin_tool_list');
+      expect(opNames).toContain('admin_config');
+      expect(opNames).toContain('admin_vault_size');
+      expect(opNames).toContain('admin_uptime');
+      expect(opNames).toContain('admin_version');
+      expect(opNames).toContain('admin_reset_cache');
+      expect(opNames).toContain('admin_diagnostic');
+      // Loop ops (7)
+      expect(opNames).toContain('loop_start');
+      expect(opNames).toContain('loop_iterate');
+      expect(opNames).toContain('loop_status');
+      expect(opNames).toContain('loop_cancel');
+      expect(opNames).toContain('loop_history');
+      expect(opNames).toContain('loop_is_active');
+      expect(opNames).toContain('loop_complete');
+      // Orchestrate ops (5)
+      expect(opNames).toContain('orchestrate_plan');
+      expect(opNames).toContain('orchestrate_execute');
+      expect(opNames).toContain('orchestrate_complete');
+      expect(opNames).toContain('orchestrate_status');
+      expect(opNames).toContain('orchestrate_quick_capture');
+      // Capture ops (4)
+      expect(opNames).toContain('capture_knowledge');
+      expect(opNames).toContain('capture_quick');
+      expect(opNames).toContain('search_intelligent');
+      expect(opNames).toContain('search_feedback');
+      // Grading ops (5)
+      expect(opNames).toContain('plan_grade');
+      expect(opNames).toContain('plan_check_history');
+      expect(opNames).toContain('plan_latest_check');
+      expect(opNames).toContain('plan_meets_grade');
+      expect(opNames).toContain('plan_auto_improve');
+      // Admin Extra ops (10)
+      expect(opNames).toContain('admin_telemetry');
+      expect(opNames).toContain('admin_telemetry_recent');
+      expect(opNames).toContain('admin_telemetry_reset');
+      expect(opNames).toContain('admin_permissions');
+      expect(opNames).toContain('admin_vault_analytics');
+      expect(opNames).toContain('admin_search_insights');
+      expect(opNames).toContain('admin_module_status');
+      expect(opNames).toContain('admin_env');
+      expect(opNames).toContain('admin_gc');
+      expect(opNames).toContain('admin_export_config');
+      // Curator Extra ops (4)
+      expect(opNames).toContain('curator_entry_history');
+      expect(opNames).toContain('curator_record_snapshot');
+      expect(opNames).toContain('curator_queue_stats');
+      expect(opNames).toContain('curator_enrich');
+      // Project ops (12)
+      expect(opNames).toContain('project_get');
+      expect(opNames).toContain('project_list');
+      expect(opNames).toContain('project_unregister');
+      expect(opNames).toContain('project_get_rules');
+      expect(opNames).toContain('project_list_rules');
+      expect(opNames).toContain('project_add_rule');
+      expect(opNames).toContain('project_remove_rule');
+      expect(opNames).toContain('project_link');
+      expect(opNames).toContain('project_unlink');
+      expect(opNames).toContain('project_get_links');
+      expect(opNames).toContain('project_linked_projects');
+      expect(opNames).toContain('project_touch');
+      // Cross-project memory ops (3)
+      expect(opNames).toContain('memory_promote_to_global');
+      expect(opNames).toContain('memory_configure');
+      expect(opNames).toContain('memory_cross_project_search');
+      // Total: 152 (147 core + 5 agent-specific)
+      expect(facade.ops.length).toBe(152);
     });
 
     it('search should query across all domains with ranked results', async () => {
@@ -277,7 +419,9 @@ ${domainDescribes}
       const setupOp = facade.ops.find((o) => o.name === 'setup')!;
       const result = (await setupOp.handler({ projectPath: '/tmp/nonexistent-test' })) as {
         agent: { name: string };
+        claude_md: { project: { exists: boolean; has_agent_section: boolean }; global: { exists: boolean; has_agent_section: boolean } };
         vault: { entries: number };
+        hooks: { agent: string[]; global: string[]; missing: string[] };
         recommendations: string[];
       };
       expect(result.agent.name).toBe('${escapeQuotes(config.name)}');
@@ -327,6 +471,32 @@ ${domainDescribes}
       const result = (await healthOp.handler({})) as { score: number };
       expect(result.score).toBeGreaterThan(0);
     });
+
+    it('governance_policy get should return default policy', async () => {
+      const facade = buildCoreFacade();
+      const policyOp = facade.ops.find((o) => o.name === 'governance_policy')!;
+      const result = (await policyOp.handler({ action: 'get', projectPath: '/test' })) as {
+        projectPath: string;
+        quotas: { maxEntriesTotal: number };
+        autoCapture: { enabled: boolean };
+      };
+      expect(result.projectPath).toBe('/test');
+      expect(result.quotas.maxEntriesTotal).toBe(500);
+      expect(result.autoCapture.enabled).toBe(true);
+    });
+
+    it('governance_dashboard should return combined view', async () => {
+      const facade = buildCoreFacade();
+      const dashOp = facade.ops.find((o) => o.name === 'governance_dashboard')!;
+      const result = (await dashOp.handler({ projectPath: '/test' })) as {
+        vaultSize: number;
+        quotaPercent: number;
+        pendingProposals: number;
+      };
+      expect(typeof result.vaultSize).toBe('number');
+      expect(typeof result.quotaPercent).toBe('number');
+      expect(result.pendingProposals).toBe(0);
+    });
   });
 });
 `;
@@ -382,7 +552,7 @@ function generateDomainDescribe(agentId, domain) {
         severity: 'warning',
         description: 'A captured pattern.',
         tags: ['captured'],
-      })) as { captured: boolean };
+      })) as { captured: boolean; governance?: { action: string } };
       expect(result.captured).toBe(true);
       const entry = runtime.vault.get('${domain}-cap1');
       expect(entry).not.toBeNull();

package/dist/templates/test-facades.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-facades.js","sourceRoot":"","sources":["../../src/templates/test-facades.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO;SACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;SAChD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmCS,MAAM,CAAC,EAAE;;;;;;;;;;;EAWzB,eAAe;;cAEH,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCAsEe,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;iBAehC,MAAM,CAAC,EAAE;;;;;;;;kCAQQ,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDA8CM,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAmCvB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;mCACzB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;0CAWlB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;qCA0B9B,MAAM,CAAC,EAAE;;;;;;;;;;;;;;wCAcN,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDhE,CAAC;AACF,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe,EAAE,MAAc;IAC7D,MAAM,UAAU,GAAG,GAAG,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;IAE7D,OAAO,eAAe,UAAU;;4CAEU,OAAO,OAAO,MAAM;;;;;kCAK9B,UAAU;;;;;;;;;iDASK,MAAM;;2BAE5B,MAAM,mBAAmB,MAAM;;;;;;kDAMR,MAAM;;;iCAGvB,MAAM;;2BAEZ,MAAM,kBAAkB,MAAM;;;;;;;wDAOD,MAAM;;;wCAGtB,MAAM;;;;eAI/B,MAAM;;;;;;;;yCAQoB,MAAM;;oCAEX,MAAM;;;;6CAIG,MAAM,mBAAmB,MAAM;;;gDAG5B,MAAM;gCACtB,MAAM;;;;6CAIO,MAAM,mBAAmB,MAAM;;;gDAG5B,MAAM;;kCAEpB,MAAM;;MAElC,CAAC;AACP,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC"}
+{"version":3,"file":"test-facades.js","sourceRoot":"","sources":["../../src/templates/test-facades.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO;SACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;SAChD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmCS,MAAM,CAAC,EAAE;;;;;;;;;;;EAWzB,eAAe;;cAEH,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCA6Fe,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;iBAgBhC,MAAM,CAAC,EAAE;;;;;;;;kCAQQ,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAoKM,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAmCvB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;mCACzB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;0CAWlB,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;qCA0B9B,MAAM,CAAC,EAAE;;;;;;;;;;;;;;;;wCAgBN,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2EhE,CAAC;AACF,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAe,EAAE,MAAc;IAC7D,MAAM,UAAU,GAAG,GAAG,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;IAE7D,OAAO,eAAe,UAAU;;4CAEU,OAAO,OAAO,MAAM;;;;;kCAK9B,UAAU;;;;;;;;;iDASK,MAAM;;2BAE5B,MAAM,mBAAmB,MAAM;;;;;;kDAMR,MAAM;;;iCAGvB,MAAM;;2BAEZ,MAAM,kBAAkB,MAAM;;;;;;;wDAOD,MAAM;;;wCAGtB,MAAM;;;;eAI/B,MAAM;;;;;;;;yCAQoB,MAAM;;oCAEX,MAAM;;;;6CAIG,MAAM,mBAAmB,MAAM;;;gDAG5B,MAAM;gCACtB,MAAM;;;;6CAIO,MAAM,mBAAmB,MAAM;;;gDAG5B,MAAM;;kCAEpB,MAAM;;MAElC,CAAC;AACP,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleri/forge",
-  "version": "5.2.0",
+  "version": "5.5.0",
   "description": "Scaffold AI agents that learn, remember, and grow with you.",
   "keywords": [
     "agent",
@@ -38,7 +38,7 @@
   },
   "scripts": {
     "dev": "tsx src/index.ts",
-    "build": "tsc",
+    "build": "tsc && cp -r src/skills dist/skills",
     "start": "node dist/index.js",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",

package/src/__tests__/scaffolder.test.ts

@@ -59,9 +59,9 @@ describe('Scaffolder', () => {
       expect(preview.facades).toHaveLength(4); // 3 domains + core
       expect(preview.facades[0].name).toBe('atlas_data_pipelines');
 
-      // Core facade should list all 31 ops
+      // Core facade should list all 152 ops (147 core + 5 agent-specific)
       const coreFacade = preview.facades.find((f) => f.name === 'atlas_core')!;
-      expect(coreFacade.ops.length).toBe(31);
+      expect(coreFacade.ops.length).toBe(152);
       expect(coreFacade.ops).toContain('curator_status');
       expect(coreFacade.ops).toContain('health');
 
@@ -248,6 +248,119 @@ describe('Scaffolder', () => {
     });
   });
 
+  describe('skills', () => {
+    it('should create skills directory with 10 SKILL.md files', () => {
+      scaffold(testConfig);
+      const skillsDir = join(tempDir, 'atlas', 'skills');
+
+      expect(existsSync(skillsDir)).toBe(true);
+
+      const skillDirs = readdirSync(skillsDir, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name);
+
+      expect(skillDirs).toHaveLength(17);
+
+      // Verify each skill dir has a SKILL.md
+      for (const dir of skillDirs) {
+        expect(existsSync(join(skillsDir, dir, 'SKILL.md'))).toBe(true);
+      }
+    });
+
+    it('should include all expected skill names', () => {
+      scaffold(testConfig);
+      const skillsDir = join(tempDir, 'atlas', 'skills');
+      const skillDirs = readdirSync(skillsDir).sort();
+
+      expect(skillDirs).toEqual([
+        'brain-debrief',
+        'brainstorming',
+        'code-patrol',
+        'context-resume',
+        'executing-plans',
+        'fix-and-learn',
+        'health-check',
+        'knowledge-harvest',
+        'onboard-me',
+        'retrospective',
+        'second-opinion',
+        'systematic-debugging',
+        'test-driven-development',
+        'vault-capture',
+        'vault-navigator',
+        'verification-before-completion',
+        'writing-plans',
+      ]);
+    });
+
+    it('should have YAML frontmatter in all skills', () => {
+      scaffold(testConfig);
+      const skillsDir = join(tempDir, 'atlas', 'skills');
+      const skillDirs = readdirSync(skillsDir);
+
+      for (const dir of skillDirs) {
+        const content = readFileSync(join(skillsDir, dir, 'SKILL.md'), 'utf-8');
+        expect(content).toMatch(/^---\nname: /);
+        expect(content).toContain('description:');
+      }
+    });
+
+    it('should substitute YOUR_AGENT_core with agent ID in all skills', () => {
+      scaffold(testConfig);
+      const skillsDir = join(tempDir, 'atlas', 'skills');
+      const allSkills = readdirSync(skillsDir);
+
+      for (const name of allSkills) {
+        const content = readFileSync(join(skillsDir, name, 'SKILL.md'), 'utf-8');
+        expect(content).not.toContain('YOUR_AGENT_core');
+        // All skills that reference agent ops should have atlas_core
+        if (content.includes('_core')) {
+          expect(content).toContain('atlas_core');
+        }
+      }
+    });
+
+    it('should include MIT attribution in superpowers-adapted skills', () => {
+      scaffold(testConfig);
+      const skillsDir = join(tempDir, 'atlas', 'skills');
+      const superpowersSkills = [
+        'test-driven-development',
+        'systematic-debugging',
+        'verification-before-completion',
+        'brainstorming',
+        'writing-plans',
+        'executing-plans',
+      ];
+
+      for (const name of superpowersSkills) {
+        const content = readFileSync(join(skillsDir, name, 'SKILL.md'), 'utf-8');
+        expect(content).toContain('MIT License');
+      }
+    });
+
+    it('should have no YOUR_AGENT_core placeholder remaining in any skill', () => {
+      scaffold(testConfig);
+      const skillsDir = join(tempDir, 'atlas', 'skills');
+      const allSkills = readdirSync(skillsDir);
+
+      for (const name of allSkills) {
+        const content = readFileSync(join(skillsDir, name, 'SKILL.md'), 'utf-8');
+        expect(content).not.toContain('YOUR_AGENT_core');
+      }
+    });
+
+    it('should include skills in preview', () => {
+      const preview = previewScaffold(testConfig);
+      const paths = preview.files.map((f) => f.path);
+      expect(paths).toContain('skills/');
+    });
+
+    it('should mention skills in scaffold summary', () => {
+      const result = scaffold(testConfig);
+      expect(result.summary).toContain('built-in skills');
+    });
+  });
+
   describe('listAgents', () => {
     it('should list scaffolded agents', () => {
       scaffold(testConfig);