@soleri/forge 5.4.0 → 5.5.0

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

@@ -0,0 +1,170 @@
+---
+name: verification-before-completion
+description: Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always
+---
+
+<!-- Adapted from superpowers (MIT License) -->
+
+# Verification Before Completion
+
+## Overview
+
+Claiming work is complete without verification is dishonesty, not efficiency.
+
+**Core principle:** Evidence before claims, always.
+
+**Violating the letter of this rule is violating the spirit of this rule.**
+
+## The Iron Law
+
+```
+NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE
+```
+
+If you haven't run the verification command in this message, you cannot claim it passes.
+
+## The Gate Function
+
+```
+BEFORE claiming any status or expressing satisfaction:
+
+1. IDENTIFY: What command proves this claim?
+2. RUN: Execute the FULL command (fresh, complete)
+3. READ: Full output, check exit code, count failures
+4. VERIFY: Does output confirm the claim?
+   - If NO: State actual status with evidence
+   - If YES: State claim WITH evidence
+5. AGENT CHECK: Run system diagnostics
+6. ONLY THEN: Make the claim
+
+Skip any step = lying, not verifying
+```
+
+## Agent System Checks
+
+After passing all verification commands, run system diagnostics:
+
+### Health Check
+```
+YOUR_AGENT_core op:admin_health
+```
+Catches issues tests might miss — vault corruption, stale caches, configuration drift.
+
+### Full Diagnostic
+```
+YOUR_AGENT_core op:admin_diagnostic
+```
+Comprehensive system check — module status, database integrity, cache health, configuration validity.
+
+### Vault Analytics
+```
+YOUR_AGENT_core op:admin_vault_analytics
+```
+Verify knowledge quality metrics — are capture rates healthy? Any degradation?
+
+If any check reports problems, address them before claiming completion.
+
+## Common Failures
+
+| Claim | Requires | Not Sufficient |
+|-------|----------|----------------|
+| Tests pass | Test command output: 0 failures | Previous run, "should pass" |
+| Linter clean | Linter output: 0 errors | Partial check, extrapolation |
+| Build succeeds | Build command: exit 0 | Linter passing, logs look good |
+| Bug fixed | Test original symptom: passes | Code changed, assumed fixed |
+| Regression test works | Red-green cycle verified | Test passes once |
+| Agent completed | VCS diff shows changes | Agent reports "success" |
+| Requirements met | Line-by-line checklist | Tests passing |
+| Agent healthy | `admin_diagnostic` clean | "No errors in logs" |
+
+## Red Flags - STOP
+
+- Using "should", "probably", "seems to"
+- Expressing satisfaction before verification ("Great!", "Perfect!", "Done!", etc.)
+- About to commit/push/PR without verification
+- Trusting agent success reports
+- Relying on partial verification
+- Thinking "just this once"
+- Tired and wanting work over
+- ANY wording implying success without having run verification
+
+## Rationalization Prevention
+
+| Excuse | Reality |
+|--------|---------|
+| "Should work now" | RUN the verification |
+| "I'm confident" | Confidence ≠ evidence |
+| "Just this once" | No exceptions |
+| "Linter passed" | Linter ≠ compiler |
+| "Agent said success" | Verify independently |
+| "I'm tired" | Exhaustion ≠ excuse |
+| "Partial check is enough" | Partial proves nothing |
+| "Different words so rule doesn't apply" | Spirit over letter |
+
+## Key Patterns
+
+**Tests:**
+```
+[Run test command] [See: 34/34 pass] "All tests pass"
+NOT: "Should pass now" / "Looks correct"
+```
+
+**Regression tests (TDD Red-Green):**
+```
+Write -> Run (pass) -> Revert fix -> Run (MUST FAIL) -> Restore -> Run (pass)
+NOT: "I've written a regression test" (without red-green verification)
+```
+
+**Build:**
+```
+[Run build] [See: exit 0] "Build passes"
+NOT: "Linter passed" (linter doesn't check compilation)
+```
+
+**Requirements:**
+```
+Re-read plan -> Create checklist -> Verify each -> Report gaps or completion
+NOT: "Tests pass, phase complete"
+```
+
+**Agent delegation:**
+```
+Agent reports success -> Check VCS diff -> Verify changes -> Report actual state
+NOT: Trust agent report
+```
+
+## After Verification — Capture Session
+
+Once work is verified complete, capture a session summary so context persists:
+
+```
+YOUR_AGENT_core op:session_capture
+  params: {
+    summary: "<what was accomplished, files modified, key decisions>"
+  }
+```
+
+This ensures the next session has context about what was verified and completed.
+
+## When To Apply
+
+**ALWAYS before:**
+- ANY variation of success/completion claims
+- ANY expression of satisfaction
+- ANY positive statement about work state
+- Committing, PR creation, task completion
+- Moving to next task
+- Delegating to agents
+
+## The Bottom Line
+
+Run the command. Read the output. THEN claim the result. This is non-negotiable.
+
+## Agent Tools Reference
+
+| Op | When to Use |
+|----|-------------|
+| `admin_health` | Quick system health check |
+| `admin_diagnostic` | Comprehensive system diagnostic |
+| `admin_vault_analytics` | Knowledge quality metrics |
+| `session_capture` | Persist verified completion context |

