@harness-engineering/cli 1.4.0 → 1.6.1

package/dist/{chunk-C3J2HW4Y.js → chunk-O6NEKDYP.js}

@@ -5,10 +5,10 @@ import {
   createCreateSkillCommand,
   handleError,
   logger
-} from "./chunk-EFZOLZFB.js";
+} from "./chunk-ACMDUQJG.js";
 
 // src/index.ts
-import { Command as Command33 } from "commander";
+import { Command as Command43 } from "commander";
 import { VERSION } from "@harness-engineering/core";
 
 // src/commands/validate.ts
@@ -400,10 +400,404 @@ function createCheckDepsCommand() {
   return command;
 }
 
-// src/commands/check-docs.ts
+// src/commands/check-perf.ts
 import { Command as Command3 } from "commander";
 import * as path4 from "path";
-import { Ok as Ok4, Err as Err2 } from "@harness-engineering/core";
+import { Ok as Ok4, EntropyAnalyzer } from "@harness-engineering/core";
+async function runCheckPerf(cwd, options) {
+  const runAll = !options.structural && !options.size && !options.coupling;
+  const analyzer = new EntropyAnalyzer({
+    rootDir: path4.resolve(cwd),
+    analyze: {
+      complexity: runAll || !!options.structural,
+      coupling: runAll || !!options.coupling,
+      sizeBudget: runAll || !!options.size
+    }
+  });
+  const analysisResult = await analyzer.analyze();
+  if (!analysisResult.ok) {
+    return Ok4({
+      valid: false,
+      violations: [
+        {
+          tier: 1,
+          severity: "error",
+          metric: "analysis-error",
+          file: "",
+          value: 0,
+          threshold: 0,
+          message: `Analysis failed: ${analysisResult.error.message}`
+        }
+      ],
+      stats: { filesAnalyzed: 0, violationCount: 1, errorCount: 1, warningCount: 0, infoCount: 0 }
+    });
+  }
+  const report = analysisResult.value;
+  const violations = [];
+  if (report.complexity) {
+    for (const v of report.complexity.violations) {
+      violations.push({
+        tier: v.tier,
+        severity: v.severity,
+        metric: v.metric,
+        file: v.file,
+        value: v.value,
+        threshold: v.threshold,
+        message: v.message || `[Tier ${v.tier}] ${v.metric}: ${v.function} (${v.value} > ${v.threshold})`
+      });
+    }
+  }
+  if (report.coupling) {
+    for (const v of report.coupling.violations) {
+      violations.push({
+        tier: v.tier,
+        severity: v.severity,
+        metric: v.metric,
+        file: v.file,
+        value: v.value,
+        threshold: v.threshold,
+        message: v.message || `[Tier ${v.tier}] ${v.metric}: ${v.file} (${v.value} > ${v.threshold})`
+      });
+    }
+  }
+  if (report.sizeBudget) {
+    for (const v of report.sizeBudget.violations) {
+      violations.push({
+        tier: v.tier,
+        severity: v.severity,
+        metric: "sizeBudget",
+        file: v.package,
+        value: v.currentSize,
+        threshold: v.budgetSize,
+        message: `[Tier ${v.tier}] Size: ${v.package} (${v.currentSize}B > ${v.budgetSize}B)`
+      });
+    }
+  }
+  const hasErrors = violations.some((v) => v.severity === "error");
+  const errorCount = violations.filter((v) => v.severity === "error").length;
+  const warningCount = violations.filter((v) => v.severity === "warning").length;
+  const infoCount = violations.filter((v) => v.severity === "info").length;
+  return Ok4({
+    valid: !hasErrors,
+    violations,
+    stats: {
+      filesAnalyzed: report.complexity?.stats.filesAnalyzed ?? 0,
+      violationCount: violations.length,
+      errorCount,
+      warningCount,
+      infoCount
+    }
+  });
+}
+function createCheckPerfCommand() {
+  const command = new Command3("check-perf").description("Run performance checks: structural complexity, coupling, and size budgets").option("--structural", "Run structural complexity checks only").option("--coupling", "Run coupling metric checks only").option("--size", "Run size budget checks only").action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const mode = globalOpts.json ? OutputMode.JSON : globalOpts.quiet ? OutputMode.QUIET : globalOpts.verbose ? OutputMode.VERBOSE : OutputMode.TEXT;
+    const formatter = new OutputFormatter(mode);
+    const result = await runCheckPerf(process.cwd(), {
+      structural: opts.structural,
+      coupling: opts.coupling,
+      size: opts.size
+    });
+    if (!result.ok) {
+      if (mode === OutputMode.JSON) {
+        console.log(JSON.stringify({ error: result.error.message }));
+      } else {
+        logger.error(result.error.message);
+      }
+      process.exit(ExitCode.ERROR);
+    }
+    const issues = result.value.violations.map((v) => ({
+      file: v.file,
+      message: v.message
+    }));
+    const output = formatter.formatValidation({
+      valid: result.value.valid,
+      issues
+    });
+    if (output) {
+      console.log(output);
+    }
+    process.exit(result.value.valid ? ExitCode.SUCCESS : ExitCode.VALIDATION_FAILED);
+  });
+  return command;
+}
+
+// src/commands/check-security.ts
+import { Command as Command4 } from "commander";
+import * as path5 from "path";
+import { execSync } from "child_process";
+import { Ok as Ok5, SecurityScanner, parseSecurityConfig } from "@harness-engineering/core";
+var SEVERITY_RANK = {
+  error: 3,
+  warning: 2,
+  info: 1
+};
+function getChangedFiles(cwd) {
+  try {
+    const output = execSync("git diff --name-only HEAD~1", {
+      cwd,
+      encoding: "utf-8"
+    });
+    return output.trim().split("\n").filter((f) => f.length > 0).map((f) => path5.resolve(cwd, f));
+  } catch {
+    return [];
+  }
+}
+async function runCheckSecurity(cwd, options) {
+  const projectRoot = path5.resolve(cwd);
+  let configData = {};
+  try {
+    const fs22 = await import("fs");
+    const configPath = path5.join(projectRoot, "harness.config.json");
+    if (fs22.existsSync(configPath)) {
+      const raw = fs22.readFileSync(configPath, "utf-8");
+      const parsed = JSON.parse(raw);
+      configData = parsed.security ?? {};
+    }
+  } catch {
+  }
+  const securityConfig = parseSecurityConfig(configData);
+  const scanner = new SecurityScanner(securityConfig);
+  scanner.configureForProject(projectRoot);
+  let filesToScan;
+  if (options.changedOnly) {
+    filesToScan = getChangedFiles(projectRoot);
+  } else {
+    const { glob: glob2 } = await import("glob");
+    const pattern = "**/*.{ts,tsx,js,jsx,go,py,java,rb}";
+    const ignore = securityConfig.exclude ?? [
+      "**/node_modules/**",
+      "**/dist/**",
+      "**/*.test.ts",
+      "**/fixtures/**"
+    ];
+    filesToScan = await glob2(pattern, { cwd: projectRoot, absolute: true, ignore });
+  }
+  const result = await scanner.scanFiles(filesToScan);
+  const threshold = options.severity ?? "warning";
+  const thresholdRank = SEVERITY_RANK[threshold];
+  const filtered = result.findings.filter((f) => SEVERITY_RANK[f.severity] >= thresholdRank);
+  const hasErrors = filtered.some((f) => f.severity === "error");
+  return Ok5({
+    valid: !hasErrors,
+    findings: filtered,
+    stats: {
+      filesScanned: result.scannedFiles,
+      rulesApplied: result.rulesApplied,
+      errorCount: filtered.filter((f) => f.severity === "error").length,
+      warningCount: filtered.filter((f) => f.severity === "warning").length,
+      infoCount: filtered.filter((f) => f.severity === "info").length
+    }
+  });
+}
+function createCheckSecurityCommand() {
+  const command = new Command4("check-security").description("Run lightweight security scan: secrets, injection, XSS, weak crypto").option("--severity <level>", "Minimum severity threshold", "warning").hook("preAction", (thisCommand) => {
+    const severity = thisCommand.opts().severity;
+    if (!["error", "warning", "info"].includes(severity)) {
+      logger.error(`Invalid severity: "${severity}". Must be one of: error, warning, info`);
+      process.exit(ExitCode.ERROR);
+    }
+  }).option("--changed-only", "Only scan git-changed files").action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const mode = globalOpts.json ? OutputMode.JSON : globalOpts.quiet ? OutputMode.QUIET : globalOpts.verbose ? OutputMode.VERBOSE : OutputMode.TEXT;
+    const formatter = new OutputFormatter(mode);
+    const result = await runCheckSecurity(process.cwd(), {
+      severity: opts.severity,
+      changedOnly: opts.changedOnly
+    });
+    if (!result.ok) {
+      if (mode === OutputMode.JSON) {
+        console.log(JSON.stringify({ error: result.error.message }));
+      } else {
+        logger.error(result.error.message);
+      }
+      process.exit(ExitCode.ERROR);
+    }
+    const issues = result.value.findings.map((f) => ({
+      file: `${f.file}:${f.line}`,
+      message: `[${f.ruleId}] ${f.severity.toUpperCase()} ${f.message}`
+    }));
+    const output = formatter.formatValidation({
+      valid: result.value.valid,
+      issues
+    });
+    if (output) {
+      console.log(output);
+    }
+    process.exit(result.value.valid ? ExitCode.SUCCESS : ExitCode.VALIDATION_FAILED);
+  });
+  return command;
+}
+
+// src/commands/perf.ts
+import { Command as Command5 } from "commander";
+import * as path6 from "path";
+import { BaselineManager, CriticalPathResolver } from "@harness-engineering/core";
+function createPerfCommand() {
+  const perf = new Command5("perf").description("Performance benchmark and baseline management");
+  perf.command("bench [glob]").description("Run benchmarks via vitest bench").action(async (glob2, _opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const cwd = process.cwd();
+    const { BenchmarkRunner } = await import("@harness-engineering/core");
+    const runner = new BenchmarkRunner();
+    const benchFiles = runner.discover(cwd, glob2);
+    if (benchFiles.length === 0) {
+      if (globalOpts.json) {
+        console.log(JSON.stringify({ benchFiles: [], message: "No .bench.ts files found" }));
+      } else {
+        logger.info("No .bench.ts files found. Create *.bench.ts files to add benchmarks.");
+      }
+      return;
+    }
+    if (globalOpts.json) {
+      logger.info(`Found ${benchFiles.length} benchmark file(s). Running...`);
+    } else {
+      logger.info(`Found ${benchFiles.length} benchmark file(s):`);
+      for (const f of benchFiles) {
+        logger.info(`  ${f}`);
+      }
+      logger.info("Running benchmarks...");
+    }
+    const result = await runner.run(glob2 ? { cwd, glob: glob2 } : { cwd });
+    if (globalOpts.json) {
+      console.log(JSON.stringify({ results: result.results, success: result.success }));
+    } else {
+      if (result.success && result.results.length > 0) {
+        logger.info(`
+Results (${result.results.length} benchmarks):`);
+        for (const r of result.results) {
+          logger.info(
+            `  ${r.file}::${r.name}: ${r.opsPerSec} ops/s (mean: ${r.meanMs.toFixed(2)}ms)`
+          );
+        }
+        logger.info("\nTo save as baselines: harness perf baselines update");
+      } else {
+        logger.info("Benchmark run completed. Check output above for details.");
+        if (result.rawOutput) {
+          console.log(result.rawOutput);
+        }
+      }
+    }
+  });
+  const baselines = perf.command("baselines").description("Manage performance baselines");
+  baselines.command("show").description("Display current baselines").action(async (_opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const cwd = process.cwd();
+    const manager = new BaselineManager(cwd);
+    const data = manager.load();
+    if (!data) {
+      if (globalOpts.json) {
+        console.log(JSON.stringify({ baselines: null, message: "No baselines file found" }));
+      } else {
+        logger.info("No baselines file found at .harness/perf/baselines.json");
+      }
+      return;
+    }
+    if (globalOpts.json) {
+      console.log(JSON.stringify(data, null, 2));
+    } else {
+      logger.info(`Baselines (updated: ${data.updatedAt}, from: ${data.updatedFrom})`);
+      for (const [name, baseline] of Object.entries(data.benchmarks)) {
+        logger.info(
+          `  ${name}: ${baseline.opsPerSec} ops/s (mean: ${baseline.meanMs}ms, p99: ${baseline.p99Ms}ms)`
+        );
+      }
+    }
+  });
+  baselines.command("update").description("Update baselines from latest benchmark run").action(async (_opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const cwd = process.cwd();
+    const { BenchmarkRunner } = await import("@harness-engineering/core");
+    const runner = new BenchmarkRunner();
+    const manager = new BaselineManager(cwd);
+    logger.info("Running benchmarks to update baselines...");
+    const benchResult = await runner.run({ cwd });
+    if (!benchResult.success || benchResult.results.length === 0) {
+      logger.error(
+        "No benchmark results to save. Run `harness perf bench` first to verify benchmarks work."
+      );
+      return;
+    }
+    let commitHash = "unknown";
+    try {
+      const { execSync: execSync5 } = await import("child_process");
+      commitHash = execSync5("git rev-parse --short HEAD", { cwd, encoding: "utf-8" }).trim();
+    } catch {
+    }
+    manager.save(benchResult.results, commitHash);
+    if (globalOpts.json) {
+      console.log(JSON.stringify({ updated: benchResult.results.length, commitHash }));
+    } else {
+      logger.info(`Updated ${benchResult.results.length} baseline(s) from commit ${commitHash}`);
+      logger.info("Baselines saved to .harness/perf/baselines.json");
+    }
+  });
+  perf.command("report").description("Full performance report with metrics, trends, and hotspots").action(async (_opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const cwd = process.cwd();
+    const { EntropyAnalyzer: EntropyAnalyzer3 } = await import("@harness-engineering/core");
+    const analyzer = new EntropyAnalyzer3({
+      rootDir: path6.resolve(cwd),
+      analyze: { complexity: true, coupling: true }
+    });
+    const result = await analyzer.analyze();
+    if (!result.ok) {
+      logger.error(result.error.message);
+      return;
+    }
+    const report = result.value;
+    if (globalOpts.json) {
+      console.log(
+        JSON.stringify(
+          {
+            complexity: report.complexity,
+            coupling: report.coupling,
+            sizeBudget: report.sizeBudget
+          },
+          null,
+          2
+        )
+      );
+    } else {
+      logger.info("=== Performance Report ===");
+      if (report.complexity) {
+        logger.info(
+          `Complexity: ${report.complexity.stats.violationCount} violations (${report.complexity.stats.errorCount} errors, ${report.complexity.stats.warningCount} warnings)`
+        );
+      }
+      if (report.coupling) {
+        logger.info(
+          `Coupling: ${report.coupling.stats.violationCount} violations (${report.coupling.stats.warningCount} warnings)`
+        );
+      }
+    }
+  });
+  perf.command("critical-paths").description("Show resolved critical path set (annotations + graph inference)").action(async (_opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const cwd = process.cwd();
+    const resolver = new CriticalPathResolver(cwd);
+    const result = await resolver.resolve();
+    if (globalOpts.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      logger.info(
+        `Critical paths: ${result.stats.total} (${result.stats.annotated} annotated, ${result.stats.graphInferred} graph-inferred)`
+      );
+      for (const entry of result.entries) {
+        logger.info(
+          `  ${entry.file}::${entry.function} [${entry.source}]${entry.fanIn ? ` (fan-in: ${entry.fanIn})` : ""}`
+        );
+      }
+    }
+  });
+  return perf;
+}
+
+// src/commands/check-docs.ts
+import { Command as Command6 } from "commander";
+import * as path7 from "path";
+import { Ok as Ok6, Err as Err2 } from "@harness-engineering/core";
 import { checkDocCoverage, validateKnowledgeMap as validateKnowledgeMap2 } from "@harness-engineering/core";
 async function runCheckDocs(options) {
   const cwd = options.cwd ?? process.cwd();
@@ -413,8 +807,8 @@ async function runCheckDocs(options) {
     return configResult;
   }
   const config = configResult.value;
-  const docsDir = path4.resolve(cwd, config.docsDir);
-  const sourceDir = path4.resolve(cwd, config.rootDir);
+  const docsDir = path7.resolve(cwd, config.docsDir);
+  const sourceDir = path7.resolve(cwd, config.rootDir);
   const coverageResult = await checkDocCoverage("project", {
     docsDir,
     sourceDir,
@@ -443,10 +837,10 @@ async function runCheckDocs(options) {
     undocumented: coverageResult.value.undocumented,
     brokenLinks
   };
-  return Ok4(result);
+  return Ok6(result);
 }
 function createCheckDocsCommand() {
-  const command = new Command3("check-docs").description("Check documentation coverage").option("--min-coverage <percent>", "Minimum coverage percentage", "80").action(async (opts, cmd) => {
+  const command = new Command6("check-docs").description("Check documentation coverage").option("--min-coverage <percent>", "Minimum coverage percentage", "80").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const mode = globalOpts.json ? OutputMode.JSON : globalOpts.quiet ? OutputMode.QUIET : globalOpts.verbose ? OutputMode.VERBOSE : OutputMode.TEXT;
     const formatter = new OutputFormatter(mode);
@@ -498,17 +892,17 @@ function createCheckDocsCommand() {
 }
 
 // src/commands/init.ts
-import { Command as Command5 } from "commander";
+import { Command as Command8 } from "commander";
 import chalk3 from "chalk";
 import * as fs5 from "fs";
-import * as path8 from "path";
-import { Ok as Ok6, Err as Err4 } from "@harness-engineering/core";
+import * as path11 from "path";
+import { Ok as Ok8, Err as Err4 } from "@harness-engineering/core";
 
 // src/templates/engine.ts
 import * as fs2 from "fs";
-import * as path5 from "path";
+import * as path8 from "path";
 import Handlebars from "handlebars";
-import { Ok as Ok5, Err as Err3 } from "@harness-engineering/core";
+import { Ok as Ok7, Err as Err3 } from "@harness-engineering/core";
 
 // src/templates/schema.ts
 import { z as z2 } from "zod";
@@ -576,13 +970,13 @@ var TemplateEngine = class {
       const templates = [];
       for (const entry of entries) {
         if (!entry.isDirectory()) continue;
-        const metaPath = path5.join(this.templatesDir, entry.name, "template.json");
+        const metaPath = path8.join(this.templatesDir, entry.name, "template.json");
         if (!fs2.existsSync(metaPath)) continue;
         const raw = JSON.parse(fs2.readFileSync(metaPath, "utf-8"));
         const parsed = TemplateMetadataSchema.safeParse(raw);
         if (parsed.success) templates.push(parsed.data);
       }
-      return Ok5(templates);
+      return Ok7(templates);
     } catch (error) {
       return Err3(
         new Error(
@@ -594,7 +988,7 @@ var TemplateEngine = class {
   resolveTemplate(level, framework) {
     const levelDir = this.findTemplateDir(level, "level");
     if (!levelDir) return Err3(new Error(`Template not found for level: ${level}`));
-    const metaPath = path5.join(levelDir, "template.json");
+    const metaPath = path8.join(levelDir, "template.json");
     const metaRaw = JSON.parse(fs2.readFileSync(metaPath, "utf-8"));
     const metaResult = TemplateMetadataSchema.safeParse(metaRaw);
     if (!metaResult.success)
@@ -602,7 +996,7 @@ var TemplateEngine = class {
     const metadata = metaResult.data;
     let files = [];
     if (metadata.extends) {
-      const baseDir = path5.join(this.templatesDir, metadata.extends);
+      const baseDir = path8.join(this.templatesDir, metadata.extends);
       if (fs2.existsSync(baseDir)) files = this.collectFiles(baseDir, metadata.extends);
     }
     const levelFiles = this.collectFiles(levelDir, level);
@@ -611,7 +1005,7 @@ var TemplateEngine = class {
     if (framework) {
       const frameworkDir = this.findTemplateDir(framework, "framework");
       if (!frameworkDir) return Err3(new Error(`Framework template not found: ${framework}`));
-      const fMetaPath = path5.join(frameworkDir, "template.json");
+      const fMetaPath = path8.join(frameworkDir, "template.json");
       const fMetaRaw = JSON.parse(fs2.readFileSync(fMetaPath, "utf-8"));
       const fMetaResult = TemplateMetadataSchema.safeParse(fMetaRaw);
       if (fMetaResult.success) overlayMetadata = fMetaResult.data;
@@ -621,7 +1015,7 @@ var TemplateEngine = class {
     files = files.filter((f) => f.relativePath !== "template.json");
     const resolved = { metadata, files };
     if (overlayMetadata !== void 0) resolved.overlayMetadata = overlayMetadata;
-    return Ok5(resolved);
+    return Ok7(resolved);
   }
   render(template, context) {
     const rendered = [];
@@ -673,20 +1067,20 @@ var TemplateEngine = class {
       const msg = error instanceof Error ? error.message : String(error);
       return Err3(new Error(`JSON merge failed: ${msg}`));
     }
-    return Ok5({ files: rendered });
+    return Ok7({ files: rendered });
   }
   write(files, targetDir, options) {
     try {
       const written = [];
       for (const file of files.files) {
-        const targetPath = path5.join(targetDir, file.relativePath);
-        const dir = path5.dirname(targetPath);
+        const targetPath = path8.join(targetDir, file.relativePath);
+        const dir = path8.dirname(targetPath);
         if (!options.overwrite && fs2.existsSync(targetPath)) continue;
         fs2.mkdirSync(dir, { recursive: true });
         fs2.writeFileSync(targetPath, file.content);
         written.push(file.relativePath);
       }
-      return Ok5(written);
+      return Ok7(written);
     } catch (error) {
       return Err3(
         new Error(
@@ -699,16 +1093,16 @@ var TemplateEngine = class {
     const entries = fs2.readdirSync(this.templatesDir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
-      const metaPath = path5.join(this.templatesDir, entry.name, "template.json");
+      const metaPath = path8.join(this.templatesDir, entry.name, "template.json");
       if (!fs2.existsSync(metaPath)) continue;
       const raw = JSON.parse(fs2.readFileSync(metaPath, "utf-8"));
       const parsed = TemplateMetadataSchema.safeParse(raw);
       if (!parsed.success) continue;
       if (type === "level" && parsed.data.level === name)
-        return path5.join(this.templatesDir, entry.name);
+        return path8.join(this.templatesDir, entry.name);
       if (type === "framework" && parsed.data.framework === name)
-        return path5.join(this.templatesDir, entry.name);
-      if (parsed.data.name === name) return path5.join(this.templatesDir, entry.name);
+        return path8.join(this.templatesDir, entry.name);
+      if (parsed.data.name === name) return path8.join(this.templatesDir, entry.name);
     }
     return null;
   }
@@ -717,12 +1111,12 @@ var TemplateEngine = class {
     const walk = (currentDir) => {
       const entries = fs2.readdirSync(currentDir, { withFileTypes: true });
       for (const entry of entries) {
-        const fullPath = path5.join(currentDir, entry.name);
+        const fullPath = path8.join(currentDir, entry.name);
         if (entry.isDirectory()) {
           walk(fullPath);
         } else {
           files.push({
-            relativePath: path5.relative(dir, fullPath),
+            relativePath: path8.relative(dir, fullPath),
             absolutePath: fullPath,
             isHandlebars: entry.name.endsWith(".hbs"),
             sourceTemplate: sourceName
@@ -754,45 +1148,68 @@ var TemplateEngine = class {
 
 // src/utils/paths.ts
 import * as fs3 from "fs";
-import * as path6 from "path";
+import * as path9 from "path";
 import { fileURLToPath } from "url";
 var __filename = fileURLToPath(import.meta.url);
-var __dirname = path6.dirname(__filename);
+var __dirname = path9.dirname(__filename);
 function findUpDir(targetName, marker, maxLevels = 8) {
   let dir = __dirname;
   for (let i = 0; i < maxLevels; i++) {
-    const candidate = path6.join(dir, targetName);
+    const candidate = path9.join(dir, targetName);
     if (fs3.existsSync(candidate) && fs3.statSync(candidate).isDirectory()) {
-      if (fs3.existsSync(path6.join(candidate, marker))) {
+      if (fs3.existsSync(path9.join(candidate, marker))) {
         return candidate;
       }
     }
-    dir = path6.dirname(dir);
+    dir = path9.dirname(dir);
   }
   return null;
 }
 function resolveTemplatesDir() {
-  return findUpDir("templates", "base") ?? path6.join(__dirname, "templates");
+  return findUpDir("templates", "base") ?? path9.join(__dirname, "templates");
 }
 function resolvePersonasDir() {
   const agentsDir = findUpDir("agents", "personas");
   if (agentsDir) {
-    return path6.join(agentsDir, "personas");
+    return path9.join(agentsDir, "personas");
   }
-  return path6.join(__dirname, "agents", "personas");
+  return path9.join(__dirname, "agents", "personas");
 }
 function resolveSkillsDir() {
   const agentsDir = findUpDir("agents", "skills");
   if (agentsDir) {
-    return path6.join(agentsDir, "skills", "claude-code");
+    return path9.join(agentsDir, "skills", "claude-code");
+  }
+  return path9.join(__dirname, "agents", "skills", "claude-code");
+}
+function resolveProjectSkillsDir(cwd) {
+  let dir = cwd ?? process.cwd();
+  for (let i = 0; i < 8; i++) {
+    const candidate = path9.join(dir, "agents", "skills", "claude-code");
+    if (fs3.existsSync(candidate) && fs3.statSync(candidate).isDirectory()) {
+      const agentsDir = path9.join(dir, "agents");
+      if (fs3.existsSync(path9.join(agentsDir, "skills"))) {
+        return candidate;
+      }
+    }
+    const parent = path9.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+function resolveGlobalSkillsDir() {
+  const agentsDir = findUpDir("agents", "skills");
+  if (agentsDir) {
+    return path9.join(agentsDir, "skills", "claude-code");
   }
-  return path6.join(__dirname, "agents", "skills", "claude-code");
+  return path9.join(__dirname, "agents", "skills", "claude-code");
 }
 
 // src/commands/setup-mcp.ts
-import { Command as Command4 } from "commander";
+import { Command as Command7 } from "commander";
 import * as fs4 from "fs";
-import * as path7 from "path";
+import * as path10 from "path";
 import * as os from "os";
 import chalk2 from "chalk";
 var HARNESS_MCP_ENTRY = {
@@ -809,7 +1226,7 @@ function readJsonFile(filePath) {
   }
 }
 function writeJsonFile(filePath, data) {
-  const dir = path7.dirname(filePath);
+  const dir = path10.dirname(filePath);
   if (!fs4.existsSync(dir)) {
     fs4.mkdirSync(dir, { recursive: true });
   }
@@ -828,7 +1245,7 @@ function configureMcpServer(configPath) {
   return true;
 }
 function addGeminiTrustedFolder(cwd) {
-  const trustedPath = path7.join(os.homedir(), ".gemini", "trustedFolders.json");
+  const trustedPath = path10.join(os.homedir(), ".gemini", "trustedFolders.json");
   const folders = readJsonFile(trustedPath) ?? {};
   if (folders[cwd] === "TRUST_FOLDER") {
     return false;
@@ -842,7 +1259,7 @@ function setupMcp(cwd, client) {
   const skipped = [];
   let trustedFolder = false;
   if (client === "all" || client === "claude") {
-    const configPath = path7.join(cwd, ".mcp.json");
+    const configPath = path10.join(cwd, ".mcp.json");
     if (configureMcpServer(configPath)) {
       configured.push("Claude Code");
     } else {
@@ -850,7 +1267,7 @@ function setupMcp(cwd, client) {
     }
   }
   if (client === "all" || client === "gemini") {
-    const configPath = path7.join(cwd, ".gemini", "settings.json");
+    const configPath = path10.join(cwd, ".gemini", "settings.json");
     if (configureMcpServer(configPath)) {
       configured.push("Gemini CLI");
     } else {
@@ -861,7 +1278,7 @@ function setupMcp(cwd, client) {
   return { configured, skipped, trustedFolder };
 }
 function createSetupMcpCommand() {
-  return new Command4("setup-mcp").description("Configure MCP server for AI agent integration").option("--client <client>", "Client to configure (claude, gemini, all)", "all").action(async (opts, cmd) => {
+  return new Command7("setup-mcp").description("Configure MCP server for AI agent integration").option("--client <client>", "Client to configure (claude, gemini, all)", "all").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const cwd = process.cwd();
     const { configured, skipped, trustedFolder } = setupMcp(cwd, opts.client);
@@ -887,8 +1304,12 @@ function createSetupMcpCommand() {
       }
       console.log("");
       console.log(chalk2.bold("The harness MCP server provides:"));
-      console.log("  - 15 tools for validation, entropy detection, and skill execution");
-      console.log("  - 4 resources for project context, skills, rules, and learnings");
+      console.log(
+        "  - 31 tools for validation, entropy detection, skill execution, graph querying, and more"
+      );
+      console.log(
+        "  - 8 resources for project context, skills, rules, learnings, state, and graph data"
+      );
       console.log("");
       console.log(`Run ${chalk2.cyan("harness skill list")} to see available skills.`);
       console.log("");
@@ -900,10 +1321,10 @@ function createSetupMcpCommand() {
 // src/commands/init.ts
 async function runInit(options) {
   const cwd = options.cwd ?? process.cwd();
-  const name = options.name ?? path8.basename(cwd);
+  const name = options.name ?? path11.basename(cwd);
   const level = options.level ?? "basic";
   const force = options.force ?? false;
-  const configPath = path8.join(cwd, "harness.config.json");
+  const configPath = path11.join(cwd, "harness.config.json");
   if (!force && fs5.existsSync(configPath)) {
     return Err4(
       new CLIError("Project already initialized. Use --force to overwrite.", ExitCode.ERROR)
@@ -927,10 +1348,10 @@ async function runInit(options) {
   if (!writeResult.ok) {
     return Err4(new CLIError(writeResult.error.message, ExitCode.ERROR));
   }
-  return Ok6({ filesCreated: writeResult.value });
+  return Ok8({ filesCreated: writeResult.value });
 }
 function createInitCommand() {
-  const command = new Command5("init").description("Initialize a new harness-engineering project").option("-n, --name <name>", "Project name").option("-l, --level <level>", "Adoption level (basic, intermediate, advanced)", "basic").option("--framework <framework>", "Framework overlay (nextjs)").option("-f, --force", "Overwrite existing files").option("-y, --yes", "Use defaults without prompting").action(async (opts, cmd) => {
+  const command = new Command8("init").description("Initialize a new harness-engineering project").option("-n, --name <name>", "Project name").option("-l, --level <level>", "Adoption level (basic, intermediate, advanced)", "basic").option("--framework <framework>", "Framework overlay (nextjs)").option("-f, --force", "Overwrite existing files").option("-y, --yes", "Use defaults without prompting").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const result = await runInit({
       name: opts.name,
@@ -972,9 +1393,9 @@ function createInitCommand() {
 }
 
 // src/commands/cleanup.ts
-import { Command as Command6 } from "commander";
-import * as path9 from "path";
-import { Ok as Ok7, Err as Err5, EntropyAnalyzer } from "@harness-engineering/core";
+import { Command as Command9 } from "commander";
+import * as path12 from "path";
+import { Ok as Ok9, Err as Err5, EntropyAnalyzer as EntropyAnalyzer2 } from "@harness-engineering/core";
 async function runCleanup(options) {
   const cwd = options.cwd ?? process.cwd();
   const type = options.type ?? "all";
@@ -989,11 +1410,11 @@ async function runCleanup(options) {
     patternViolations: [],
     totalIssues: 0
   };
-  const rootDir = path9.resolve(cwd, config.rootDir);
-  const docsDir = path9.resolve(cwd, config.docsDir);
+  const rootDir = path12.resolve(cwd, config.rootDir);
+  const docsDir = path12.resolve(cwd, config.docsDir);
   const entropyConfig = {
     rootDir,
-    entryPoints: [path9.join(rootDir, "src/index.ts")],
+    entryPoints: [path12.join(rootDir, "src/index.ts")],
     docPaths: [docsDir],
     analyze: {
       drift: type === "all" || type === "drift",
@@ -1002,7 +1423,7 @@ async function runCleanup(options) {
     },
     exclude: config.entropy?.excludePatterns ?? ["**/node_modules/**", "**/*.test.ts"]
   };
-  const analyzer = new EntropyAnalyzer(entropyConfig);
+  const analyzer = new EntropyAnalyzer2(entropyConfig);
   const analysisResult = await analyzer.analyze();
   if (!analysisResult.ok) {
     return Err5(
@@ -1030,10 +1451,10 @@ async function runCleanup(options) {
     }));
   }
   result.totalIssues = result.driftIssues.length + result.deadCode.length + result.patternViolations.length;
-  return Ok7(result);
+  return Ok9(result);
 }
 function createCleanupCommand() {
-  const command = new Command6("cleanup").description("Detect entropy issues (doc drift, dead code, patterns)").option("-t, --type <type>", "Issue type: drift, dead-code, patterns, all", "all").action(async (opts, cmd) => {
+  const command = new Command9("cleanup").description("Detect entropy issues (doc drift, dead code, patterns)").option("-t, --type <type>", "Issue type: drift, dead-code, patterns, all", "all").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const mode = globalOpts.json ? OutputMode.JSON : globalOpts.quiet ? OutputMode.QUIET : globalOpts.verbose ? OutputMode.VERBOSE : OutputMode.TEXT;
     const formatter = new OutputFormatter(mode);
@@ -1093,10 +1514,10 @@ function createCleanupCommand() {
 }
 
 // src/commands/fix-drift.ts
-import { Command as Command7 } from "commander";
-import * as path10 from "path";
+import { Command as Command10 } from "commander";
+import * as path13 from "path";
 import {
-  Ok as Ok8,
+  Ok as Ok10,
   Err as Err6,
   buildSnapshot,
   detectDocDrift,
@@ -1113,11 +1534,11 @@ async function runFixDrift(options) {
     return Err6(configResult.error);
   }
   const config = configResult.value;
-  const rootDir = path10.resolve(cwd, config.rootDir);
-  const docsDir = path10.resolve(cwd, config.docsDir);
+  const rootDir = path13.resolve(cwd, config.rootDir);
+  const docsDir = path13.resolve(cwd, config.docsDir);
   const entropyConfig = {
     rootDir,
-    entryPoints: [path10.join(rootDir, "src/index.ts")],
+    entryPoints: [path13.join(rootDir, "src/index.ts")],
     docPaths: [docsDir],
     analyze: {
       drift: true,
@@ -1201,10 +1622,10 @@ async function runFixDrift(options) {
     fixes: appliedFixes,
     suggestions
   };
-  return Ok8(result);
+  return Ok10(result);
 }
 function createFixDriftCommand() {
-  const command = new Command7("fix-drift").description("Auto-fix entropy issues (doc drift, dead code)").option("--no-dry-run", "Actually apply fixes (default is dry-run mode)").action(async (opts, cmd) => {
+  const command = new Command10("fix-drift").description("Auto-fix entropy issues (doc drift, dead code)").option("--no-dry-run", "Actually apply fixes (default is dry-run mode)").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const mode = globalOpts.json ? OutputMode.JSON : globalOpts.quiet ? OutputMode.QUIET : globalOpts.verbose ? OutputMode.VERBOSE : OutputMode.TEXT;
     const formatter = new OutputFormatter(mode);
@@ -1264,27 +1685,41 @@ function createFixDriftCommand() {
 }
 
 // src/commands/agent/index.ts
-import { Command as Command10 } from "commander";
+import { Command as Command13 } from "commander";
 
 // src/commands/agent/run.ts
-import { Command as Command8 } from "commander";
-import * as path12 from "path";
+import { Command as Command11 } from "commander";
+import * as path17 from "path";
 import * as childProcess from "child_process";
-import { Ok as Ok10, Err as Err8 } from "@harness-engineering/core";
+import { Ok as Ok12, Err as Err8 } from "@harness-engineering/core";
 import { requestPeerReview } from "@harness-engineering/core";
 
 // src/persona/loader.ts
 import * as fs6 from "fs";
-import * as path11 from "path";
+import * as path14 from "path";
 import YAML from "yaml";
-import { Ok as Ok9, Err as Err7 } from "@harness-engineering/core";
+import { Ok as Ok11, Err as Err7 } from "@harness-engineering/core";
 
 // src/persona/schema.ts
 import { z as z3 } from "zod";
+var TriggerContextSchema = z3.enum(["always", "on_pr", "on_commit", "on_review", "scheduled", "manual", "on_plan_approved"]).default("always");
+var CommandStepSchema = z3.object({
+  command: z3.string(),
+  when: TriggerContextSchema
+});
+var SkillStepSchema = z3.object({
+  skill: z3.string(),
+  when: TriggerContextSchema,
+  output: z3.enum(["inline", "artifact", "auto"]).default("auto")
+});
+var StepSchema = z3.union([CommandStepSchema, SkillStepSchema]);
 var PersonaTriggerSchema = z3.discriminatedUnion("event", [
   z3.object({
     event: z3.literal("on_pr"),
-    conditions: z3.object({ paths: z3.array(z3.string()).optional() }).optional()
+    conditions: z3.object({
+      paths: z3.array(z3.string()).optional(),
+      min_files: z3.number().optional()
+    }).optional()
   }),
   z3.object({
     event: z3.literal("on_commit"),
@@ -1293,6 +1728,9 @@ var PersonaTriggerSchema = z3.discriminatedUnion("event", [
   z3.object({
     event: z3.literal("scheduled"),
     cron: z3.string()
+  }),
+  z3.object({
+    event: z3.literal("manual")
   })
 ]);
 var PersonaConfigSchema = z3.object({
@@ -1305,7 +1743,7 @@ var PersonaOutputsSchema = z3.object({
   "ci-workflow": z3.boolean().default(true),
   "runtime-config": z3.boolean().default(true)
 });
-var PersonaSchema = z3.object({
+var PersonaSchemaV1 = z3.object({
   version: z3.literal(1),
   name: z3.string(),
   description: z3.string(),
@@ -1316,8 +1754,33 @@ var PersonaSchema = z3.object({
   config: PersonaConfigSchema.default({}),
   outputs: PersonaOutputsSchema.default({})
 });
+var PersonaSchemaV2 = z3.object({
+  version: z3.literal(2),
+  name: z3.string(),
+  description: z3.string(),
+  role: z3.string(),
+  skills: z3.array(z3.string()),
+  steps: z3.array(StepSchema),
+  triggers: z3.array(PersonaTriggerSchema),
+  config: PersonaConfigSchema.default({}),
+  outputs: PersonaOutputsSchema.default({})
+});
+var PersonaSchema = z3.union([PersonaSchemaV1, PersonaSchemaV2]);
 
 // src/persona/loader.ts
+function normalizePersona(raw) {
+  if (raw.version === 1 && Array.isArray(raw.commands)) {
+    const { commands, ...rest } = raw;
+    return {
+      ...rest,
+      steps: commands.map((cmd) => ({
+        command: cmd,
+        when: "always"
+      }))
+    };
+  }
+  return raw;
+}
 function loadPersona(filePath) {
   try {
     if (!fs6.existsSync(filePath)) {
@@ -1329,7 +1792,7 @@ function loadPersona(filePath) {
     if (!result.success) {
       return Err7(new Error(`Invalid persona ${filePath}: ${result.error.message}`));
     }
-    return Ok9(result.data);
+    return Ok11(normalizePersona(result.data));
   } catch (error) {
     return Err7(
       new Error(`Failed to load persona: ${error instanceof Error ? error.message : String(error)}`)
@@ -1338,17 +1801,17 @@ function loadPersona(filePath) {
 }
 function listPersonas(dir) {
   try {
-    if (!fs6.existsSync(dir)) return Ok9([]);
+    if (!fs6.existsSync(dir)) return Ok11([]);
     const entries = fs6.readdirSync(dir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml"));
     const personas = [];
     for (const entry of entries) {
-      const filePath = path11.join(dir, entry);
+      const filePath = path14.join(dir, entry);
       const result = loadPersona(filePath);
       if (result.ok) {
         personas.push({ name: result.value.name, description: result.value.description, filePath });
       }
     }
-    return Ok9(personas);
+    return Ok11(personas);
   } catch (error) {
     return Err7(
       new Error(
@@ -1358,75 +1821,314 @@ function listPersonas(dir) {
   }
 }
 
+// src/persona/trigger-detector.ts
+import * as fs7 from "fs";
+import * as path15 from "path";
+function detectTrigger(projectPath) {
+  const handoffPath = path15.join(projectPath, ".harness", "handoff.json");
+  if (!fs7.existsSync(handoffPath)) {
+    return { trigger: "manual" };
+  }
+  try {
+    const raw = fs7.readFileSync(handoffPath, "utf-8");
+    const handoff = JSON.parse(raw);
+    if (handoff.fromSkill === "harness-planning" && Array.isArray(handoff.pending) && handoff.pending.length > 0) {
+      return {
+        trigger: "on_plan_approved",
+        handoff: {
+          fromSkill: handoff.fromSkill,
+          summary: handoff.summary ?? "",
+          pending: handoff.pending,
+          planPath: handoff.planPath
+        }
+      };
+    }
+    return { trigger: "manual" };
+  } catch {
+    return { trigger: "manual" };
+  }
+}
+
 // src/persona/runner.ts
 var TIMEOUT_ERROR_MESSAGE = "__PERSONA_RUNNER_TIMEOUT__";
-async function runPersona(persona, executor) {
+function stepName(step) {
+  return "command" in step ? step.command : step.skill;
+}
+function stepType(step) {
+  return "command" in step ? "command" : "skill";
+}
+function matchesTrigger(step, trigger) {
+  const when = step.when ?? "always";
+  return when === "always" || when === trigger;
+}
+function skipRemaining(activeSteps, fromIndex, report) {
+  for (let j = fromIndex; j < activeSteps.length; j++) {
+    const remaining = activeSteps[j];
+    report.steps.push({
+      name: stepName(remaining),
+      type: stepType(remaining),
+      status: "skipped",
+      durationMs: 0
+    });
+  }
+}
+async function runPersona(persona, context) {
   const startTime = Date.now();
   const timeout = persona.config.timeout;
   const report = {
     persona: persona.name.toLowerCase().replace(/\s+/g, "-"),
     status: "pass",
-    commands: [],
+    steps: [],
     totalDurationMs: 0
   };
-  for (let i = 0; i < persona.commands.length; i++) {
-    const command = persona.commands[i];
-    if (command === void 0) continue;
+  let resolvedTrigger;
+  let handoff = context.handoff;
+  if (context.trigger === "auto") {
+    const detection = detectTrigger(context.projectPath);
+    resolvedTrigger = detection.trigger;
+    handoff = detection.handoff ?? handoff;
+  } else {
+    resolvedTrigger = context.trigger;
+  }
+  const activeSteps = persona.steps.filter((s) => matchesTrigger(s, resolvedTrigger));
+  for (let i = 0; i < activeSteps.length; i++) {
+    const step = activeSteps[i];
     if (Date.now() - startTime >= timeout) {
-      for (let j = i; j < persona.commands.length; j++) {
-        const remaining = persona.commands[j];
-        if (remaining !== void 0) {
-          report.commands.push({ name: remaining, status: "skipped", durationMs: 0 });
-        }
-      }
+      skipRemaining(activeSteps, i, report);
       report.status = "partial";
       break;
     }
-    const cmdStart = Date.now();
+    const stepStart = Date.now();
     const remainingTime = timeout - (Date.now() - startTime);
-    const result = await Promise.race([
-      executor(command),
-      new Promise(
-        (resolve14) => setTimeout(
-          () => resolve14({ ok: false, error: new Error(TIMEOUT_ERROR_MESSAGE) }),
-          remainingTime
+    if ("command" in step) {
+      const result = await Promise.race([
+        context.commandExecutor(step.command),
+        new Promise(
+          (resolve22) => setTimeout(
+            () => resolve22({
+              ok: false,
+              error: new Error(TIMEOUT_ERROR_MESSAGE)
+            }),
+            remainingTime
+          )
         )
-      )
-    ]);
-    const durationMs = Date.now() - cmdStart;
-    if (result.ok) {
-      report.commands.push({ name: command, status: "pass", result: result.value, durationMs });
-    } else if (result.error.message === TIMEOUT_ERROR_MESSAGE) {
-      report.commands.push({ name: command, status: "skipped", error: "timed out", durationMs });
-      report.status = "partial";
-      for (let j = i + 1; j < persona.commands.length; j++) {
-        const skipped = persona.commands[j];
-        if (skipped !== void 0) {
-          report.commands.push({ name: skipped, status: "skipped", durationMs: 0 });
-        }
+      ]);
+      const durationMs = Date.now() - stepStart;
+      if (result.ok) {
+        report.steps.push({
+          name: step.command,
+          type: "command",
+          status: "pass",
+          result: result.value,
+          durationMs
+        });
+      } else if (result.error.message === TIMEOUT_ERROR_MESSAGE) {
+        report.steps.push({
+          name: step.command,
+          type: "command",
+          status: "skipped",
+          error: "timed out",
+          durationMs
+        });
+        report.status = "partial";
+        skipRemaining(activeSteps, i + 1, report);
+        break;
+      } else {
+        report.steps.push({
+          name: step.command,
+          type: "command",
+          status: "fail",
+          error: result.error.message,
+          durationMs
+        });
+        report.status = "fail";
+        skipRemaining(activeSteps, i + 1, report);
+        break;
       }
-      break;
     } else {
-      report.commands.push({
-        name: command,
+      const skillContext = {
+        trigger: resolvedTrigger,
+        projectPath: context.projectPath,
+        outputMode: step.output ?? "auto",
+        ...handoff ? { handoff } : {}
+      };
+      const SKILL_TIMEOUT_RESULT = {
         status: "fail",
-        error: result.error.message,
-        durationMs
-      });
-      report.status = "fail";
-      for (let j = i + 1; j < persona.commands.length; j++) {
-        const skipped = persona.commands[j];
-        if (skipped !== void 0) {
-          report.commands.push({ name: skipped, status: "skipped", durationMs: 0 });
-        }
+        output: "timed out",
+        durationMs: 0
+      };
+      const result = await Promise.race([
+        context.skillExecutor(step.skill, skillContext),
+        new Promise(
+          (resolve22) => setTimeout(() => resolve22(SKILL_TIMEOUT_RESULT), remainingTime)
+        )
+      ]);
+      const durationMs = Date.now() - stepStart;
+      if (result === SKILL_TIMEOUT_RESULT) {
+        report.steps.push({
+          name: step.skill,
+          type: "skill",
+          status: "skipped",
+          error: "timed out",
+          durationMs
+        });
+        report.status = "partial";
+        skipRemaining(activeSteps, i + 1, report);
+        break;
+      } else if (result.status === "pass") {
+        report.steps.push({
+          name: step.skill,
+          type: "skill",
+          status: "pass",
+          result: result.output,
+          ...result.artifactPath ? { artifactPath: result.artifactPath } : {},
+          durationMs
+        });
+      } else {
+        report.steps.push({
+          name: step.skill,
+          type: "skill",
+          status: "fail",
+          error: result.output,
+          durationMs
+        });
+        report.status = "fail";
+        skipRemaining(activeSteps, i + 1, report);
+        break;
       }
-      break;
     }
   }
   report.totalDurationMs = Date.now() - startTime;
   return report;
 }
 
+// src/persona/skill-executor.ts
+import * as fs8 from "fs";
+import * as path16 from "path";
+import { parse as parse2 } from "yaml";
+function resolveOutputMode(mode, trigger) {
+  if (mode !== "auto") return mode;
+  return trigger === "manual" ? "inline" : "artifact";
+}
+function buildArtifactPath(projectPath, headSha) {
+  const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const sha = headSha?.slice(0, 7) ?? "unknown";
+  return path16.join(projectPath, ".harness", "reviews", `${date}-${sha}.md`);
+}
+function buildArtifactContent(skillName, trigger, headSha) {
+  const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  return [
+    "---",
+    `skill: ${skillName}`,
+    `trigger: ${trigger}`,
+    `sha: ${headSha?.slice(0, 7) ?? "unknown"}`,
+    `date: ${date}`,
+    `assessment: pending`,
+    "---",
+    "",
+    `# Review by ${skillName}`,
+    "",
+    "## Strengths",
+    "",
+    "- (review pending)",
+    "",
+    "## Issues",
+    "",
+    "### Critical",
+    "",
+    "- None identified",
+    "",
+    "### Important",
+    "",
+    "- None identified",
+    "",
+    "### Suggestions",
+    "",
+    "- None identified",
+    "",
+    "## Assessment",
+    "",
+    "Pending \u2014 skill execution scaffolded.",
+    "",
+    "## Harness Checks",
+    "",
+    "- (run harness validate, check-deps, check-docs to populate)",
+    ""
+  ].join("\n");
+}
+async function executeSkill(skillName, context) {
+  const startTime = Date.now();
+  const skillsDir = resolveSkillsDir();
+  const skillDir = path16.join(skillsDir, skillName);
+  if (!fs8.existsSync(skillDir)) {
+    return {
+      status: "fail",
+      output: `Skill not found: ${skillName}`,
+      durationMs: Date.now() - startTime
+    };
+  }
+  const yamlPath = path16.join(skillDir, "skill.yaml");
+  if (!fs8.existsSync(yamlPath)) {
+    return {
+      status: "fail",
+      output: `skill.yaml not found for ${skillName}`,
+      durationMs: Date.now() - startTime
+    };
+  }
+  const raw = fs8.readFileSync(yamlPath, "utf-8");
+  const parsed = parse2(raw);
+  const metadataResult = SkillMetadataSchema.safeParse(parsed);
+  if (!metadataResult.success) {
+    return {
+      status: "fail",
+      output: `Invalid skill metadata: ${metadataResult.error.message}`,
+      durationMs: Date.now() - startTime
+    };
+  }
+  const skillMdPath = path16.join(skillDir, "SKILL.md");
+  if (!fs8.existsSync(skillMdPath)) {
+    return {
+      status: "fail",
+      output: `SKILL.md not found for ${skillName}`,
+      durationMs: Date.now() - startTime
+    };
+  }
+  const skillContent = fs8.readFileSync(skillMdPath, "utf-8");
+  const metadata = metadataResult.data;
+  const resolvedMode = resolveOutputMode(context.outputMode, context.trigger);
+  const output = `Skill ${metadata.name} (${metadata.type}) loaded.
+Cognitive mode: ${metadata.cognitive_mode ?? "default"}
+Content length: ${skillContent.length} chars
+Trigger: ${context.trigger}
+`;
+  let artifactPath;
+  if (resolvedMode === "artifact") {
+    artifactPath = buildArtifactPath(context.projectPath, context.headSha);
+    const artifactContent = buildArtifactContent(skillName, context.trigger, context.headSha);
+    const dir = path16.dirname(artifactPath);
+    fs8.mkdirSync(dir, { recursive: true });
+    fs8.writeFileSync(artifactPath, artifactContent, "utf-8");
+  }
+  return {
+    status: "pass",
+    output,
+    ...artifactPath ? { artifactPath } : {},
+    durationMs: Date.now() - startTime
+  };
+}
+
+// src/persona/constants.ts
+var ALLOWED_PERSONA_COMMANDS = /* @__PURE__ */ new Set([
+  "validate",
+  "check-deps",
+  "check-docs",
+  "check-perf",
+  "check-security",
+  "cleanup",
+  "fix-drift",
+  "add"
+]);
+
 // src/commands/agent/run.ts
 async function runAgentTask(task, options) {
   const configResult = resolveConfig(options.configPath);
@@ -1463,49 +2165,62 @@ async function runAgentTask(task, options) {
     return Err8(new CLIError(`Agent task failed: ${reviewResult.error.message}`, ExitCode.ERROR));
   }
   const review = reviewResult.value;
-  return Ok10({
+  return Ok12({
     success: review.approved,
     output: review.approved ? `Agent task '${task}' completed successfully` : `Agent task '${task}' found issues:
 ${review.comments.map((c) => `  - ${c.message}`).join("\n")}`
   });
 }
+var VALID_TRIGGERS = /* @__PURE__ */ new Set([
+  "always",
+  "on_pr",
+  "on_commit",
+  "on_review",
+  "scheduled",
+  "manual",
+  "on_plan_approved",
+  "auto"
+]);
 function createRunCommand() {
-  return new Command8("run").description("Run an agent task").argument("[task]", "Task to run (review, doc-review, test-review)").option("--timeout <ms>", "Timeout in milliseconds", "300000").option("--persona <name>", "Run a persona by name").action(async (task, opts, cmd) => {
+  return new Command11("run").description("Run an agent task").argument("[task]", "Task to run (review, doc-review, test-review)").option("--timeout <ms>", "Timeout in milliseconds", "300000").option("--persona <name>", "Run a persona by name").option("--trigger <context>", "Trigger context (auto, on_pr, on_commit, manual)", "auto").action(async (task, opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     if (opts.persona) {
       const personasDir = resolvePersonasDir();
-      const filePath = path12.join(personasDir, `${opts.persona}.yaml`);
+      const filePath = path17.join(personasDir, `${opts.persona}.yaml`);
       const personaResult = loadPersona(filePath);
       if (!personaResult.ok) {
         logger.error(personaResult.error.message);
         process.exit(ExitCode.ERROR);
       }
       const persona = personaResult.value;
-      const ALLOWED_COMMANDS = /* @__PURE__ */ new Set([
-        "validate",
-        "check-deps",
-        "check-docs",
-        "cleanup",
-        "fix-drift",
-        "add"
-      ]);
-      const executor = async (command) => {
-        if (!ALLOWED_COMMANDS.has(command)) {
+      const projectPath = process.cwd();
+      const trigger = opts.trigger === "auto" ? "auto" : VALID_TRIGGERS.has(opts.trigger) ? opts.trigger : "manual";
+      const commandExecutor = async (command) => {
+        if (!ALLOWED_PERSONA_COMMANDS.has(command)) {
           return Err8(new Error(`Unknown harness command: ${command}`));
         }
         try {
           childProcess.execFileSync("npx", ["harness", command], { stdio: "inherit" });
-          return Ok10(null);
+          return Ok12(null);
         } catch (error) {
           return Err8(new Error(error instanceof Error ? error.message : String(error)));
         }
       };
-      const report = await runPersona(persona, executor);
+      const report = await runPersona(persona, {
+        trigger,
+        commandExecutor,
+        skillExecutor: executeSkill,
+        projectPath
+      });
       if (!globalOpts.quiet) {
         logger.info(`Persona '${report.persona}' status: ${report.status}`);
-        for (const c of report.commands) {
-          const icon = c.status === "pass" ? "v" : c.status === "fail" ? "x" : "-";
-          console.log(`  [${icon}] ${c.name} (${c.durationMs}ms)`);
+        for (const s of report.steps) {
+          const icon = s.status === "pass" ? "v" : s.status === "fail" ? "x" : "-";
+          const typeTag = s.type === "skill" ? " [skill]" : "";
+          console.log(`  [${icon}] ${s.name}${typeTag} (${s.durationMs}ms)`);
+          if (s.artifactPath) {
+            console.log(`      artifact: ${s.artifactPath}`);
+          }
         }
       }
       process.exit(report.status === "fail" ? ExitCode.ERROR : ExitCode.SUCCESS);
@@ -1528,9 +2243,9 @@ function createRunCommand() {
 }
 
 // src/commands/agent/review.ts
-import { Command as Command9 } from "commander";
-import { execSync } from "child_process";
-import { Ok as Ok11, Err as Err9 } from "@harness-engineering/core";
+import { Command as Command12 } from "commander";
+import { execSync as execSync2 } from "child_process";
+import { Ok as Ok13, Err as Err9 } from "@harness-engineering/core";
 import { createSelfReview, parseDiff } from "@harness-engineering/core";
 async function runAgentReview(options) {
   const configResult = resolveConfig(options.configPath);
@@ -1540,15 +2255,15 @@ async function runAgentReview(options) {
   const config = configResult.value;
   let diff;
   try {
-    diff = execSync("git diff --cached", { encoding: "utf-8" });
+    diff = execSync2("git diff --cached", { encoding: "utf-8" });
     if (!diff) {
-      diff = execSync("git diff", { encoding: "utf-8" });
+      diff = execSync2("git diff", { encoding: "utf-8" });
     }
   } catch {
     return Err9(new CLIError("Failed to get git diff", ExitCode.ERROR));
   }
   if (!diff) {
-    return Ok11({
+    return Ok13({
       passed: true,
       checklist: [{ check: "No changes to review", passed: true }]
     });
@@ -1568,7 +2283,7 @@ async function runAgentReview(options) {
   if (!review.ok) {
     return Err9(new CLIError(review.error.message, ExitCode.ERROR));
   }
-  return Ok11({
+  return Ok13({
     passed: review.value.passed,
     checklist: review.value.items.map((item) => ({
       check: item.check,
@@ -1578,7 +2293,7 @@ async function runAgentReview(options) {
   });
 }
 function createReviewCommand() {
-  return new Command9("review").description("Run self-review on current changes").action(async (_opts, cmd) => {
+  return new Command12("review").description("Run self-review on current changes").action(async (_opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const mode = globalOpts.json ? OutputMode.JSON : globalOpts.quiet ? OutputMode.QUIET : OutputMode.TEXT;
     const result = await runAgentReview({
@@ -1614,17 +2329,17 @@ function createReviewCommand() {
 
 // src/commands/agent/index.ts
 function createAgentCommand() {
-  const command = new Command10("agent").description("Agent orchestration commands");
+  const command = new Command13("agent").description("Agent orchestration commands");
   command.addCommand(createRunCommand());
   command.addCommand(createReviewCommand());
   return command;
 }
 
 // src/commands/add.ts
-import { Command as Command11 } from "commander";
-import * as fs7 from "fs";
-import * as path13 from "path";
-import { Ok as Ok12, Err as Err10 } from "@harness-engineering/core";
+import { Command as Command14 } from "commander";
+import * as fs9 from "fs";
+import * as path18 from "path";
+import { Ok as Ok14, Err as Err10 } from "@harness-engineering/core";
 var LAYER_INDEX_TEMPLATE = (name) => `// ${name} layer
 // Add your ${name} exports here
 
@@ -1668,61 +2383,61 @@ async function runAdd(componentType, name, options) {
   try {
     switch (componentType) {
       case "layer": {
-        const layerDir = path13.join(cwd, "src", name);
-        if (!fs7.existsSync(layerDir)) {
-          fs7.mkdirSync(layerDir, { recursive: true });
+        const layerDir = path18.join(cwd, "src", name);
+        if (!fs9.existsSync(layerDir)) {
+          fs9.mkdirSync(layerDir, { recursive: true });
           created.push(`src/${name}/`);
         }
-        const indexPath = path13.join(layerDir, "index.ts");
-        if (!fs7.existsSync(indexPath)) {
-          fs7.writeFileSync(indexPath, LAYER_INDEX_TEMPLATE(name));
+        const indexPath = path18.join(layerDir, "index.ts");
+        if (!fs9.existsSync(indexPath)) {
+          fs9.writeFileSync(indexPath, LAYER_INDEX_TEMPLATE(name));
           created.push(`src/${name}/index.ts`);
         }
         break;
       }
       case "module": {
-        const modulePath = path13.join(cwd, "src", `${name}.ts`);
-        if (fs7.existsSync(modulePath)) {
+        const modulePath = path18.join(cwd, "src", `${name}.ts`);
+        if (fs9.existsSync(modulePath)) {
           return Err10(new CLIError(`Module ${name} already exists`, ExitCode.ERROR));
         }
-        fs7.writeFileSync(modulePath, MODULE_TEMPLATE(name));
+        fs9.writeFileSync(modulePath, MODULE_TEMPLATE(name));
         created.push(`src/${name}.ts`);
         break;
       }
       case "doc": {
-        const docsDir = path13.join(cwd, "docs");
-        if (!fs7.existsSync(docsDir)) {
-          fs7.mkdirSync(docsDir, { recursive: true });
+        const docsDir = path18.join(cwd, "docs");
+        if (!fs9.existsSync(docsDir)) {
+          fs9.mkdirSync(docsDir, { recursive: true });
         }
-        const docPath = path13.join(docsDir, `${name}.md`);
-        if (fs7.existsSync(docPath)) {
+        const docPath = path18.join(docsDir, `${name}.md`);
+        if (fs9.existsSync(docPath)) {
           return Err10(new CLIError(`Doc ${name} already exists`, ExitCode.ERROR));
         }
-        fs7.writeFileSync(docPath, DOC_TEMPLATE(name));
+        fs9.writeFileSync(docPath, DOC_TEMPLATE(name));
         created.push(`docs/${name}.md`);
         break;
       }
       case "skill": {
-        const { generateSkillFiles: generateSkillFiles2 } = await import("./create-skill-4GKJZB5R.js");
+        const { generateSkillFiles: generateSkillFiles2 } = await import("./create-skill-NZDLMMR6.js");
         generateSkillFiles2({
           name,
           description: `${name} skill`,
-          outputDir: path13.join(cwd, "agents", "skills", "claude-code")
+          outputDir: path18.join(cwd, "agents", "skills", "claude-code")
         });
         created.push(`agents/skills/claude-code/${name}/skill.yaml`);
         created.push(`agents/skills/claude-code/${name}/SKILL.md`);
         break;
       }
       case "persona": {
-        const personasDir = path13.join(cwd, "agents", "personas");
-        if (!fs7.existsSync(personasDir)) {
-          fs7.mkdirSync(personasDir, { recursive: true });
+        const personasDir = path18.join(cwd, "agents", "personas");
+        if (!fs9.existsSync(personasDir)) {
+          fs9.mkdirSync(personasDir, { recursive: true });
         }
-        const personaPath = path13.join(personasDir, `${name}.yaml`);
-        if (fs7.existsSync(personaPath)) {
+        const personaPath = path18.join(personasDir, `${name}.yaml`);
+        if (fs9.existsSync(personaPath)) {
           return Err10(new CLIError(`Persona ${name} already exists`, ExitCode.ERROR));
         }
-        fs7.writeFileSync(
+        fs9.writeFileSync(
           personaPath,
           `name: ${name}
 description: ${name} persona
@@ -1744,7 +2459,7 @@ focus_areas: []
         );
       }
     }
-    return Ok12({ created });
+    return Ok14({ created });
   } catch (error) {
     return Err10(
       new CLIError(
@@ -1755,7 +2470,7 @@ focus_areas: []
   }
 }
 function createAddCommand() {
-  const command = new Command11("add").description("Add a component to the project").argument("<type>", "Component type (layer, module, doc, skill, persona)").argument("<name>", "Component name").action(async (type, name, _opts, cmd) => {
+  const command = new Command14("add").description("Add a component to the project").argument("<type>", "Component type (layer, module, doc, skill, persona)").argument("<name>", "Component name").action(async (type, name, _opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const result = await runAdd(type, name, {
       ...globalOpts.config !== void 0 && { configPath: globalOpts.config }
@@ -1776,13 +2491,13 @@ function createAddCommand() {
 }
 
 // src/commands/linter/index.ts
-import { Command as Command14 } from "commander";
+import { Command as Command17 } from "commander";
 
 // src/commands/linter/generate.ts
-import { Command as Command12 } from "commander";
+import { Command as Command15 } from "commander";
 import { generate } from "@harness-engineering/linter-gen";
 function createGenerateCommand() {
-  return new Command12("generate").description("Generate ESLint rules from harness-linter.yml").option("-c, --config <path>", "Path to harness-linter.yml", "./harness-linter.yml").option("-o, --output <dir>", "Override output directory").option("--clean", "Remove existing files before generating").option("--dry-run", "Preview without writing files").option("--json", "Output as JSON").option("--verbose", "Show detailed output").action(async (options) => {
+  return new Command15("generate").description("Generate ESLint rules from harness-linter.yml").option("-c, --config <path>", "Path to harness-linter.yml", "./harness-linter.yml").option("-o, --output <dir>", "Override output directory").option("--clean", "Remove existing files before generating").option("--dry-run", "Preview without writing files").option("--json", "Output as JSON").option("--verbose", "Show detailed output").action(async (options) => {
     try {
       if (options.verbose) {
         logger.info(`Parsing config: ${options.config}`);
@@ -1844,10 +2559,10 @@ Generated ${result.rulesGenerated.length} rules to ${result.outputDir}`);
 }
 
 // src/commands/linter/validate.ts
-import { Command as Command13 } from "commander";
+import { Command as Command16 } from "commander";
 import { validate } from "@harness-engineering/linter-gen";
 function createValidateCommand2() {
-  return new Command13("validate").description("Validate harness-linter.yml config").option("-c, --config <path>", "Path to harness-linter.yml", "./harness-linter.yml").option("--json", "Output as JSON").action(async (options) => {
+  return new Command16("validate").description("Validate harness-linter.yml config").option("-c, --config <path>", "Path to harness-linter.yml", "./harness-linter.yml").option("--json", "Output as JSON").action(async (options) => {
     try {
       const result = await validate({ configPath: options.config });
       if (options.json) {
@@ -1866,7 +2581,7 @@ function createValidateCommand2() {
 
 // src/commands/linter/index.ts
 function createLinterCommand() {
-  const linter = new Command14("linter").description(
+  const linter = new Command17("linter").description(
     "Generate and validate ESLint rules from YAML config"
   );
   linter.addCommand(createGenerateCommand());
@@ -1875,12 +2590,12 @@ function createLinterCommand() {
 }
 
 // src/commands/persona/index.ts
-import { Command as Command17 } from "commander";
+import { Command as Command20 } from "commander";
 
 // src/commands/persona/list.ts
-import { Command as Command15 } from "commander";
+import { Command as Command18 } from "commander";
 function createListCommand() {
-  return new Command15("list").description("List available agent personas").action(async (_opts, cmd) => {
+  return new Command18("list").description("List available agent personas").action(async (_opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const personasDir = resolvePersonasDir();
     const result = listPersonas(personasDir);
@@ -1909,12 +2624,12 @@ function createListCommand() {
 }
 
 // src/commands/persona/generate.ts
-import { Command as Command16 } from "commander";
-import * as fs8 from "fs";
-import * as path14 from "path";
+import { Command as Command19 } from "commander";
+import * as fs10 from "fs";
+import * as path19 from "path";
 
 // src/persona/generators/runtime.ts
-import { Ok as Ok13, Err as Err11 } from "@harness-engineering/core";
+import { Ok as Ok15, Err as Err11 } from "@harness-engineering/core";
 
 // src/utils/string.ts
 function toKebabCase(name) {
@@ -1927,11 +2642,11 @@ function generateRuntime(persona) {
     const config = {
       name: toKebabCase(persona.name),
       skills: persona.skills,
-      commands: persona.commands,
+      steps: persona.steps,
       timeout: persona.config.timeout,
       severity: persona.config.severity
     };
-    return Ok13(JSON.stringify(config, null, 2));
+    return Ok15(JSON.stringify(config, null, 2));
   } catch (error) {
     return Err11(
       new Error(
@@ -1942,7 +2657,7 @@ function generateRuntime(persona) {
 }
 
 // src/persona/generators/agents-md.ts
-import { Ok as Ok14, Err as Err12 } from "@harness-engineering/core";
+import { Ok as Ok16, Err as Err12 } from "@harness-engineering/core";
 function formatTrigger(trigger) {
   switch (trigger.event) {
     case "on_pr": {
@@ -1955,13 +2670,17 @@ function formatTrigger(trigger) {
     }
     case "scheduled":
       return `Scheduled (cron: ${trigger.cron})`;
+    case "manual":
+      return "Manual";
   }
 }
 function generateAgentsMd(persona) {
   try {
     const triggers = persona.triggers.map(formatTrigger).join(", ");
     const skills = persona.skills.join(", ");
-    const commands = persona.commands.map((c) => `\`harness ${c}\``).join(", ");
+    const commands = persona.steps.filter((s) => "command" in s).map((s) => `\`harness ${s.command}\``).join(", ");
+    const stepSkills = persona.steps.filter((s) => "skill" in s).map((s) => `\`harness skill run ${s.skill}\``).join(", ");
+    const allCommands = [commands, stepSkills].filter(Boolean).join(", ");
     const fragment = `## ${persona.name} Agent
 
 **Role:** ${persona.role}
@@ -1970,9 +2689,9 @@ function generateAgentsMd(persona) {
 
 **Skills:** ${skills}
 
-**When this agent flags an issue:** Fix violations before merging. Run ${commands} locally to validate.
+**When this agent flags an issue:** Fix violations before merging. Run ${allCommands} locally to validate.
 `;
-    return Ok14(fragment);
+    return Ok16(fragment);
   } catch (error) {
     return Err12(
       new Error(
@@ -1984,7 +2703,7 @@ function generateAgentsMd(persona) {
 
 // src/persona/generators/ci-workflow.ts
 import YAML2 from "yaml";
-import { Ok as Ok15, Err as Err13 } from "@harness-engineering/core";
+import { Ok as Ok17, Err as Err13 } from "@harness-engineering/core";
 function buildGitHubTriggers(triggers) {
   const on = {};
   for (const trigger of triggers) {
@@ -2017,9 +2736,10 @@ function generateCIWorkflow(persona, platform) {
       { uses: "actions/setup-node@v4", with: { "node-version": "20" } },
       { uses: "pnpm/action-setup@v4", with: { run_install: "frozen" } }
     ];
-    for (const cmd of persona.commands) {
+    const commandSteps = persona.steps.filter((s) => "command" in s);
+    for (const step of commandSteps) {
       const severityFlag = severity ? ` --severity ${severity}` : "";
-      steps.push({ run: `npx harness ${cmd}${severityFlag}` });
+      steps.push({ run: `npx harness ${step.command}${severityFlag}` });
     }
     const workflow = {
       name: persona.name,
@@ -2031,7 +2751,7 @@ function generateCIWorkflow(persona, platform) {
         }
       }
     };
-    return Ok15(YAML2.stringify(workflow, { lineWidth: 0 }));
+    return Ok17(YAML2.stringify(workflow, { lineWidth: 0 }));
   } catch (error) {
     return Err13(
       new Error(
@@ -2043,43 +2763,43 @@ function generateCIWorkflow(persona, platform) {
 
 // src/commands/persona/generate.ts
 function createGenerateCommand2() {
-  return new Command16("generate").description("Generate artifacts from a persona config").argument("<name>", "Persona name (e.g., architecture-enforcer)").option("--output-dir <dir>", "Output directory", ".").option("--only <type>", "Generate only: ci, agents-md, runtime").action(async (name, opts, cmd) => {
+  return new Command19("generate").description("Generate artifacts from a persona config").argument("<name>", "Persona name (e.g., architecture-enforcer)").option("--output-dir <dir>", "Output directory", ".").option("--only <type>", "Generate only: ci, agents-md, runtime").action(async (name, opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const personasDir = resolvePersonasDir();
-    const filePath = path14.join(personasDir, `${name}.yaml`);
+    const filePath = path19.join(personasDir, `${name}.yaml`);
     const personaResult = loadPersona(filePath);
     if (!personaResult.ok) {
       logger.error(personaResult.error.message);
       process.exit(ExitCode.ERROR);
     }
     const persona = personaResult.value;
-    const outputDir = path14.resolve(opts.outputDir);
+    const outputDir = path19.resolve(opts.outputDir);
     const slug = toKebabCase(persona.name);
     const only = opts.only;
     const generated = [];
     if (!only || only === "runtime") {
       const result = generateRuntime(persona);
       if (result.ok) {
-        const outPath = path14.join(outputDir, `${slug}.runtime.json`);
-        fs8.mkdirSync(path14.dirname(outPath), { recursive: true });
-        fs8.writeFileSync(outPath, result.value);
+        const outPath = path19.join(outputDir, `${slug}.runtime.json`);
+        fs10.mkdirSync(path19.dirname(outPath), { recursive: true });
+        fs10.writeFileSync(outPath, result.value);
         generated.push(outPath);
       }
     }
     if (!only || only === "agents-md") {
       const result = generateAgentsMd(persona);
       if (result.ok) {
-        const outPath = path14.join(outputDir, `${slug}.agents.md`);
-        fs8.writeFileSync(outPath, result.value);
+        const outPath = path19.join(outputDir, `${slug}.agents.md`);
+        fs10.writeFileSync(outPath, result.value);
         generated.push(outPath);
       }
     }
     if (!only || only === "ci") {
       const result = generateCIWorkflow(persona, "github");
       if (result.ok) {
-        const outPath = path14.join(outputDir, ".github", "workflows", `${slug}.yml`);
-        fs8.mkdirSync(path14.dirname(outPath), { recursive: true });
-        fs8.writeFileSync(outPath, result.value);
+        const outPath = path19.join(outputDir, ".github", "workflows", `${slug}.yml`);
+        fs10.mkdirSync(path19.dirname(outPath), { recursive: true });
+        fs10.writeFileSync(outPath, result.value);
         generated.push(outPath);
       }
     }
@@ -2093,37 +2813,37 @@ function createGenerateCommand2() {
 
 // src/commands/persona/index.ts
 function createPersonaCommand() {
-  const command = new Command17("persona").description("Agent persona management commands");
+  const command = new Command20("persona").description("Agent persona management commands");
   command.addCommand(createListCommand());
   command.addCommand(createGenerateCommand2());
   return command;
 }
 
 // src/commands/skill/index.ts
-import { Command as Command22 } from "commander";
+import { Command as Command25 } from "commander";
 
 // src/commands/skill/list.ts
-import { Command as Command18 } from "commander";
-import * as fs9 from "fs";
-import * as path15 from "path";
-import { parse as parse2 } from "yaml";
+import { Command as Command21 } from "commander";
+import * as fs11 from "fs";
+import * as path20 from "path";
+import { parse as parse3 } from "yaml";
 function createListCommand2() {
-  return new Command18("list").description("List available skills").action(async (_opts, cmd) => {
+  return new Command21("list").description("List available skills").action(async (_opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const skillsDir = resolveSkillsDir();
-    if (!fs9.existsSync(skillsDir)) {
+    if (!fs11.existsSync(skillsDir)) {
       logger.info("No skills directory found.");
       process.exit(ExitCode.SUCCESS);
       return;
     }
-    const entries = fs9.readdirSync(skillsDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
+    const entries = fs11.readdirSync(skillsDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
     const skills = [];
     for (const name of entries) {
-      const yamlPath = path15.join(skillsDir, name, "skill.yaml");
-      if (!fs9.existsSync(yamlPath)) continue;
+      const yamlPath = path20.join(skillsDir, name, "skill.yaml");
+      if (!fs11.existsSync(yamlPath)) continue;
       try {
-        const raw = fs9.readFileSync(yamlPath, "utf-8");
-        const parsed = parse2(raw);
+        const raw = fs11.readFileSync(yamlPath, "utf-8");
+        const parsed = parse3(raw);
         const result = SkillMetadataSchema.safeParse(parsed);
         if (result.success) {
           skills.push(result.data);
@@ -2152,13 +2872,13 @@ function createListCommand2() {
 }
 
 // src/commands/skill/run.ts
-import { Command as Command19 } from "commander";
-import * as fs10 from "fs";
-import * as path16 from "path";
-import { parse as parse3 } from "yaml";
+import { Command as Command22 } from "commander";
+import * as fs12 from "fs";
+import * as path21 from "path";
+import { parse as parse4 } from "yaml";
 
 // src/skill/complexity.ts
-import { execSync as execSync2 } from "child_process";
+import { execSync as execSync3 } from "child_process";
 function evaluateSignals(signals) {
   if (signals.fileCount >= 3) return "full";
   if (signals.newDir) return "full";
@@ -2170,17 +2890,17 @@ function evaluateSignals(signals) {
 }
 function detectComplexity(projectPath) {
   try {
-    const base = execSync2("git merge-base HEAD main", {
+    const base = execSync3("git merge-base HEAD main", {
       cwd: projectPath,
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     }).trim();
-    const diffFiles = execSync2(`git diff --name-only ${base}`, {
+    const diffFiles = execSync3(`git diff --name-only ${base}`, {
       cwd: projectPath,
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     }).trim().split("\n").filter(Boolean);
-    const diffStat = execSync2(`git diff --stat ${base}`, {
+    const diffStat = execSync3(`git diff --stat ${base}`, {
       cwd: projectPath,
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
@@ -2242,20 +2962,20 @@ ${options.priorState}`);
 
 // src/commands/skill/run.ts
 function createRunCommand2() {
-  return new Command19("run").description("Run a skill (outputs SKILL.md content with context preamble)").argument("<name>", "Skill name (e.g., harness-tdd)").option("--path <path>", "Project root path for context injection").option("--complexity <level>", "Complexity: auto, light, full", "auto").option("--phase <name>", "Start at a specific phase (for re-entry)").option("--party", "Enable multi-perspective evaluation").action(async (name, opts, _cmd) => {
+  return new Command22("run").description("Run a skill (outputs SKILL.md content with context preamble)").argument("<name>", "Skill name (e.g., harness-tdd)").option("--path <path>", "Project root path for context injection").option("--complexity <level>", "Complexity: auto, light, full", "auto").option("--phase <name>", "Start at a specific phase (for re-entry)").option("--party", "Enable multi-perspective evaluation").action(async (name, opts, _cmd) => {
     const skillsDir = resolveSkillsDir();
-    const skillDir = path16.join(skillsDir, name);
-    if (!fs10.existsSync(skillDir)) {
+    const skillDir = path21.join(skillsDir, name);
+    if (!fs12.existsSync(skillDir)) {
       logger.error(`Skill not found: ${name}`);
       process.exit(ExitCode.ERROR);
       return;
     }
-    const yamlPath = path16.join(skillDir, "skill.yaml");
+    const yamlPath = path21.join(skillDir, "skill.yaml");
     let metadata = null;
-    if (fs10.existsSync(yamlPath)) {
+    if (fs12.existsSync(yamlPath)) {
       try {
-        const raw = fs10.readFileSync(yamlPath, "utf-8");
-        const parsed = parse3(raw);
+        const raw = fs12.readFileSync(yamlPath, "utf-8");
+        const parsed = parse4(raw);
         const result = SkillMetadataSchema.safeParse(parsed);
         if (result.success) metadata = result.data;
       } catch {
@@ -2265,17 +2985,17 @@ function createRunCommand2() {
     if (metadata?.phases && metadata.phases.length > 0) {
       const requested = opts.complexity ?? "auto";
       if (requested === "auto") {
-        const projectPath2 = opts.path ? path16.resolve(opts.path) : process.cwd();
+        const projectPath2 = opts.path ? path21.resolve(opts.path) : process.cwd();
         complexity = detectComplexity(projectPath2);
       } else {
         complexity = requested;
       }
     }
     let principles;
-    const projectPath = opts.path ? path16.resolve(opts.path) : process.cwd();
-    const principlesPath = path16.join(projectPath, "docs", "principles.md");
-    if (fs10.existsSync(principlesPath)) {
-      principles = fs10.readFileSync(principlesPath, "utf-8");
+    const projectPath = opts.path ? path21.resolve(opts.path) : process.cwd();
+    const principlesPath = path21.join(projectPath, "docs", "principles.md");
+    if (fs12.existsSync(principlesPath)) {
+      principles = fs12.readFileSync(principlesPath, "utf-8");
     }
     let priorState;
     let stateWarning;
@@ -2290,16 +3010,16 @@ function createRunCommand2() {
       }
       if (metadata?.state.persistent && metadata.state.files.length > 0) {
         for (const stateFilePath of metadata.state.files) {
-          const fullPath = path16.join(projectPath, stateFilePath);
-          if (fs10.existsSync(fullPath)) {
-            const stat = fs10.statSync(fullPath);
+          const fullPath = path21.join(projectPath, stateFilePath);
+          if (fs12.existsSync(fullPath)) {
+            const stat = fs12.statSync(fullPath);
             if (stat.isDirectory()) {
-              const files = fs10.readdirSync(fullPath).map((f) => ({ name: f, mtime: fs10.statSync(path16.join(fullPath, f)).mtimeMs })).sort((a, b) => b.mtime - a.mtime);
+              const files = fs12.readdirSync(fullPath).map((f) => ({ name: f, mtime: fs12.statSync(path21.join(fullPath, f)).mtimeMs })).sort((a, b) => b.mtime - a.mtime);
               if (files.length > 0) {
-                priorState = fs10.readFileSync(path16.join(fullPath, files[0].name), "utf-8");
+                priorState = fs12.readFileSync(path21.join(fullPath, files[0].name), "utf-8");
               }
             } else {
-              priorState = fs10.readFileSync(fullPath, "utf-8");
+              priorState = fs12.readFileSync(fullPath, "utf-8");
             }
             break;
           }
@@ -2318,17 +3038,17 @@ function createRunCommand2() {
       ...stateWarning !== void 0 && { stateWarning },
       party: opts.party
     });
-    const skillMdPath = path16.join(skillDir, "SKILL.md");
-    if (!fs10.existsSync(skillMdPath)) {
+    const skillMdPath = path21.join(skillDir, "SKILL.md");
+    if (!fs12.existsSync(skillMdPath)) {
       logger.error(`SKILL.md not found for skill: ${name}`);
       process.exit(ExitCode.ERROR);
       return;
     }
-    let content = fs10.readFileSync(skillMdPath, "utf-8");
+    let content = fs12.readFileSync(skillMdPath, "utf-8");
     if (metadata?.state.persistent && opts.path) {
-      const stateFile = path16.join(projectPath, ".harness", "state.json");
-      if (fs10.existsSync(stateFile)) {
-        const stateContent = fs10.readFileSync(stateFile, "utf-8");
+      const stateFile = path21.join(projectPath, ".harness", "state.json");
+      if (fs12.existsSync(stateFile)) {
+        const stateContent = fs12.readFileSync(stateFile, "utf-8");
         content += `
 
 ---
@@ -2345,10 +3065,10 @@ ${stateContent}
 }
 
 // src/commands/skill/validate.ts
-import { Command as Command20 } from "commander";
-import * as fs11 from "fs";
-import * as path17 from "path";
-import { parse as parse4 } from "yaml";
+import { Command as Command23 } from "commander";
+import * as fs13 from "fs";
+import * as path22 from "path";
+import { parse as parse5 } from "yaml";
 var REQUIRED_SECTIONS = [
   "## When to Use",
   "## Process",
@@ -2357,35 +3077,35 @@ var REQUIRED_SECTIONS = [
   "## Examples"
 ];
 function createValidateCommand3() {
-  return new Command20("validate").description("Validate all skill.yaml files and SKILL.md structure").action(async (_opts, cmd) => {
+  return new Command23("validate").description("Validate all skill.yaml files and SKILL.md structure").action(async (_opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const skillsDir = resolveSkillsDir();
-    if (!fs11.existsSync(skillsDir)) {
+    if (!fs13.existsSync(skillsDir)) {
       logger.info("No skills directory found.");
       process.exit(ExitCode.SUCCESS);
       return;
     }
-    const entries = fs11.readdirSync(skillsDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
+    const entries = fs13.readdirSync(skillsDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
     const errors = [];
     let validated = 0;
     for (const name of entries) {
-      const skillDir = path17.join(skillsDir, name);
-      const yamlPath = path17.join(skillDir, "skill.yaml");
-      const skillMdPath = path17.join(skillDir, "SKILL.md");
-      if (!fs11.existsSync(yamlPath)) {
+      const skillDir = path22.join(skillsDir, name);
+      const yamlPath = path22.join(skillDir, "skill.yaml");
+      const skillMdPath = path22.join(skillDir, "SKILL.md");
+      if (!fs13.existsSync(yamlPath)) {
         errors.push(`${name}: missing skill.yaml`);
         continue;
       }
       try {
-        const raw = fs11.readFileSync(yamlPath, "utf-8");
-        const parsed = parse4(raw);
+        const raw = fs13.readFileSync(yamlPath, "utf-8");
+        const parsed = parse5(raw);
         const result = SkillMetadataSchema.safeParse(parsed);
         if (!result.success) {
           errors.push(`${name}/skill.yaml: ${result.error.message}`);
           continue;
         }
-        if (fs11.existsSync(skillMdPath)) {
-          const mdContent = fs11.readFileSync(skillMdPath, "utf-8");
+        if (fs13.existsSync(skillMdPath)) {
+          const mdContent = fs13.readFileSync(skillMdPath, "utf-8");
           for (const section of REQUIRED_SECTIONS) {
             if (!mdContent.includes(section)) {
               errors.push(`${name}/SKILL.md: missing section "${section}"`);
@@ -2426,29 +3146,29 @@ function createValidateCommand3() {
 }
 
 // src/commands/skill/info.ts
-import { Command as Command21 } from "commander";
-import * as fs12 from "fs";
-import * as path18 from "path";
-import { parse as parse5 } from "yaml";
+import { Command as Command24 } from "commander";
+import * as fs14 from "fs";
+import * as path23 from "path";
+import { parse as parse6 } from "yaml";
 function createInfoCommand() {
-  return new Command21("info").description("Show metadata for a skill").argument("<name>", "Skill name (e.g., harness-tdd)").action(async (name, _opts, cmd) => {
+  return new Command24("info").description("Show metadata for a skill").argument("<name>", "Skill name (e.g., harness-tdd)").action(async (name, _opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const skillsDir = resolveSkillsDir();
-    const skillDir = path18.join(skillsDir, name);
-    if (!fs12.existsSync(skillDir)) {
+    const skillDir = path23.join(skillsDir, name);
+    if (!fs14.existsSync(skillDir)) {
       logger.error(`Skill not found: ${name}`);
       process.exit(ExitCode.ERROR);
       return;
     }
-    const yamlPath = path18.join(skillDir, "skill.yaml");
-    if (!fs12.existsSync(yamlPath)) {
+    const yamlPath = path23.join(skillDir, "skill.yaml");
+    if (!fs14.existsSync(yamlPath)) {
       logger.error(`skill.yaml not found for skill: ${name}`);
       process.exit(ExitCode.ERROR);
       return;
     }
     try {
-      const raw = fs12.readFileSync(yamlPath, "utf-8");
-      const parsed = parse5(raw);
+      const raw = fs14.readFileSync(yamlPath, "utf-8");
+      const parsed = parse6(raw);
       const result = SkillMetadataSchema.safeParse(parsed);
       if (!result.success) {
         logger.error(`Invalid skill.yaml: ${result.error.message}`);
@@ -2488,7 +3208,7 @@ function createInfoCommand() {
 
 // src/commands/skill/index.ts
 function createSkillCommand() {
-  const command = new Command22("skill").description("Skill management commands");
+  const command = new Command25("skill").description("Skill management commands");
   command.addCommand(createListCommand2());
   command.addCommand(createRunCommand2());
   command.addCommand(createValidateCommand3());
@@ -2497,17 +3217,17 @@ function createSkillCommand() {
 }
 
 // src/commands/state/index.ts
-import { Command as Command26 } from "commander";
+import { Command as Command30 } from "commander";
 
 // src/commands/state/show.ts
-import { Command as Command23 } from "commander";
-import * as path19 from "path";
+import { Command as Command26 } from "commander";
+import * as path24 from "path";
 import { loadState } from "@harness-engineering/core";
 function createShowCommand() {
-  return new Command23("show").description("Show current project state").option("--path <path>", "Project root path", ".").action(async (opts, cmd) => {
+  return new Command26("show").description("Show current project state").option("--path <path>", "Project root path", ".").option("--stream <name>", "Target a specific stream").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
-    const projectPath = path19.resolve(opts.path);
-    const result = await loadState(projectPath);
+    const projectPath = path24.resolve(opts.path);
+    const result = await loadState(projectPath, opts.stream);
     if (!result.ok) {
       logger.error(result.error.message);
       process.exit(ExitCode.ERROR);
@@ -2519,6 +3239,7 @@ function createShowCommand() {
     } else if (globalOpts.quiet) {
       console.log(JSON.stringify(state));
     } else {
+      if (opts.stream) console.log(`Stream:         ${opts.stream}`);
       console.log(`Schema Version: ${state.schemaVersion}`);
       if (state.position.phase) console.log(`Phase:          ${state.position.phase}`);
       if (state.position.task) console.log(`Task:           ${state.position.task}`);
@@ -2545,23 +3266,35 @@ Decisions: ${state.decisions.length}`);
 }
 
 // src/commands/state/reset.ts
-import { Command as Command24 } from "commander";
-import * as fs13 from "fs";
-import * as path20 from "path";
+import { Command as Command27 } from "commander";
+import * as fs15 from "fs";
+import * as path25 from "path";
 import * as readline from "readline";
+import { resolveStreamPath } from "@harness-engineering/core";
 function createResetCommand() {
-  return new Command24("reset").description("Reset project state (deletes .harness/state.json)").option("--path <path>", "Project root path", ".").option("--yes", "Skip confirmation prompt").action(async (opts, _cmd) => {
-    const projectPath = path20.resolve(opts.path);
-    const statePath = path20.join(projectPath, ".harness", "state.json");
-    if (!fs13.existsSync(statePath)) {
+  return new Command27("reset").description("Reset project state (deletes .harness/state.json)").option("--path <path>", "Project root path", ".").option("--stream <name>", "Target a specific stream").option("--yes", "Skip confirmation prompt").action(async (opts, _cmd) => {
+    const projectPath = path25.resolve(opts.path);
+    let statePath;
+    if (opts.stream) {
+      const streamResult = await resolveStreamPath(projectPath, { stream: opts.stream });
+      if (!streamResult.ok) {
+        logger.error(streamResult.error.message);
+        process.exit(ExitCode.ERROR);
+        return;
+      }
+      statePath = path25.join(streamResult.value, "state.json");
+    } else {
+      statePath = path25.join(projectPath, ".harness", "state.json");
+    }
+    if (!fs15.existsSync(statePath)) {
       logger.info("No state file found. Nothing to reset.");
       process.exit(ExitCode.SUCCESS);
       return;
     }
     if (!opts.yes) {
       const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-      const answer = await new Promise((resolve14) => {
-        rl.question("Reset project state? This cannot be undone. [y/N] ", resolve14);
+      const answer = await new Promise((resolve22) => {
+        rl.question("Reset project state? This cannot be undone. [y/N] ", resolve22);
       });
       rl.close();
       if (answer.toLowerCase() !== "y" && answer.toLowerCase() !== "yes") {
@@ -2571,7 +3304,7 @@ function createResetCommand() {
       }
     }
     try {
-      fs13.unlinkSync(statePath);
+      fs15.unlinkSync(statePath);
       logger.success("Project state reset.");
     } catch (e) {
       logger.error(`Failed to reset state: ${e instanceof Error ? e.message : String(e)}`);
@@ -2583,13 +3316,13 @@ function createResetCommand() {
 }
 
 // src/commands/state/learn.ts
-import { Command as Command25 } from "commander";
-import * as path21 from "path";
+import { Command as Command28 } from "commander";
+import * as path26 from "path";
 import { appendLearning } from "@harness-engineering/core";
 function createLearnCommand() {
-  return new Command25("learn").description("Append a learning to .harness/learnings.md").argument("<message>", "The learning to record").option("--path <path>", "Project root path", ".").action(async (message, opts, _cmd) => {
-    const projectPath = path21.resolve(opts.path);
-    const result = await appendLearning(projectPath, message);
+  return new Command28("learn").description("Append a learning to .harness/learnings.md").argument("<message>", "The learning to record").option("--path <path>", "Project root path", ".").option("--stream <name>", "Target a specific stream").action(async (message, opts, _cmd) => {
+    const projectPath = path26.resolve(opts.path);
+    const result = await appendLearning(projectPath, message, void 0, void 0, opts.stream);
     if (!result.ok) {
       logger.error(result.error.message);
       process.exit(ExitCode.ERROR);
@@ -2600,29 +3333,103 @@ function createLearnCommand() {
   });
 }
 
+// src/commands/state/streams.ts
+import { Command as Command29 } from "commander";
+import * as path27 from "path";
+import {
+  createStream,
+  listStreams,
+  archiveStream,
+  setActiveStream,
+  loadStreamIndex
+} from "@harness-engineering/core";
+function createStreamsCommand() {
+  const command = new Command29("streams").description("Manage state streams");
+  command.command("list").description("List all known streams").option("--path <path>", "Project root path", ".").action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const projectPath = path27.resolve(opts.path);
+    const indexResult = await loadStreamIndex(projectPath);
+    const result = await listStreams(projectPath);
+    if (!result.ok) {
+      logger.error(result.error.message);
+      process.exit(ExitCode.ERROR);
+      return;
+    }
+    const active = indexResult.ok ? indexResult.value.activeStream : null;
+    if (globalOpts.json) {
+      logger.raw({ activeStream: active, streams: result.value });
+    } else {
+      if (result.value.length === 0) {
+        console.log("No streams found.");
+      }
+      for (const s of result.value) {
+        const marker = s.name === active ? " (active)" : "";
+        const branch = s.branch ? ` [${s.branch}]` : "";
+        console.log(`  ${s.name}${marker}${branch} \u2014 last active: ${s.lastActiveAt}`);
+      }
+    }
+    process.exit(ExitCode.SUCCESS);
+  });
+  command.command("create <name>").description("Create a new stream").option("--path <path>", "Project root path", ".").option("--branch <branch>", "Associate with a git branch").action(async (name, opts) => {
+    const projectPath = path27.resolve(opts.path);
+    const result = await createStream(projectPath, name, opts.branch);
+    if (!result.ok) {
+      logger.error(result.error.message);
+      process.exit(ExitCode.ERROR);
+      return;
+    }
+    logger.success(`Stream '${name}' created.`);
+    process.exit(ExitCode.SUCCESS);
+  });
+  command.command("archive <name>").description("Archive a stream").option("--path <path>", "Project root path", ".").action(async (name, opts) => {
+    const projectPath = path27.resolve(opts.path);
+    const result = await archiveStream(projectPath, name);
+    if (!result.ok) {
+      logger.error(result.error.message);
+      process.exit(ExitCode.ERROR);
+      return;
+    }
+    logger.success(`Stream '${name}' archived.`);
+    process.exit(ExitCode.SUCCESS);
+  });
+  command.command("activate <name>").description("Set the active stream").option("--path <path>", "Project root path", ".").action(async (name, opts) => {
+    const projectPath = path27.resolve(opts.path);
+    const result = await setActiveStream(projectPath, name);
+    if (!result.ok) {
+      logger.error(result.error.message);
+      process.exit(ExitCode.ERROR);
+      return;
+    }
+    logger.success(`Active stream set to '${name}'.`);
+    process.exit(ExitCode.SUCCESS);
+  });
+  return command;
+}
+
 // src/commands/state/index.ts
 function createStateCommand() {
-  const command = new Command26("state").description("Project state management commands");
+  const command = new Command30("state").description("Project state management commands");
   command.addCommand(createShowCommand());
   command.addCommand(createResetCommand());
   command.addCommand(createLearnCommand());
+  command.addCommand(createStreamsCommand());
   return command;
 }
 
 // src/commands/check-phase-gate.ts
-import { Command as Command27 } from "commander";
-import * as path22 from "path";
-import * as fs14 from "fs";
-import { Ok as Ok16 } from "@harness-engineering/core";
+import { Command as Command31 } from "commander";
+import * as path28 from "path";
+import * as fs16 from "fs";
+import { Ok as Ok18 } from "@harness-engineering/core";
 function resolveSpecPath(implFile, implPattern, specPattern, cwd) {
-  const relImpl = path22.relative(cwd, implFile);
+  const relImpl = path28.relative(cwd, implFile);
   const implBase = (implPattern.split("*")[0] ?? "").replace(/\/+$/, "");
   const afterBase = relImpl.startsWith(implBase + "/") ? relImpl.slice(implBase.length + 1) : relImpl;
   const segments = afterBase.split("/");
   const firstSegment = segments[0] ?? "";
-  const feature = segments.length > 1 ? firstSegment : path22.basename(firstSegment, path22.extname(firstSegment));
+  const feature = segments.length > 1 ? firstSegment : path28.basename(firstSegment, path28.extname(firstSegment));
   const specRelative = specPattern.replace("{feature}", feature);
-  return path22.resolve(cwd, specRelative);
+  return path28.resolve(cwd, specRelative);
 }
 async function runCheckPhaseGate(options) {
   const configResult = resolveConfig(options.configPath);
@@ -2630,9 +3437,9 @@ async function runCheckPhaseGate(options) {
     return configResult;
   }
   const config = configResult.value;
-  const cwd = options.cwd ?? (options.configPath ? path22.dirname(path22.resolve(options.configPath)) : process.cwd());
+  const cwd = options.cwd ?? (options.configPath ? path28.dirname(path28.resolve(options.configPath)) : process.cwd());
   if (!config.phaseGates?.enabled) {
-    return Ok16({
+    return Ok18({
       pass: true,
       skipped: true,
       missingSpecs: [],
@@ -2647,16 +3454,16 @@ async function runCheckPhaseGate(options) {
     for (const implFile of implFiles) {
       checkedFiles++;
       const expectedSpec = resolveSpecPath(implFile, mapping.implPattern, mapping.specPattern, cwd);
-      if (!fs14.existsSync(expectedSpec)) {
+      if (!fs16.existsSync(expectedSpec)) {
         missingSpecs.push({
-          implFile: path22.relative(cwd, implFile),
-          expectedSpec: path22.relative(cwd, expectedSpec)
+          implFile: path28.relative(cwd, implFile),
+          expectedSpec: path28.relative(cwd, expectedSpec)
         });
       }
     }
   }
   const pass = missingSpecs.length === 0;
-  return Ok16({
+  return Ok18({
     pass,
     skipped: false,
     severity: phaseGates.severity,
@@ -2665,7 +3472,7 @@ async function runCheckPhaseGate(options) {
   });
 }
 function createCheckPhaseGateCommand() {
-  const command = new Command27("check-phase-gate").description("Verify that implementation files have matching spec documents").action(async (_opts, cmd) => {
+  const command = new Command31("check-phase-gate").description("Verify that implementation files have matching spec documents").action(async (_opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const mode = globalOpts.json ? OutputMode.JSON : globalOpts.quiet ? OutputMode.QUIET : globalOpts.verbose ? OutputMode.VERBOSE : OutputMode.TEXT;
     const formatter = new OutputFormatter(mode);
@@ -2719,16 +3526,16 @@ function createCheckPhaseGateCommand() {
 }
 
 // src/commands/generate-slash-commands.ts
-import { Command as Command28 } from "commander";
-import fs17 from "fs";
-import path25 from "path";
+import { Command as Command32 } from "commander";
+import fs19 from "fs";
+import path31 from "path";
 import os2 from "os";
 import readline2 from "readline";
 
 // src/slash-commands/normalize.ts
-import fs15 from "fs";
-import path23 from "path";
-import { parse as parse6 } from "yaml";
+import fs17 from "fs";
+import path29 from "path";
+import { parse as parse7 } from "yaml";
 
 // src/slash-commands/normalize-name.ts
 function normalizeName(skillName) {
@@ -2744,106 +3551,117 @@ function normalizeName(skillName) {
 }
 
 // src/slash-commands/normalize.ts
-function normalizeSkills(skillsDir, platforms) {
-  const entries = fs15.readdirSync(skillsDir, { withFileTypes: true }).filter((d) => d.isDirectory());
+function normalizeSkills(skillSources, platforms) {
   const specs = [];
   const nameMap = /* @__PURE__ */ new Map();
-  for (const entry of entries) {
-    const yamlPath = path23.join(skillsDir, entry.name, "skill.yaml");
-    if (!fs15.existsSync(yamlPath)) continue;
-    let raw;
-    try {
-      raw = fs15.readFileSync(yamlPath, "utf-8");
-    } catch {
-      continue;
-    }
-    const parsed = parse6(raw);
-    const result = SkillMetadataSchema.safeParse(parsed);
-    if (!result.success) {
-      console.warn(`Skipping ${entry.name}: invalid skill.yaml`);
-      continue;
-    }
-    const meta = result.data;
-    const matchesPlatform = platforms.some((p) => meta.platforms.includes(p));
-    if (!matchesPlatform) continue;
-    const normalized = normalizeName(meta.name);
-    if (nameMap.has(normalized)) {
-      throw new Error(
-        `Name collision: skills "${nameMap.get(normalized)}" and "${meta.name}" both normalize to "${normalized}"`
+  for (const { dir: skillsDir, source } of skillSources) {
+    if (!fs17.existsSync(skillsDir)) continue;
+    const entries = fs17.readdirSync(skillsDir, { withFileTypes: true }).filter((d) => d.isDirectory());
+    for (const entry of entries) {
+      const yamlPath = path29.join(skillsDir, entry.name, "skill.yaml");
+      if (!fs17.existsSync(yamlPath)) continue;
+      let raw;
+      try {
+        raw = fs17.readFileSync(yamlPath, "utf-8");
+      } catch {
+        continue;
+      }
+      const parsed = parse7(raw);
+      const result = SkillMetadataSchema.safeParse(parsed);
+      if (!result.success) {
+        console.warn(`Skipping ${entry.name}: invalid skill.yaml`);
+        continue;
+      }
+      const meta = result.data;
+      const matchesPlatform = platforms.some((p) => meta.platforms.includes(p));
+      if (!matchesPlatform) continue;
+      const normalized = normalizeName(meta.name);
+      const existing = nameMap.get(normalized);
+      if (existing) {
+        if (existing.source === source) {
+          throw new Error(
+            `Name collision: skills "${existing.skillName}" and "${meta.name}" both normalize to "${normalized}"`
+          );
+        }
+        continue;
+      }
+      nameMap.set(normalized, { skillName: meta.name, source });
+      const skillMdPath = path29.join(skillsDir, entry.name, "SKILL.md");
+      const skillMdContent = fs17.existsSync(skillMdPath) ? fs17.readFileSync(skillMdPath, "utf-8") : "";
+      const skillMdRelative = path29.relative(
+        process.cwd(),
+        path29.join(skillsDir, entry.name, "SKILL.md")
       );
-    }
-    nameMap.set(normalized, meta.name);
-    const skillMdPath = path23.join(skillsDir, entry.name, "SKILL.md");
-    const skillMdContent = fs15.existsSync(skillMdPath) ? fs15.readFileSync(skillMdPath, "utf-8") : "";
-    const skillMdRelative = path23.relative(
-      process.cwd(),
-      path23.join(skillsDir, entry.name, "SKILL.md")
-    );
-    const skillYamlRelative = path23.relative(
-      process.cwd(),
-      path23.join(skillsDir, entry.name, "skill.yaml")
-    );
-    const args = (meta.cli?.args ?? []).map((a) => ({
-      name: a.name,
-      description: a.description ?? "",
-      required: a.required ?? false
-    }));
-    const tools = [...meta.tools ?? []];
-    if (!tools.includes("Read")) {
-      tools.push("Read");
-    }
-    const contextLines = [];
-    if (meta.cognitive_mode) {
-      contextLines.push(`Cognitive mode: ${meta.cognitive_mode}`);
-    }
-    if (meta.type) {
-      contextLines.push(`Type: ${meta.type}`);
-    }
-    if (meta.state?.persistent) {
-      const files = meta.state.files?.join(", ") ?? "";
-      contextLines.push(`State: persistent${files ? ` (files: ${files})` : ""}`);
-    }
-    const objectiveLines = [meta.description];
-    if (meta.phases && meta.phases.length > 0) {
-      objectiveLines.push("");
-      objectiveLines.push("Phases:");
-      for (const phase of meta.phases) {
-        const req = phase.required !== false ? "" : " (optional)";
-        objectiveLines.push(`- ${phase.name}: ${phase.description}${req}`);
+      const skillYamlRelative = path29.relative(
+        process.cwd(),
+        path29.join(skillsDir, entry.name, "skill.yaml")
+      );
+      const args = (meta.cli?.args ?? []).map((a) => ({
+        name: a.name,
+        description: a.description ?? "",
+        required: a.required ?? false
+      }));
+      const tools = [...meta.tools ?? []];
+      if (!tools.includes("Read")) {
+        tools.push("Read");
       }
-    }
-    const executionContextLines = [];
-    if (skillMdContent) {
-      executionContextLines.push(`@${skillMdRelative}`);
-      executionContextLines.push(`@${skillYamlRelative}`);
-    }
-    const processLines = [];
-    if (meta.mcp?.tool) {
-      processLines.push(`1. Try: invoke mcp__harness__${meta.mcp.tool} with skill: "${meta.name}"`);
-      processLines.push(`2. If MCP unavailable: read SKILL.md and follow its workflow directly`);
-      processLines.push(`3. Pass through any arguments provided by the user`);
-    } else {
-      processLines.push(`1. Read SKILL.md and follow its workflow directly`);
-      processLines.push(`2. Pass through any arguments provided by the user`);
-    }
-    specs.push({
-      name: normalized,
-      namespace: "harness",
-      fullName: `harness:${normalized}`,
-      description: meta.description,
-      version: meta.version,
-      ...meta.cognitive_mode ? { cognitiveMode: meta.cognitive_mode } : {},
-      tools,
-      args,
-      skillYamlName: meta.name,
-      sourceDir: entry.name,
-      prompt: {
-        context: contextLines.join("\n"),
-        objective: objectiveLines.join("\n"),
-        executionContext: executionContextLines.join("\n"),
-        process: processLines.join("\n")
+      const contextLines = [];
+      if (meta.cognitive_mode) {
+        contextLines.push(`Cognitive mode: ${meta.cognitive_mode}`);
       }
-    });
+      if (meta.type) {
+        contextLines.push(`Type: ${meta.type}`);
+      }
+      if (meta.state?.persistent) {
+        const files = meta.state.files?.join(", ") ?? "";
+        contextLines.push(`State: persistent${files ? ` (files: ${files})` : ""}`);
+      }
+      const objectiveLines = [meta.description];
+      if (meta.phases && meta.phases.length > 0) {
+        objectiveLines.push("");
+        objectiveLines.push("Phases:");
+        for (const phase of meta.phases) {
+          const req = phase.required !== false ? "" : " (optional)";
+          objectiveLines.push(`- ${phase.name}: ${phase.description}${req}`);
+        }
+      }
+      const executionContextLines = [];
+      if (skillMdContent) {
+        executionContextLines.push(`@${skillMdRelative}`);
+        executionContextLines.push(`@${skillYamlRelative}`);
+      }
+      const processLines = [];
+      if (meta.mcp?.tool) {
+        processLines.push(
+          `1. Try: invoke mcp__harness__${meta.mcp.tool} with skill: "${meta.name}"`
+        );
+        processLines.push(`2. If MCP unavailable: read SKILL.md and follow its workflow directly`);
+        processLines.push(`3. Pass through any arguments provided by the user`);
+      } else {
+        processLines.push(`1. Read SKILL.md and follow its workflow directly`);
+        processLines.push(`2. Pass through any arguments provided by the user`);
+      }
+      specs.push({
+        name: normalized,
+        namespace: "harness",
+        fullName: `harness:${normalized}`,
+        description: meta.description,
+        version: meta.version,
+        ...meta.cognitive_mode ? { cognitiveMode: meta.cognitive_mode } : {},
+        tools,
+        args,
+        skillYamlName: meta.name,
+        sourceDir: entry.name,
+        skillsBaseDir: skillsDir,
+        source,
+        prompt: {
+          context: contextLines.join("\n"),
+          objective: objectiveLines.join("\n"),
+          executionContext: executionContextLines.join("\n"),
+          process: processLines.join("\n")
+        }
+      });
+    }
   }
   return specs;
 }
@@ -2945,19 +3763,24 @@ function renderGemini(spec, skillMdContent, skillYamlContent) {
 }
 
 // src/slash-commands/sync.ts
-import fs16 from "fs";
-import path24 from "path";
+import fs18 from "fs";
+import path30 from "path";
+
+// src/agent-definitions/constants.ts
+var GENERATED_HEADER_AGENT = "<!-- Generated by harness generate-agent-definitions. Do not edit. -->";
+
+// src/slash-commands/sync.ts
 function computeSyncPlan(outputDir, rendered) {
   const added = [];
   const updated = [];
   const removed = [];
   const unchanged = [];
   for (const [filename, content] of rendered) {
-    const filePath = path24.join(outputDir, filename);
-    if (!fs16.existsSync(filePath)) {
+    const filePath = path30.join(outputDir, filename);
+    if (!fs18.existsSync(filePath)) {
       added.push(filename);
     } else {
-      const existing = fs16.readFileSync(filePath, "utf-8");
+      const existing = fs18.readFileSync(filePath, "utf-8");
       if (existing === content) {
         unchanged.push(filename);
       } else {
@@ -2965,15 +3788,15 @@ function computeSyncPlan(outputDir, rendered) {
       }
     }
   }
-  if (fs16.existsSync(outputDir)) {
-    const existing = fs16.readdirSync(outputDir).filter((f) => {
-      const stat = fs16.statSync(path24.join(outputDir, f));
+  if (fs18.existsSync(outputDir)) {
+    const existing = fs18.readdirSync(outputDir).filter((f) => {
+      const stat = fs18.statSync(path30.join(outputDir, f));
       return stat.isFile();
     });
     for (const filename of existing) {
       if (rendered.has(filename)) continue;
-      const content = fs16.readFileSync(path24.join(outputDir, filename), "utf-8");
-      if (content.includes(GENERATED_HEADER_CLAUDE) || content.includes(GENERATED_HEADER_GEMINI)) {
+      const content = fs18.readFileSync(path30.join(outputDir, filename), "utf-8");
+      if (content.includes(GENERATED_HEADER_CLAUDE) || content.includes(GENERATED_HEADER_GEMINI) || content.includes(GENERATED_HEADER_AGENT)) {
         removed.push(filename);
       }
     }
@@ -2981,18 +3804,18 @@ function computeSyncPlan(outputDir, rendered) {
   return { added, updated, removed, unchanged };
 }
 function applySyncPlan(outputDir, rendered, plan, deleteOrphans) {
-  fs16.mkdirSync(outputDir, { recursive: true });
+  fs18.mkdirSync(outputDir, { recursive: true });
   for (const filename of [...plan.added, ...plan.updated]) {
     const content = rendered.get(filename);
     if (content !== void 0) {
-      fs16.writeFileSync(path24.join(outputDir, filename), content);
+      fs18.writeFileSync(path30.join(outputDir, filename), content);
     }
   }
   if (deleteOrphans) {
     for (const filename of plan.removed) {
-      const filePath = path24.join(outputDir, filename);
-      if (fs16.existsSync(filePath)) {
-        fs16.unlinkSync(filePath);
+      const filePath = path30.join(outputDir, filename);
+      if (fs18.existsSync(filePath)) {
+        fs18.unlinkSync(filePath);
       }
     }
   }
@@ -3001,30 +3824,44 @@ function applySyncPlan(outputDir, rendered, plan, deleteOrphans) {
 // src/commands/generate-slash-commands.ts
 function resolveOutputDir(platform, opts) {
   if (opts.output) {
-    return path25.join(opts.output, "harness");
+    return path31.join(opts.output, "harness");
   }
   if (opts.global) {
     const home = os2.homedir();
-    return platform === "claude-code" ? path25.join(home, ".claude", "commands", "harness") : path25.join(home, ".gemini", "commands", "harness");
+    return platform === "claude-code" ? path31.join(home, ".claude", "commands", "harness") : path31.join(home, ".gemini", "commands", "harness");
   }
-  return platform === "claude-code" ? path25.join("agents", "commands", "claude-code", "harness") : path25.join("agents", "commands", "gemini-cli", "harness");
+  return platform === "claude-code" ? path31.join("agents", "commands", "claude-code", "harness") : path31.join("agents", "commands", "gemini-cli", "harness");
 }
 function fileExtension(platform) {
   return platform === "claude-code" ? ".md" : ".toml";
 }
 async function confirmDeletion(files) {
   const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve14) => {
+  return new Promise((resolve22) => {
     rl.question(`
 Remove ${files.length} orphaned command(s)? (y/N) `, (answer) => {
       rl.close();
-      resolve14(answer.toLowerCase() === "y");
+      resolve22(answer.toLowerCase() === "y");
     });
   });
 }
 function generateSlashCommands(opts) {
-  const skillsDir = opts.skillsDir || resolveSkillsDir();
-  const specs = normalizeSkills(skillsDir, opts.platforms);
+  const skillSources = [];
+  if (opts.skillsDir) {
+    skillSources.push({ dir: opts.skillsDir, source: "project" });
+  } else {
+    const projectDir = resolveProjectSkillsDir();
+    if (projectDir) {
+      skillSources.push({ dir: projectDir, source: "project" });
+    }
+    if (opts.includeGlobal || skillSources.length === 0) {
+      const globalDir = resolveGlobalSkillsDir();
+      if (!projectDir || path31.resolve(globalDir) !== path31.resolve(projectDir)) {
+        skillSources.push({ dir: globalDir, source: "global" });
+      }
+    }
+  }
+  const specs = normalizeSkills(skillSources, opts.platforms);
   const results = [];
   for (const platform of opts.platforms) {
     const outputDir = resolveOutputDir(platform, opts);
@@ -3041,7 +3878,7 @@ function generateSlashCommands(opts) {
             executionContext: spec.prompt.executionContext.split("\n").map((line) => {
               if (line.startsWith("@")) {
                 const relPath = line.slice(1);
-                return `@${path25.resolve(relPath)}`;
+                return `@${path31.resolve(relPath)}`;
               }
               return line;
             }).join("\n")
@@ -3049,10 +3886,10 @@ function generateSlashCommands(opts) {
         } : spec;
         rendered.set(filename, renderClaudeCode(renderSpec));
       } else {
-        const mdPath = path25.join(skillsDir, spec.sourceDir, "SKILL.md");
-        const yamlPath = path25.join(skillsDir, spec.sourceDir, "skill.yaml");
-        const mdContent = fs17.existsSync(mdPath) ? fs17.readFileSync(mdPath, "utf-8") : "";
-        const yamlContent = fs17.existsSync(yamlPath) ? fs17.readFileSync(yamlPath, "utf-8") : "";
+        const mdPath = path31.join(spec.skillsBaseDir, spec.sourceDir, "SKILL.md");
+        const yamlPath = path31.join(spec.skillsBaseDir, spec.sourceDir, "skill.yaml");
+        const mdContent = fs19.existsSync(mdPath) ? fs19.readFileSync(mdPath, "utf-8") : "";
+        const yamlContent = fs19.existsSync(yamlPath) ? fs19.readFileSync(yamlPath, "utf-8") : "";
         rendered.set(filename, renderGemini(spec, mdContent, yamlContent));
       }
     }
@@ -3078,18 +3915,18 @@ async function handleOrphanDeletion(results, opts) {
     const shouldDelete = opts.yes || await confirmDeletion(result.removed);
     if (shouldDelete) {
       for (const filename of result.removed) {
-        const filePath = path25.join(result.outputDir, filename);
-        if (fs17.existsSync(filePath)) {
-          fs17.unlinkSync(filePath);
+        const filePath = path31.join(result.outputDir, filename);
+        if (fs19.existsSync(filePath)) {
+          fs19.unlinkSync(filePath);
         }
       }
     }
   }
 }
 function createGenerateSlashCommandsCommand() {
-  return new Command28("generate-slash-commands").description(
+  return new Command32("generate-slash-commands").description(
     "Generate native slash commands for Claude Code and Gemini CLI from skill metadata"
-  ).option("--platforms <list>", "Target platforms (comma-separated)", "claude-code,gemini-cli").option("--global", "Write to global config directories", false).option("--output <dir>", "Custom output directory").option("--skills-dir <path>", "Skills directory to scan").option("--dry-run", "Show what would change without writing", false).option("--yes", "Skip deletion confirmation prompts", false).action(async (opts, cmd) => {
+  ).option("--platforms <list>", "Target platforms (comma-separated)", "claude-code,gemini-cli").option("--global", "Write to global config directories", false).option("--include-global", "Include built-in global skills alongside project skills", false).option("--output <dir>", "Custom output directory").option("--skills-dir <path>", "Skills directory to scan").option("--dry-run", "Show what would change without writing", false).option("--yes", "Skip deletion confirmation prompts", false).action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const platforms = opts.platforms.split(",").map((p) => p.trim());
     for (const p of platforms) {
@@ -3103,6 +3940,7 @@ function createGenerateSlashCommandsCommand() {
     const generateOpts = {
       platforms,
       global: opts.global,
+      includeGlobal: opts.includeGlobal,
       output: opts.output,
       skillsDir: opts.skillsDir ?? "",
       dryRun: opts.dryRun,
@@ -3114,6 +3952,16 @@ function createGenerateSlashCommandsCommand() {
         console.log(JSON.stringify(results, null, 2));
         return;
       }
+      const totalCommands = results.reduce(
+        (sum, r) => sum + r.added.length + r.updated.length + r.unchanged.length,
+        0
+      );
+      if (totalCommands === 0) {
+        console.log(
+          "\nNo skills found. Use --include-global to include built-in skills, or create a skill with: harness create-skill"
+        );
+        return;
+      }
       for (const result of results) {
         console.log(`
 ${result.platform} \u2192 ${result.outputDir}`);
@@ -3141,10 +3989,10 @@ ${result.platform} \u2192 ${result.outputDir}`);
 }
 
 // src/commands/ci/index.ts
-import { Command as Command31 } from "commander";
+import { Command as Command35 } from "commander";
 
 // src/commands/ci/check.ts
-import { Command as Command29 } from "commander";
+import { Command as Command33 } from "commander";
 import { runCIChecks } from "@harness-engineering/core";
 var VALID_CHECKS = ["validate", "deps", "docs", "entropy", "phase-gate"];
 async function runCICheck(options) {
@@ -3176,7 +4024,7 @@ function parseFailOn(failOn) {
   return "error";
 }
 function createCheckCommand() {
-  return new Command29("check").description("Run all harness checks for CI (validate, deps, docs, entropy, phase-gate)").option("--skip <checks>", "Comma-separated checks to skip (e.g., entropy,docs)").option("--fail-on <severity>", "Fail on severity level: error (default) or warning", "error").action(async (opts, cmd) => {
+  return new Command33("check").description("Run all harness checks for CI (validate, deps, docs, entropy, phase-gate)").option("--skip <checks>", "Comma-separated checks to skip (e.g., entropy,docs)").option("--fail-on <severity>", "Fail on severity level: error (default) or warning", "error").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const mode = globalOpts.json ? OutputMode.JSON : globalOpts.quiet ? OutputMode.QUIET : globalOpts.verbose ? OutputMode.VERBOSE : OutputMode.TEXT;
     const skip = parseSkip(opts.skip);
@@ -3220,10 +4068,10 @@ function createCheckCommand() {
 }
 
 // src/commands/ci/init.ts
-import { Command as Command30 } from "commander";
-import * as fs18 from "fs";
-import * as path26 from "path";
-import { Ok as Ok17, Err as Err14 } from "@harness-engineering/core";
+import { Command as Command34 } from "commander";
+import * as fs20 from "fs";
+import * as path32 from "path";
+import { Ok as Ok19, Err as Err14 } from "@harness-engineering/core";
 var ALL_CHECKS = ["validate", "deps", "docs", "entropy", "phase-gate"];
 function buildSkipFlag(checks) {
   if (!checks) return "";
@@ -3309,18 +4157,18 @@ function generateCIConfig(options) {
   if (!entry) {
     return Err14(new CLIError(`Unknown platform: ${platform}`, ExitCode.ERROR));
   }
-  return Ok17({
+  return Ok19({
     filename: entry.filename,
     content: entry.generate(skipFlag)
   });
 }
 function detectPlatform() {
-  if (fs18.existsSync(".github")) return "github";
-  if (fs18.existsSync(".gitlab-ci.yml")) return "gitlab";
+  if (fs20.existsSync(".github")) return "github";
+  if (fs20.existsSync(".gitlab-ci.yml")) return "gitlab";
   return null;
 }
 function createInitCommand2() {
-  return new Command30("init").description("Generate CI configuration for harness checks").option("--platform <platform>", "CI platform: github, gitlab, or generic").option("--checks <list>", "Comma-separated list of checks to include").action(async (opts, cmd) => {
+  return new Command34("init").description("Generate CI configuration for harness checks").option("--platform <platform>", "CI platform: github, gitlab, or generic").option("--checks <list>", "Comma-separated list of checks to include").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const platform = opts.platform ?? detectPlatform() ?? "generic";
     const checks = opts.checks ? opts.checks.split(",").map((s) => s.trim()) : void 0;
@@ -3332,12 +4180,12 @@ function createInitCommand2() {
       process.exit(result.error.exitCode);
     }
     const { filename, content } = result.value;
-    const targetPath = path26.resolve(filename);
-    const dir = path26.dirname(targetPath);
-    fs18.mkdirSync(dir, { recursive: true });
-    fs18.writeFileSync(targetPath, content);
+    const targetPath = path32.resolve(filename);
+    const dir = path32.dirname(targetPath);
+    fs20.mkdirSync(dir, { recursive: true });
+    fs20.writeFileSync(targetPath, content);
     if (platform === "generic") {
-      fs18.chmodSync(targetPath, "755");
+      fs20.chmodSync(targetPath, "755");
     }
     if (globalOpts.json) {
       console.log(JSON.stringify({ file: filename, platform }));
@@ -3350,15 +4198,15 @@ function createInitCommand2() {
 
 // src/commands/ci/index.ts
 function createCICommand() {
-  const command = new Command31("ci").description("CI/CD integration commands");
+  const command = new Command35("ci").description("CI/CD integration commands");
   command.addCommand(createCheckCommand());
   command.addCommand(createInitCommand2());
   return command;
 }
 
 // src/commands/update.ts
-import { Command as Command32 } from "commander";
-import { execSync as execSync3 } from "child_process";
+import { Command as Command36 } from "commander";
+import { execSync as execSync4 } from "child_process";
 import { realpathSync } from "fs";
 import readline3 from "readline";
 import chalk4 from "chalk";
@@ -3378,7 +4226,7 @@ function detectPackageManager() {
   return "npm";
 }
 function getLatestVersion(pkg = "@harness-engineering/cli") {
-  const output = execSync3(`npm view ${pkg} dist-tags.latest`, {
+  const output = execSync4(`npm view ${pkg} dist-tags.latest`, {
     encoding: "utf-8",
     timeout: 15e3
   });
@@ -3386,7 +4234,7 @@ function getLatestVersion(pkg = "@harness-engineering/cli") {
 }
 function getInstalledVersion(pm) {
   try {
-    const output = execSync3(`${pm} list -g @harness-engineering/cli --json`, {
+    const output = execSync4(`${pm} list -g @harness-engineering/cli --json`, {
       encoding: "utf-8",
       timeout: 15e3
     });
@@ -3399,7 +4247,7 @@ function getInstalledVersion(pm) {
 }
 function getInstalledPackages(pm) {
   try {
-    const output = execSync3(`${pm} list -g --json`, {
+    const output = execSync4(`${pm} list -g --json`, {
       encoding: "utf-8",
       timeout: 15e3
     });
@@ -3415,15 +4263,15 @@ function prompt(question) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve14) => {
+  return new Promise((resolve22) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve14(answer.trim().toLowerCase());
+      resolve22(answer.trim().toLowerCase());
     });
   });
 }
 function createUpdateCommand() {
-  return new Command32("update").description("Update all @harness-engineering packages to the latest version").option("--version <semver>", "Pin @harness-engineering/cli to a specific version").action(async (opts, cmd) => {
+  return new Command36("update").description("Update all @harness-engineering packages to the latest version").option("--version <semver>", "Pin @harness-engineering/cli to a specific version").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const pm = detectPackageManager();
     if (globalOpts.verbose) {
@@ -3466,7 +4314,7 @@ function createUpdateCommand() {
     }
     try {
       logger.info("Updating packages...");
-      execSync3(installCmd, { stdio: "inherit", timeout: 12e4 });
+      execSync4(installCmd, { stdio: "inherit", timeout: 12e4 });
       console.log("");
       logger.success("Update complete");
     } catch {
@@ -3476,28 +4324,676 @@ function createUpdateCommand() {
       process.exit(ExitCode.ERROR);
     }
     console.log("");
-    const regenAnswer = await prompt("Regenerate slash commands? (y/N) ");
+    const regenAnswer = await prompt("Regenerate slash commands and agent definitions? (y/N) ");
     if (regenAnswer === "y" || regenAnswer === "yes") {
       const scopeAnswer = await prompt("Generate for (g)lobal or (l)ocal project? (g/l) ");
       const globalFlag = scopeAnswer === "g" || scopeAnswer === "global" ? " --global" : "";
       try {
-        execSync3(`harness generate-slash-commands${globalFlag}`, { stdio: "inherit" });
+        execSync4(`harness generate${globalFlag}`, { stdio: "inherit" });
       } catch {
-        logger.warn("Slash command generation failed. Run manually:");
-        console.log(`  ${chalk4.cyan(`harness generate-slash-commands${globalFlag}`)}`);
+        logger.warn("Generation failed. Run manually:");
+        console.log(`  ${chalk4.cyan(`harness generate${globalFlag}`)}`);
       }
     }
     process.exit(ExitCode.SUCCESS);
   });
 }
 
+// src/commands/generate-agent-definitions.ts
+import { Command as Command37 } from "commander";
+import * as fs21 from "fs";
+import * as path33 from "path";
+import * as os3 from "os";
+
+// src/agent-definitions/generator.ts
+var AGENT_DESCRIPTIONS = {
+  "code-reviewer": "Perform code review and address review findings using harness methodology. Use when reviewing code, fixing review findings, responding to review feedback, or when a code review has produced issues that need to be addressed.",
+  "task-executor": "Execute implementation plans task-by-task with state tracking, TDD, and verification. Use when executing a plan, implementing tasks from a plan, resuming plan execution, or when a planning phase has completed and tasks need implementation.",
+  "parallel-coordinator": "Dispatch independent tasks across isolated agents for parallel execution. Use when multiple independent tasks need to run concurrently, splitting work across agents, or coordinating parallel implementation.",
+  "architecture-enforcer": "Validate architectural constraints and dependency rules. Use when checking layer boundaries, detecting circular dependencies, or verifying import direction compliance.",
+  "documentation-maintainer": "Keep documentation in sync with source code. Use when detecting documentation drift, validating doc coverage, or aligning docs with code changes.",
+  "entropy-cleaner": "Detect and fix codebase entropy including drift, dead code, and pattern violations. Use when running cleanup, detecting dead code, or fixing pattern violations."
+};
+var DEFAULT_TOOLS = ["Bash", "Read", "Write", "Edit", "Glob", "Grep"];
+function generateAgentDefinition(persona, skillContents) {
+  const kebabName = toKebabCase(persona.name);
+  const name = `harness-${kebabName}`;
+  const description = AGENT_DESCRIPTIONS[kebabName] ?? persona.description;
+  const methodologyParts = [];
+  for (const skillName of persona.skills) {
+    const content = skillContents.get(skillName);
+    if (content) {
+      methodologyParts.push(content);
+    }
+  }
+  return {
+    name,
+    description,
+    tools: DEFAULT_TOOLS,
+    role: persona.role,
+    skills: persona.skills,
+    steps: persona.steps,
+    methodology: methodologyParts.join("\n\n---\n\n")
+  };
+}
+
+// src/agent-definitions/render-claude-code.ts
+function formatStep(step, index) {
+  if ("command" in step && step.command) {
+    const cmd = step.command;
+    const when = step.when ?? "always";
+    return `${index + 1}. Run \`harness ${cmd}\` (${when})`;
+  }
+  if ("skill" in step && step.skill) {
+    const skill = step.skill;
+    const when = step.when ?? "always";
+    return `${index + 1}. Execute ${skill} skill (${when})`;
+  }
+  return `${index + 1}. Unknown step`;
+}
+function renderClaudeCodeAgent(def) {
+  const lines = ["---"];
+  lines.push(`name: ${def.name}`);
+  lines.push(`description: >`);
+  lines.push(`  ${def.description}`);
+  lines.push(`tools: ${def.tools.join(", ")}`);
+  lines.push("---");
+  lines.push("");
+  lines.push(GENERATED_HEADER_AGENT);
+  lines.push("");
+  lines.push("## Role");
+  lines.push("");
+  lines.push(def.role);
+  lines.push("");
+  lines.push("## Skills");
+  lines.push("");
+  for (const skill of def.skills) {
+    lines.push(`- ${skill}`);
+  }
+  lines.push("");
+  lines.push("## Steps");
+  lines.push("");
+  def.steps.forEach((step, i) => {
+    lines.push(formatStep(step, i));
+  });
+  lines.push("");
+  if (def.methodology) {
+    lines.push("## Methodology");
+    lines.push("");
+    lines.push(def.methodology);
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+
+// src/agent-definitions/render-gemini-cli.ts
+function formatStep2(step, index) {
+  if ("command" in step && step.command) {
+    const cmd = step.command;
+    const when = step.when ?? "always";
+    return `${index + 1}. Run \`harness ${cmd}\` (${when})`;
+  }
+  if ("skill" in step && step.skill) {
+    const skill = step.skill;
+    const when = step.when ?? "always";
+    return `${index + 1}. Execute ${skill} skill (${when})`;
+  }
+  return `${index + 1}. Unknown step`;
+}
+function renderGeminiAgent(def) {
+  const lines = ["---"];
+  lines.push(`name: ${def.name}`);
+  lines.push(`description: >`);
+  lines.push(`  ${def.description}`);
+  lines.push(`tools: ${def.tools.join(", ")}`);
+  lines.push("---");
+  lines.push("");
+  lines.push(GENERATED_HEADER_AGENT);
+  lines.push("");
+  lines.push("## Role");
+  lines.push("");
+  lines.push(def.role);
+  lines.push("");
+  lines.push("## Skills");
+  lines.push("");
+  for (const skill of def.skills) {
+    lines.push(`- ${skill}`);
+  }
+  lines.push("");
+  lines.push("## Steps");
+  lines.push("");
+  def.steps.forEach((step, i) => {
+    lines.push(formatStep2(step, i));
+  });
+  lines.push("");
+  if (def.methodology) {
+    lines.push("## Methodology");
+    lines.push("");
+    lines.push(def.methodology);
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+
+// src/commands/generate-agent-definitions.ts
+function resolveOutputDir2(platform, opts) {
+  if (opts.output) {
+    return platform === "claude-code" ? path33.join(opts.output, "claude-code") : path33.join(opts.output, "gemini-cli");
+  }
+  if (opts.global) {
+    const home = os3.homedir();
+    return platform === "claude-code" ? path33.join(home, ".claude", "agents") : path33.join(home, ".gemini", "agents");
+  }
+  return platform === "claude-code" ? path33.join("agents", "agents", "claude-code") : path33.join("agents", "agents", "gemini-cli");
+}
+function loadSkillContent(skillName) {
+  const skillsDir = resolveSkillsDir();
+  const skillMdPath = path33.join(skillsDir, skillName, "SKILL.md");
+  if (!fs21.existsSync(skillMdPath)) return null;
+  return fs21.readFileSync(skillMdPath, "utf-8");
+}
+function getRenderer(platform) {
+  return platform === "claude-code" ? renderClaudeCodeAgent : renderGeminiAgent;
+}
+function generateAgentDefinitions(opts) {
+  const personasDir = resolvePersonasDir();
+  const personaList = listPersonas(personasDir);
+  if (!personaList.ok) return [];
+  const personas = personaList.value.map((meta) => loadPersona(meta.filePath)).filter((r) => r.ok).map((r) => r.value);
+  const allSkillNames = new Set(personas.flatMap((p) => p.skills));
+  const skillContents = /* @__PURE__ */ new Map();
+  for (const skillName of allSkillNames) {
+    const content = loadSkillContent(skillName);
+    if (content) {
+      skillContents.set(skillName, content);
+    }
+  }
+  const definitions = personas.map((p) => generateAgentDefinition(p, skillContents));
+  const results = [];
+  for (const platform of opts.platforms) {
+    const outputDir = resolveOutputDir2(platform, opts);
+    const renderer = getRenderer(platform);
+    const rendered = /* @__PURE__ */ new Map();
+    for (const def of definitions) {
+      const filename = `${def.name}.md`;
+      rendered.set(filename, renderer(def));
+    }
+    const plan = computeSyncPlan(outputDir, rendered);
+    if (!opts.dryRun) {
+      applySyncPlan(outputDir, rendered, plan, false);
+    }
+    results.push({
+      platform,
+      added: plan.added,
+      updated: plan.updated,
+      removed: plan.removed,
+      unchanged: plan.unchanged,
+      outputDir
+    });
+  }
+  return results;
+}
+function createGenerateAgentDefinitionsCommand() {
+  return new Command37("generate-agent-definitions").description("Generate agent definition files from personas for Claude Code and Gemini CLI").option("--platforms <list>", "Target platforms (comma-separated)", "claude-code,gemini-cli").option("--global", "Write to global agent directories", false).option("--output <dir>", "Custom output directory").option("--dry-run", "Show what would change without writing", false).action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const platforms = opts.platforms.split(",").map((p) => p.trim());
+    for (const p of platforms) {
+      if (!VALID_PLATFORMS.includes(p)) {
+        throw new CLIError(
+          `Invalid platform "${p}". Valid platforms: ${VALID_PLATFORMS.join(", ")}`,
+          ExitCode.VALIDATION_FAILED
+        );
+      }
+    }
+    try {
+      const results = generateAgentDefinitions({
+        platforms,
+        global: opts.global,
+        output: opts.output,
+        dryRun: opts.dryRun
+      });
+      if (globalOpts.json) {
+        console.log(JSON.stringify(results, null, 2));
+        return;
+      }
+      for (const result of results) {
+        console.log(`
+${result.platform} \u2192 ${result.outputDir}`);
+        if (result.added.length > 0) {
+          console.log(`  + ${result.added.length} new: ${result.added.join(", ")}`);
+        }
+        if (result.updated.length > 0) {
+          console.log(`  ~ ${result.updated.length} updated: ${result.updated.join(", ")}`);
+        }
+        if (result.removed.length > 0) {
+          console.log(`  - ${result.removed.length} removed: ${result.removed.join(", ")}`);
+        }
+        if (result.unchanged.length > 0) {
+          console.log(`  = ${result.unchanged.length} unchanged`);
+        }
+        if (opts.dryRun) {
+          console.log("  (dry run \u2014 no files written)");
+        }
+      }
+    } catch (error) {
+      handleError(error);
+    }
+  });
+}
+
+// src/commands/generate.ts
+import { Command as Command38 } from "commander";
+function createGenerateCommand3() {
+  return new Command38("generate").description("Generate all platform integrations (slash commands + agent definitions)").option("--platforms <list>", "Target platforms (comma-separated)", "claude-code,gemini-cli").option("--global", "Write to global directories", false).option("--include-global", "Include built-in global skills", false).option("--output <dir>", "Custom output directory").option("--dry-run", "Show what would change without writing", false).option("--yes", "Skip deletion confirmation prompts", false).action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const platforms = opts.platforms.split(",").map((p) => p.trim());
+    for (const p of platforms) {
+      if (!VALID_PLATFORMS.includes(p)) {
+        throw new CLIError(
+          `Invalid platform "${p}". Valid platforms: ${VALID_PLATFORMS.join(", ")}`,
+          ExitCode.VALIDATION_FAILED
+        );
+      }
+    }
+    try {
+      console.log("Generating slash commands...");
+      const slashResults = generateSlashCommands({
+        platforms,
+        global: opts.global,
+        includeGlobal: opts.includeGlobal,
+        output: opts.output,
+        skillsDir: "",
+        dryRun: opts.dryRun,
+        yes: opts.yes
+      });
+      for (const result of slashResults) {
+        const total = result.added.length + result.updated.length + result.unchanged.length;
+        console.log(
+          `  ${result.platform}: ${total} commands (${result.added.length} new, ${result.updated.length} updated)`
+        );
+      }
+      await handleOrphanDeletion(slashResults, { yes: opts.yes, dryRun: opts.dryRun });
+      console.log("\nGenerating agent definitions...");
+      const agentResults = generateAgentDefinitions({
+        platforms,
+        global: opts.global,
+        output: opts.output,
+        dryRun: opts.dryRun
+      });
+      for (const result of agentResults) {
+        const total = result.added.length + result.updated.length + result.unchanged.length;
+        console.log(
+          `  ${result.platform}: ${total} agents (${result.added.length} new, ${result.updated.length} updated)`
+        );
+      }
+      if (opts.dryRun) {
+        console.log("\n(dry run \u2014 no files written)");
+      } else {
+        console.log("\nDone.");
+      }
+      if (globalOpts.json) {
+        console.log(
+          JSON.stringify({ slashCommands: slashResults, agentDefinitions: agentResults }, null, 2)
+        );
+      }
+    } catch (error) {
+      handleError(error);
+    }
+  });
+}
+
+// src/commands/graph/scan.ts
+import { Command as Command39 } from "commander";
+import * as path34 from "path";
+async function runScan(projectPath) {
+  const { GraphStore, CodeIngestor, TopologicalLinker, KnowledgeIngestor, GitIngestor } = await import("@harness-engineering/graph");
+  const store = new GraphStore();
+  const start = Date.now();
+  await new CodeIngestor(store).ingest(projectPath);
+  new TopologicalLinker(store).link();
+  const knowledgeIngestor = new KnowledgeIngestor(store);
+  await knowledgeIngestor.ingestAll(projectPath);
+  try {
+    await new GitIngestor(store).ingest(projectPath);
+  } catch {
+  }
+  const graphDir = path34.join(projectPath, ".harness", "graph");
+  await store.save(graphDir);
+  return { nodeCount: store.nodeCount, edgeCount: store.edgeCount, durationMs: Date.now() - start };
+}
+function createScanCommand() {
+  return new Command39("scan").description("Scan project and build knowledge graph").argument("[path]", "Project root path", ".").action(async (inputPath, _opts, cmd) => {
+    const projectPath = path34.resolve(inputPath);
+    const globalOpts = cmd.optsWithGlobals();
+    try {
+      const result = await runScan(projectPath);
+      if (globalOpts.json) {
+        console.log(JSON.stringify(result));
+      } else {
+        console.log(
+          `Graph built: ${result.nodeCount} nodes, ${result.edgeCount} edges (${result.durationMs}ms)`
+        );
+      }
+    } catch (err) {
+      console.error("Scan failed:", err instanceof Error ? err.message : err);
+      process.exit(2);
+    }
+  });
+}
+
+// src/commands/graph/ingest.ts
+import { Command as Command40 } from "commander";
+import * as path35 from "path";
+async function loadConnectorConfig(projectPath, source) {
+  try {
+    const fs22 = await import("fs/promises");
+    const configPath = path35.join(projectPath, "harness.config.json");
+    const config = JSON.parse(await fs22.readFile(configPath, "utf-8"));
+    const connector = config.graph?.connectors?.find(
+      (c) => c.source === source
+    );
+    return connector?.config ?? {};
+  } catch {
+    return {};
+  }
+}
+function mergeResults(...results) {
+  return results.reduce(
+    (acc, r) => ({
+      nodesAdded: acc.nodesAdded + r.nodesAdded,
+      nodesUpdated: acc.nodesUpdated + r.nodesUpdated,
+      edgesAdded: acc.edgesAdded + r.edgesAdded,
+      edgesUpdated: acc.edgesUpdated + r.edgesUpdated,
+      errors: [...acc.errors, ...r.errors],
+      durationMs: acc.durationMs + r.durationMs
+    }),
+    {
+      nodesAdded: 0,
+      nodesUpdated: 0,
+      edgesAdded: 0,
+      edgesUpdated: 0,
+      errors: [],
+      durationMs: 0
+    }
+  );
+}
+async function runIngest(projectPath, source, opts) {
+  const {
+    GraphStore,
+    CodeIngestor,
+    TopologicalLinker,
+    KnowledgeIngestor,
+    GitIngestor,
+    SyncManager,
+    JiraConnector,
+    SlackConnector
+  } = await import("@harness-engineering/graph");
+  const graphDir = path35.join(projectPath, ".harness", "graph");
+  const store = new GraphStore();
+  await store.load(graphDir);
+  if (opts?.all) {
+    const startMs = Date.now();
+    const codeResult = await new CodeIngestor(store).ingest(projectPath);
+    new TopologicalLinker(store).link();
+    const knowledgeResult = await new KnowledgeIngestor(store).ingestAll(projectPath);
+    const gitResult = await new GitIngestor(store).ingest(projectPath);
+    const syncManager = new SyncManager(store, graphDir);
+    const connectorMap = {
+      jira: () => new JiraConnector(),
+      slack: () => new SlackConnector()
+    };
+    for (const [name, factory] of Object.entries(connectorMap)) {
+      const config = await loadConnectorConfig(projectPath, name);
+      syncManager.registerConnector(factory(), config);
+    }
+    const connectorResult = await syncManager.syncAll();
+    await store.save(graphDir);
+    const merged = mergeResults(codeResult, knowledgeResult, gitResult, connectorResult);
+    return { ...merged, durationMs: Date.now() - startMs };
+  }
+  let result;
+  switch (source) {
+    case "code":
+      result = await new CodeIngestor(store).ingest(projectPath);
+      new TopologicalLinker(store).link();
+      break;
+    case "knowledge":
+      result = await new KnowledgeIngestor(store).ingestAll(projectPath);
+      break;
+    case "git":
+      result = await new GitIngestor(store).ingest(projectPath);
+      break;
+    default: {
+      const knownConnectors = ["jira", "slack"];
+      if (!knownConnectors.includes(source)) {
+        throw new Error(`Unknown source: ${source}. Available: code, knowledge, git, jira, slack`);
+      }
+      if (!SyncManager) {
+        throw new Error(
+          `Connector support not available. Ensure @harness-engineering/graph is built with connector support.`
+        );
+      }
+      const syncManager = new SyncManager(store, graphDir);
+      const extConnectorMap = {
+        jira: () => new JiraConnector(),
+        slack: () => new SlackConnector()
+      };
+      const factory = extConnectorMap[source];
+      const config = await loadConnectorConfig(projectPath, source);
+      syncManager.registerConnector(factory(), config);
+      result = await syncManager.sync(source);
+      break;
+    }
+  }
+  await store.save(graphDir);
+  return result;
+}
+function createIngestCommand() {
+  return new Command40("ingest").description("Ingest data into the knowledge graph").option("--source <name>", "Source to ingest (code, knowledge, git, jira, slack)").option("--all", "Run all sources (code, knowledge, git, and configured connectors)").option("--full", "Force full re-ingestion").action(async (opts, cmd) => {
+    if (!opts.source && !opts.all) {
+      console.error("Error: --source or --all is required");
+      process.exit(1);
+    }
+    const globalOpts = cmd.optsWithGlobals();
+    const projectPath = path35.resolve(globalOpts.config ? path35.dirname(globalOpts.config) : ".");
+    try {
+      const result = await runIngest(projectPath, opts.source ?? "", {
+        full: opts.full,
+        all: opts.all
+      });
+      if (globalOpts.json) {
+        console.log(JSON.stringify(result));
+      } else {
+        const label = opts.all ? "all" : opts.source;
+        console.log(
+          `Ingested (${label}): +${result.nodesAdded} nodes, +${result.edgesAdded} edges (${result.durationMs}ms)`
+        );
+      }
+    } catch (err) {
+      console.error("Ingest failed:", err instanceof Error ? err.message : err);
+      process.exit(2);
+    }
+  });
+}
+
+// src/commands/graph/query.ts
+import { Command as Command41 } from "commander";
+import * as path36 from "path";
+async function runQuery(projectPath, rootNodeId, opts) {
+  const { GraphStore, ContextQL } = await import("@harness-engineering/graph");
+  const store = new GraphStore();
+  const graphDir = path36.join(projectPath, ".harness", "graph");
+  const loaded = await store.load(graphDir);
+  if (!loaded) throw new Error("No graph found. Run `harness scan` first.");
+  const params = {
+    rootNodeIds: [rootNodeId],
+    maxDepth: opts.depth ?? 3,
+    bidirectional: opts.bidirectional ?? false,
+    ...opts.types ? { includeTypes: opts.types.split(",") } : {},
+    ...opts.edges ? { includeEdges: opts.edges.split(",") } : {}
+  };
+  const cql = new ContextQL(store);
+  return cql.execute(params);
+}
+function createQueryCommand() {
+  return new Command41("query").description("Query the knowledge graph").argument("<rootNodeId>", "Starting node ID").option("--depth <n>", "Max traversal depth", "3").option("--types <types>", "Comma-separated node types to include").option("--edges <edges>", "Comma-separated edge types to include").option("--bidirectional", "Traverse both directions").action(async (rootNodeId, opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const projectPath = path36.resolve(globalOpts.config ? path36.dirname(globalOpts.config) : ".");
+    try {
+      const result = await runQuery(projectPath, rootNodeId, {
+        depth: parseInt(opts.depth),
+        types: opts.types,
+        edges: opts.edges,
+        bidirectional: opts.bidirectional
+      });
+      if (globalOpts.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(
+          `Found ${result.nodes.length} nodes, ${result.edges.length} edges (depth ${result.stats.depthReached}, pruned ${result.stats.pruned})`
+        );
+        for (const node of result.nodes) {
+          console.log(`  ${node.type.padEnd(12)} ${node.id}`);
+        }
+      }
+    } catch (err) {
+      console.error("Query failed:", err instanceof Error ? err.message : err);
+      process.exit(2);
+    }
+  });
+}
+
+// src/commands/graph/index.ts
+import { Command as Command42 } from "commander";
+
+// src/commands/graph/status.ts
+import * as path37 from "path";
+async function runGraphStatus(projectPath) {
+  const { GraphStore } = await import("@harness-engineering/graph");
+  const graphDir = path37.join(projectPath, ".harness", "graph");
+  const store = new GraphStore();
+  const loaded = await store.load(graphDir);
+  if (!loaded) return { status: "no_graph", message: "No graph found. Run `harness scan` first." };
+  const fs22 = await import("fs/promises");
+  const metaPath = path37.join(graphDir, "metadata.json");
+  let lastScan = "unknown";
+  try {
+    const meta = JSON.parse(await fs22.readFile(metaPath, "utf-8"));
+    lastScan = meta.lastScanTimestamp;
+  } catch {
+  }
+  const allNodes = store.findNodes({});
+  const nodesByType = {};
+  for (const node of allNodes) {
+    nodesByType[node.type] = (nodesByType[node.type] ?? 0) + 1;
+  }
+  let connectorSyncStatus = {};
+  try {
+    const syncMetaPath = path37.join(graphDir, "sync-metadata.json");
+    const syncMeta = JSON.parse(await fs22.readFile(syncMetaPath, "utf-8"));
+    for (const [name, data] of Object.entries(syncMeta.connectors ?? {})) {
+      connectorSyncStatus[name] = data.lastSyncTimestamp;
+    }
+  } catch {
+  }
+  return {
+    status: "ok",
+    nodeCount: store.nodeCount,
+    edgeCount: store.edgeCount,
+    nodesByType,
+    lastScanTimestamp: lastScan,
+    ...Object.keys(connectorSyncStatus).length > 0 ? { connectorSyncStatus } : {}
+  };
+}
+
+// src/commands/graph/export.ts
+import * as path38 from "path";
+async function runGraphExport(projectPath, format) {
+  const { GraphStore } = await import("@harness-engineering/graph");
+  const graphDir = path38.join(projectPath, ".harness", "graph");
+  const store = new GraphStore();
+  const loaded = await store.load(graphDir);
+  if (!loaded) throw new Error("No graph found. Run `harness scan` first.");
+  if (format === "json") {
+    const nodes = store.findNodes({});
+    const edges = store.getEdges({});
+    return JSON.stringify({ nodes, edges }, null, 2);
+  }
+  if (format === "mermaid") {
+    const nodes = store.findNodes({});
+    const edges = store.getEdges({});
+    const lines = ["graph TD"];
+    for (const node of nodes.slice(0, 200)) {
+      const safeId = node.id.replace(/[^a-zA-Z0-9]/g, "_");
+      const safeName = node.name.replace(/"/g, "#quot;");
+      lines.push(`  ${safeId}["${safeName}"]`);
+    }
+    for (const edge of edges.slice(0, 500)) {
+      const safeFrom = edge.from.replace(/[^a-zA-Z0-9]/g, "_");
+      const safeTo = edge.to.replace(/[^a-zA-Z0-9]/g, "_");
+      lines.push(`  ${safeFrom} -->|${edge.type}| ${safeTo}`);
+    }
+    return lines.join("\n");
+  }
+  throw new Error(`Unknown format: ${format}. Available: json, mermaid`);
+}
+
+// src/commands/graph/index.ts
+import * as path39 from "path";
+function createGraphCommand() {
+  const graph = new Command42("graph").description("Knowledge graph management");
+  graph.command("status").description("Show graph statistics").action(async (_opts, cmd) => {
+    try {
+      const globalOpts = cmd.optsWithGlobals();
+      const projectPath = path39.resolve(globalOpts.config ? path39.dirname(globalOpts.config) : ".");
+      const result = await runGraphStatus(projectPath);
+      if (globalOpts.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else if (result.status === "no_graph") {
+        console.log(result.message);
+      } else {
+        console.log(`Graph: ${result.nodeCount} nodes, ${result.edgeCount} edges`);
+        console.log(`Last scan: ${result.lastScanTimestamp}`);
+        console.log("Nodes by type:");
+        for (const [type, count] of Object.entries(result.nodesByType)) {
+          console.log(`  ${type}: ${count}`);
+        }
+        if (result.connectorSyncStatus) {
+          console.log("Connector sync status:");
+          for (const [name, timestamp] of Object.entries(result.connectorSyncStatus)) {
+            console.log(`  ${name}: last synced ${timestamp}`);
+          }
+        }
+      }
+    } catch (err) {
+      console.error("Status failed:", err instanceof Error ? err.message : err);
+      process.exit(2);
+    }
+  });
+  graph.command("export").description("Export graph").requiredOption("--format <format>", "Output format (json, mermaid)").action(async (opts, cmd) => {
+    const globalOpts = cmd.optsWithGlobals();
+    const projectPath = path39.resolve(globalOpts.config ? path39.dirname(globalOpts.config) : ".");
+    try {
+      const output = await runGraphExport(projectPath, opts.format);
+      console.log(output);
+    } catch (err) {
+      console.error("Export failed:", err instanceof Error ? err.message : err);
+      process.exit(2);
+    }
+  });
+  return graph;
+}
+
 // src/index.ts
 function createProgram() {
-  const program = new Command33();
+  const program = new Command43();
   program.name("harness").description("CLI for Harness Engineering toolkit").version(VERSION).option("-c, --config <path>", "Path to config file").option("--json", "Output as JSON").option("--verbose", "Verbose output").option("--quiet", "Minimal output");
   program.addCommand(createValidateCommand());
   program.addCommand(createCheckDepsCommand());
   program.addCommand(createCheckDocsCommand());
+  program.addCommand(createCheckPerfCommand());
+  program.addCommand(createCheckSecurityCommand());
+  program.addCommand(createPerfCommand());
   program.addCommand(createInitCommand());
   program.addCommand(createCleanupCommand());
   program.addCommand(createFixDriftCommand());
@@ -3511,8 +5007,14 @@ function createProgram() {
   program.addCommand(createCreateSkillCommand());
   program.addCommand(createSetupMcpCommand());
   program.addCommand(createGenerateSlashCommandsCommand());
+  program.addCommand(createGenerateAgentDefinitionsCommand());
+  program.addCommand(createGenerateCommand3());
   program.addCommand(createCICommand());
   program.addCommand(createUpdateCommand());
+  program.addCommand(createScanCommand());
+  program.addCommand(createIngestCommand());
+  program.addCommand(createQueryCommand());
+  program.addCommand(createGraphCommand());
   return program;
 }
 
@@ -3525,12 +5027,25 @@ export {
   TemplateEngine,
   loadPersona,
   listPersonas,
+  detectTrigger,
   runPersona,
+  executeSkill,
+  ALLOWED_PERSONA_COMMANDS,
   generateRuntime,
   generateAgentsMd,
   generateCIWorkflow,
   buildPreamble,
   runCheckPhaseGate,
   generateSlashCommands,
+  AGENT_DESCRIPTIONS,
+  generateAgentDefinition,
+  renderClaudeCodeAgent,
+  renderGeminiAgent,
+  generateAgentDefinitions,
+  runScan,
+  runIngest,
+  runQuery,
+  runGraphStatus,
+  runGraphExport,
   createProgram
 };