package/dist/skills/writing-plans.md

@@ -0,0 +1,207 @@
+---
+name: writing-plans
+description: Use when you have a spec or requirements for a multi-step task, before touching code
+---
+
+<!-- Adapted from superpowers (MIT License) -->
+
+# Writing Plans
+
+## Overview
+
+Write comprehensive implementation plans assuming the engineer has zero context for our codebase and questionable taste. Document everything they need to know: which files to touch for each task, code, testing, docs they might need to check, how to test it. Give them the whole plan as bite-sized tasks. DRY. YAGNI. TDD. Frequent commits.
+
+Assume they are a skilled developer, but know almost nothing about our toolset or problem domain. Assume they don't know good test design very well.
+
+**Announce at start:** "I'm using the writing-plans skill to create the implementation plan."
+
+**Save plans to:** `docs/plans/YYYY-MM-DD-<feature-name>.md`
+
+## Before Writing — Search First, Plan Second
+
+**Never write a plan from scratch.** Always search for existing knowledge first.
+
+### 1. Vault First
+Check the vault for relevant implementation patterns:
+
+```
+YOUR_AGENT_core op:search_intelligent
+  params: { query: "<feature being planned>" }
+```
+
+Look for:
+- **Implementation patterns** — proven approaches for similar features
+- **Anti-patterns** — approaches that failed and should be avoided
+- **Testing patterns** — how similar features were tested
+
+Also check brain strengths for what's worked:
+
+```
+YOUR_AGENT_core op:brain_strengths
+```
+
+Browse related knowledge domains for additional context:
+
+```
+YOUR_AGENT_core op:vault_domains
+YOUR_AGENT_core op:vault_tags
+```
+
+### 2. Web Search Second
+If the vault doesn't have implementation guidance, search the web:
+- **Libraries and tools** — is there a package that does this already?
+- **Reference implementations** — how did other projects solve this?
+- **API documentation** — official docs for libraries you'll use
+- **Known issues** — pitfalls others ran into
+
+### 3. Then Write the Plan
+Incorporate vault insights and web findings into the plan. Reference specific vault entries and documentation links when they inform a step. A plan informed by existing knowledge is dramatically better than one written from first principles.
+
+## Create a Tracked Plan
+
+Use the agent's planning system to create a tracked, resumable plan:
+
+```
+YOUR_AGENT_core op:create_plan
+  params: {
+    objective: "<one-sentence goal>",
+    scope: { included: [...], excluded: [...] },
+    steps: [
+      { title: "Step 1 title", description: "details" },
+      ...
+    ]
+  }
+```
+
+This makes the plan persistent across sessions — if context compacts or sessions change, the plan survives.
+
+## Grade the Plan
+
+After drafting, grade the plan for quality before presenting to the user:
+
+```
+YOUR_AGENT_core op:plan_grade
+  params: { planId: "<id from create_plan>" }
+```
+
+If the grade is below target, auto-improve:
+
+```
+YOUR_AGENT_core op:plan_auto_improve
+  params: { planId: "<id>" }
+```
+
+This iterates on the plan — filling gaps, adding missing test steps, clarifying ambiguous instructions. Repeat until the grade meets the target:
+
+```
+YOUR_AGENT_core op:plan_meets_grade
+  params: { planId: "<id>", targetGrade: "A" }
+```
+
+### Iterate on Drafts
+
+For complex plans, iterate before finalizing:
+
+```
+YOUR_AGENT_core op:plan_iterate
+  params: { planId: "<id>", feedback: "<what needs improvement>" }
+```
+
+This creates a new version of the plan incorporating the feedback, preserving version history.
+
+## Split into Tasks
+
+Once the plan is approved, split it into trackable tasks:
+
+```
+YOUR_AGENT_core op:plan_split
+  params: { planId: "<id>" }
+```
+
+This generates individual tasks from the plan steps, ready for execution tracking.
+
+## Bite-Sized Task Granularity
+
+**Each step is one action (2-5 minutes):**
+- "Write the failing test" - step
+- "Run it to make sure it fails" - step
+- "Implement the minimal code to make the test pass" - step
+- "Run the tests and make sure they pass" - step
+- "Commit" - step
+
+## Plan Document Header
+
+**Every plan MUST start with this header:**
+
+```markdown
+# [Feature Name] Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use executing-plans to implement this plan task-by-task.
+
+**Goal:** [One sentence describing what this builds]
+
+**Architecture:** [2-3 sentences about approach]
+
+**Tech Stack:** [Key technologies/libraries]
+
+---
+```
+
+## Task Structure
+
+Each task uses this format:
+- Files: Create / Modify / Test paths
+- Step 1: Write the failing test (with code)
+- Step 2: Run test to verify it fails (with expected output)
+- Step 3: Write minimal implementation (with code)
+- Step 4: Run test to verify it passes (with expected output)
+- Step 5: Commit (with exact git commands)
+
+## Remember
+- Exact file paths always
+- Complete code in plan (not "add validation")
+- Exact commands with expected output
+- DRY, YAGNI, TDD, frequent commits
+
+## After Plan Approval
+
+Once the user approves the plan, register it for tracking:
+
+```
+YOUR_AGENT_core op:approve_plan
+  params: { planId: "<id from create_plan>" }
+```
+
+Check plan stats for an overview:
+
+```
+YOUR_AGENT_core op:plan_stats
+```
+
+## Execution Handoff
+
+After saving the plan, offer execution choice:
+
+"Plan complete and saved to `docs/plans/<filename>.md`. Two execution options:
+
+**1. Subagent-Driven (this session)** - I dispatch fresh subagent per task, review between tasks, fast iteration
+
+**2. Parallel Session (separate)** - Open new session with executing-plans, batch execution with checkpoints
+
+Which approach?"
+
+## Agent Tools Reference
+
+| Op | When to Use |
+|----|-------------|
+| `search_intelligent` | Find relevant patterns before planning |
+| `brain_strengths` | Check proven approaches |
+| `vault_domains` / `vault_tags` | Browse knowledge landscape |
+| `create_plan` | Create tracked, persistent plan |
+| `plan_grade` | Grade plan quality |
+| `plan_auto_improve` | Auto-fix plan weaknesses |
+| `plan_meets_grade` | Verify grade target reached |
+| `plan_iterate` | Iterate on draft with feedback |
+| `plan_split` | Split plan into trackable tasks |
+| `approve_plan` | Lock in approved plan |
+| `plan_stats` | Overview of plan metrics |

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,6 +99,32 @@ else
   fi
 fi
 
+# 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"

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;;;;;;;;EAS5F,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"}
+{"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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleri/forge",
-  "version": "5.4.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",