@harness-engineering/cli 1.9.0 → 1.10.0

package/dist/agents/skills/claude-code/harness-autopilot/SKILL.md

@@ -339,7 +339,9 @@ INIT → ASSESS → PLAN → APPROVE_PLAN → EXECUTE → VERIFY → REVIEW →
 
 3. **Mark phase as `complete`** in state.
 
-4. **Check for next phase:**
+4. **Sync roadmap.** If `docs/roadmap.md` exists, call `manage_roadmap` with action `sync` and `apply: true`. This reflects the just-completed phase in the roadmap (e.g., updating the feature from `planned` to `in-progress`). If `manage_roadmap` is unavailable, fall back to direct file manipulation using `syncRoadmap()` from core. Skip silently if no roadmap exists. Do not use `force_sync: true` — the human-always-wins rule applies.
+
+5. **Check for next phase:**
    - If more phases remain: "Phase {N} complete. Next: Phase {N+1}: {name} (complexity: {level}). Continue? (yes / stop)"
      - **yes** — Increment `currentPhase`, reset `retryBudget`, transition to ASSESS.
      - **stop** — Save state and exit.
@@ -383,7 +385,9 @@ INIT → ASSESS → PLAN → APPROVE_PLAN → EXECUTE → VERIFY → REVIEW →
    - [skill:harness-autopilot] [outcome:observation] {any notable patterns from the run}
    ```
 
-5. **Clean up state:** Set `currentState: "DONE"` in `{sessionDir}/autopilot-state.json`. Do not delete the file — it serves as a record.
+5. **Update roadmap to done.** If `docs/roadmap.md` exists and the current spec maps to a roadmap feature, call `manage_roadmap` with action `update` to set the feature status to `done`. Derive the feature name from the spec title (H1 heading) or the session's `handoff.json` `summary` field. If `manage_roadmap` is unavailable, fall back to direct file manipulation using `updateFeature()` from core. Skip silently if no roadmap exists or if the feature is not found. Do not use `force_sync: true`.
+
+6. **Clean up state:** Set `currentState: "DONE"` in `{sessionDir}/autopilot-state.json`. Do not delete the file — it serves as a record.
 
 ## Harness Integration
 
@@ -394,6 +398,7 @@ INIT → ASSESS → PLAN → APPROVE_PLAN → EXECUTE → VERIFY → REVIEW →
 - **Handoff** — `.harness/sessions/<slug>/handoff.json` is written by each delegated skill and read by the next. Autopilot writes a final handoff on DONE.
 - **Learnings** — `.harness/learnings.md` (global) is appended by both delegated skills and autopilot itself.
 - **Roadmap context** — During INIT, reads `docs/roadmap.md` (if present) for project-level priorities, blockers, and milestone status. Provides broader context for phase execution decisions.
+- **Roadmap sync** — During PHASE_COMPLETE, calls `manage_roadmap` with `sync` and `apply: true` to reflect phase progress. During DONE, calls `manage_roadmap` with `update` to set feature status to `done`. Both skip silently when no roadmap exists. Neither uses `force_sync: true`.
 
 ## Success Criteria
 

package/dist/agents/skills/claude-code/harness-brainstorming/SKILL.md

@@ -156,7 +156,15 @@ These keywords flow into the `handoff.json` `contextKeywords` field when the spe
 
    The human must explicitly approve before this skill is complete.
 
-6. **Write handoff and suggest transition.** After the human approves the spec:
+6. **Add feature to roadmap.** If `docs/roadmap.md` exists:
+   - Derive the feature name from the spec title (the H1 heading of the proposal).
+   - Call `manage_roadmap` with action `add`, `status: "planned"`, `milestone: "Current Work"`, and the spec path. Include a one-line summary from the spec overview.
+   - If the feature already exists in the roadmap (duplicate name), skip silently — the feature was likely added manually or by a prior brainstorming session.
+   - Log: `"Added '<feature-name>' to roadmap as planned"` (informational, not a prompt).
+   - If `manage_roadmap` is unavailable, fall back to direct file manipulation using `addFeature()` from core.
+   - If no roadmap exists, skip this step silently.
+
+7. **Write handoff and suggest transition.** After the human approves the spec:
 
    Write `.harness/handoff.json`:
 
@@ -257,6 +265,7 @@ Converge on a recommendation that addresses all concerns before presenting the d
 - **`harness check-docs`** — Run to verify the spec does not conflict with existing documentation.
 - **Spec location** — Specs go to `docs/changes/<feature>/proposal.md`. Follow existing naming patterns.
 - **Handoff to harness-planning** — Once the spec is approved, invoke harness-planning to create the implementation plan from the spec.
+- **Roadmap sync** — After spec approval, call `manage_roadmap` with action `add` to register the new feature as `planned` in `docs/roadmap.md`. Skip silently if no roadmap exists. Duplicates are silently ignored.
 - **`emit_interaction`** -- Call at the end of Phase 4 to suggest transitioning to harness-planning. Uses confirmed transition (waits for user approval).
 
 #### Requirement Phrasing

package/dist/agents/skills/claude-code/harness-execution/SKILL.md

@@ -266,7 +266,7 @@ Skipping this step means subsequent graph queries (impact analysis, dependency h
    }
    ```
 
-5. **Sync roadmap (if present).** If `docs/roadmap.md` exists, trigger a roadmap sync to update linked feature statuses based on the just-completed execution state. Use the `manage_roadmap` MCP tool with `sync` action if available, or invoke `/harness:roadmap --sync`. This keeps the roadmap current as plans are executed. If no roadmap exists, skip this step silently.
+5. **Sync roadmap (mandatory when present).** If `docs/roadmap.md` exists, call `manage_roadmap` with action `sync` and `apply: true` to update linked feature statuses from the just-completed execution state. Do not use `force_sync: true` — the human-always-wins rule applies. If `manage_roadmap` is unavailable, fall back to direct file manipulation using `syncRoadmap()` from core. If no roadmap exists, skip silently.
 
 6. **Learnings are append-only.** Never edit or delete previous learnings. They are a chronological record.
 
@@ -327,7 +327,7 @@ These are non-negotiable. When any condition is met, stop immediately.
 - **`harness state learn "<message>"`** — Append a learning from the command line.
 - **`.harness/state.json`** — Read at session start to resume position. Updated after every task.
 - **`.harness/learnings.md`** — Append-only knowledge capture. Read at session start for prior context.
-- **Roadmap sync** — After completing plan execution, sync roadmap status via `manage_roadmap sync` if `docs/roadmap.md` exists. Keeps roadmap current with execution progress.
+- **Roadmap sync** — After completing plan execution, call `manage_roadmap` with action `sync` and `apply: true` to update roadmap status. Mandatory when `docs/roadmap.md` exists. Do not use `force_sync: true`. Falls back to `syncRoadmap()` from core if MCP tool is unavailable.
 - **`emit_interaction`** -- Call at plan completion to auto-transition to harness-verification. Uses auto-transition (proceeds immediately without user confirmation).
 
 ## Success Criteria

package/dist/agents/skills/gemini-cli/harness-autopilot/SKILL.md

@@ -339,7 +339,9 @@ INIT → ASSESS → PLAN → APPROVE_PLAN → EXECUTE → VERIFY → REVIEW →
 
 3. **Mark phase as `complete`** in state.
 
-4. **Check for next phase:**
+4. **Sync roadmap.** If `docs/roadmap.md` exists, call `manage_roadmap` with action `sync` and `apply: true`. This reflects the just-completed phase in the roadmap (e.g., updating the feature from `planned` to `in-progress`). If `manage_roadmap` is unavailable, fall back to direct file manipulation using `syncRoadmap()` from core. Skip silently if no roadmap exists. Do not use `force_sync: true` — the human-always-wins rule applies.
+
+5. **Check for next phase:**
    - If more phases remain: "Phase {N} complete. Next: Phase {N+1}: {name} (complexity: {level}). Continue? (yes / stop)"
      - **yes** — Increment `currentPhase`, reset `retryBudget`, transition to ASSESS.
      - **stop** — Save state and exit.
@@ -383,7 +385,9 @@ INIT → ASSESS → PLAN → APPROVE_PLAN → EXECUTE → VERIFY → REVIEW →
    - [skill:harness-autopilot] [outcome:observation] {any notable patterns from the run}
    ```
 
-5. **Clean up state:** Set `currentState: "DONE"` in `{sessionDir}/autopilot-state.json`. Do not delete the file — it serves as a record.
+5. **Update roadmap to done.** If `docs/roadmap.md` exists and the current spec maps to a roadmap feature, call `manage_roadmap` with action `update` to set the feature status to `done`. Derive the feature name from the spec title (H1 heading) or the session's `handoff.json` `summary` field. If `manage_roadmap` is unavailable, fall back to direct file manipulation using `updateFeature()` from core. Skip silently if no roadmap exists or if the feature is not found. Do not use `force_sync: true`.
+
+6. **Clean up state:** Set `currentState: "DONE"` in `{sessionDir}/autopilot-state.json`. Do not delete the file — it serves as a record.
 
 ## Harness Integration
 
@@ -394,6 +398,7 @@ INIT → ASSESS → PLAN → APPROVE_PLAN → EXECUTE → VERIFY → REVIEW →
 - **Handoff** — `.harness/sessions/<slug>/handoff.json` is written by each delegated skill and read by the next. Autopilot writes a final handoff on DONE.
 - **Learnings** — `.harness/learnings.md` (global) is appended by both delegated skills and autopilot itself.
 - **Roadmap context** — During INIT, reads `docs/roadmap.md` (if present) for project-level priorities, blockers, and milestone status. Provides broader context for phase execution decisions.
+- **Roadmap sync** — During PHASE_COMPLETE, calls `manage_roadmap` with `sync` and `apply: true` to reflect phase progress. During DONE, calls `manage_roadmap` with `update` to set feature status to `done`. Both skip silently when no roadmap exists. Neither uses `force_sync: true`.
 
 ## Success Criteria
 

package/dist/agents/skills/gemini-cli/harness-brainstorming/SKILL.md

@@ -156,7 +156,15 @@ These keywords flow into the `handoff.json` `contextKeywords` field when the spe
 
    The human must explicitly approve before this skill is complete.
 
-6. **Write handoff and suggest transition.** After the human approves the spec:
+6. **Add feature to roadmap.** If `docs/roadmap.md` exists:
+   - Derive the feature name from the spec title (the H1 heading of the proposal).
+   - Call `manage_roadmap` with action `add`, `status: "planned"`, `milestone: "Current Work"`, and the spec path. Include a one-line summary from the spec overview.
+   - If the feature already exists in the roadmap (duplicate name), skip silently — the feature was likely added manually or by a prior brainstorming session.
+   - Log: `"Added '<feature-name>' to roadmap as planned"` (informational, not a prompt).
+   - If `manage_roadmap` is unavailable, fall back to direct file manipulation using `addFeature()` from core.
+   - If no roadmap exists, skip this step silently.
+
+7. **Write handoff and suggest transition.** After the human approves the spec:
 
    Write `.harness/handoff.json`:
 
@@ -257,6 +265,7 @@ Converge on a recommendation that addresses all concerns before presenting the d
 - **`harness check-docs`** — Run to verify the spec does not conflict with existing documentation.
 - **Spec location** — Specs go to `docs/changes/<feature>/proposal.md`. Follow existing naming patterns.
 - **Handoff to harness-planning** — Once the spec is approved, invoke harness-planning to create the implementation plan from the spec.
+- **Roadmap sync** — After spec approval, call `manage_roadmap` with action `add` to register the new feature as `planned` in `docs/roadmap.md`. Skip silently if no roadmap exists. Duplicates are silently ignored.
 - **`emit_interaction`** -- Call at the end of Phase 4 to suggest transitioning to harness-planning. Uses confirmed transition (waits for user approval).
 
 #### Requirement Phrasing

package/dist/agents/skills/gemini-cli/harness-execution/SKILL.md

@@ -266,7 +266,7 @@ Skipping this step means subsequent graph queries (impact analysis, dependency h
    }
    ```
 
-5. **Sync roadmap (if present).** If `docs/roadmap.md` exists, trigger a roadmap sync to update linked feature statuses based on the just-completed execution state. Use the `manage_roadmap` MCP tool with `sync` action if available, or invoke `/harness:roadmap --sync`. This keeps the roadmap current as plans are executed. If no roadmap exists, skip this step silently.
+5. **Sync roadmap (mandatory when present).** If `docs/roadmap.md` exists, call `manage_roadmap` with action `sync` and `apply: true` to update linked feature statuses from the just-completed execution state. Do not use `force_sync: true` — the human-always-wins rule applies. If `manage_roadmap` is unavailable, fall back to direct file manipulation using `syncRoadmap()` from core. If no roadmap exists, skip silently.
 
 6. **Learnings are append-only.** Never edit or delete previous learnings. They are a chronological record.
 
@@ -327,7 +327,7 @@ These are non-negotiable. When any condition is met, stop immediately.
 - **`harness state learn "<message>"`** — Append a learning from the command line.
 - **`.harness/state.json`** — Read at session start to resume position. Updated after every task.
 - **`.harness/learnings.md`** — Append-only knowledge capture. Read at session start for prior context.
-- **Roadmap sync** — After completing plan execution, sync roadmap status via `manage_roadmap sync` if `docs/roadmap.md` exists. Keeps roadmap current with execution progress.
+- **Roadmap sync** — After completing plan execution, call `manage_roadmap` with action `sync` and `apply: true` to update roadmap status. Mandatory when `docs/roadmap.md` exists. Do not use `force_sync: true`. Falls back to `syncRoadmap()` from core if MCP tool is unavailable.
 - **`emit_interaction`** -- Call at plan completion to auto-transition to harness-verification. Uses auto-transition (proceeds immediately without user confirmation).
 
 ## Success Criteria

package/dist/agents-md-EMRFLNBC.js

@@ -0,0 +1,8 @@
+import {
+  generateAgentsMd
+} from "./chunk-NKDM3FMH.js";
+import "./chunk-NX6DSZSM.js";
+import "./chunk-MHBMTPW7.js";
+export {
+  generateAgentsMd
+};

package/dist/architecture-5JNN5L3M.js

@@ -0,0 +1,13 @@
+import {
+  checkDependenciesDefinition,
+  handleCheckDependencies
+} from "./chunk-MO4YQOMB.js";
+import "./chunk-K6XAPGML.js";
+import "./chunk-IDZNPTYD.js";
+import "./chunk-W6Y7ZW3Y.js";
+import "./chunk-NX6DSZSM.js";
+import "./chunk-MHBMTPW7.js";
+export {
+  checkDependenciesDefinition,
+  handleCheckDependencies
+};

package/dist/bin/harness-mcp.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin/harness-mcp.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import {
+  startServer
+} from "../chunk-LXU5M77O.js";
+import "../chunk-CWZ4Y2PO.js";
+import "../chunk-FPIPT36X.js";
+import "../chunk-4PFMY3H7.js";
+import "../chunk-PSXF277V.js";
+import "../chunk-PMTFPOCT.js";
+import "../chunk-ZOAWBDWU.js";
+import "../chunk-FX7SQHGD.js";
+import "../chunk-OPXH4CQN.js";
+import "../chunk-MO4YQOMB.js";
+import "../chunk-K6XAPGML.js";
+import "../chunk-F4PTVZWA.js";
+import "../chunk-IDZNPTYD.js";
+import "../chunk-W6Y7ZW3Y.js";
+import "../chunk-EOLRW32Q.js";
+import "../chunk-B7HFEHWP.js";
+import "../chunk-MDUK2J2O.js";
+import "../chunk-NX6DSZSM.js";
+import "../chunk-MHBMTPW7.js";
+
+// src/bin/harness-mcp.ts
+startServer().catch((error) => {
+  console.error("Failed to start MCP server:", error);
+  process.exit(1);
+});

package/dist/bin/harness.js

@@ -1,21 +1,55 @@
 #!/usr/bin/env node
 import {
-  CLI_VERSION,
-  createProgram,
+  createProgram
+} from "../chunk-PAHHT2IK.js";
+import "../chunk-VUCPTQ6G.js";
+import {
   findConfigFile,
   loadConfig
-} from "../chunk-RTPHUDZS.js";
-import "../chunk-6JIT7CEM.js";
+} from "../chunk-7X7ZAYMY.js";
+import "../chunk-46YA6FI3.js";
+import "../chunk-Q6AB7W5Z.js";
+import "../chunk-TRAPF4IX.js";
+import "../chunk-F3YDAJFQ.js";
+import "../chunk-TEFCFC4H.js";
+import "../chunk-ECUJQS3B.js";
+import "../chunk-HIOXKZYF.js";
+import "../chunk-QPEH2QPG.js";
+import "../chunk-JSTQ3AWB.js";
+import "../chunk-KET4QQZB.js";
+import "../chunk-NKDM3FMH.js";
+import "../chunk-LXU5M77O.js";
+import "../chunk-CWZ4Y2PO.js";
+import "../chunk-FPIPT36X.js";
+import "../chunk-4PFMY3H7.js";
+import "../chunk-PSXF277V.js";
+import "../chunk-PMTFPOCT.js";
+import "../chunk-ZOAWBDWU.js";
+import "../chunk-FX7SQHGD.js";
+import "../chunk-OPXH4CQN.js";
+import "../chunk-MO4YQOMB.js";
+import "../chunk-K6XAPGML.js";
+import "../chunk-F4PTVZWA.js";
+import "../chunk-IDZNPTYD.js";
+import "../chunk-W6Y7ZW3Y.js";
+import "../chunk-EOLRW32Q.js";
+import {
+  handleError
+} from "../chunk-B7HFEHWP.js";
+import "../chunk-MDUK2J2O.js";
+import {
+  CLI_VERSION
+} from "../chunk-BM3PWGXQ.js";
+import "../chunk-72GHBOL2.js";
+import "../chunk-C2ERUR3L.js";
 import {
   getUpdateNotification,
   isUpdateCheckEnabled,
   readCheckState,
   shouldRunCheck,
   spawnBackgroundCheck
-} from "../chunk-CGSHUJES.js";
-import {
-  handleError
-} from "../chunk-ULSRSP53.js";
+} from "../chunk-NX6DSZSM.js";
+import "../chunk-MHBMTPW7.js";
 
 // src/bin/update-check-hooks.ts
 var DEFAULT_INTERVAL_MS = 864e5;

package/dist/check-phase-gate-WOKIYGAM.js

@@ -0,0 +1,12 @@
+import {
+  createCheckPhaseGateCommand,
+  runCheckPhaseGate
+} from "./chunk-7X7ZAYMY.js";
+import "./chunk-HIOXKZYF.js";
+import "./chunk-B7HFEHWP.js";
+import "./chunk-NX6DSZSM.js";
+import "./chunk-MHBMTPW7.js";
+export {
+  createCheckPhaseGateCommand,
+  runCheckPhaseGate
+};

package/dist/chunk-46YA6FI3.js

@@ -0,0 +1,293 @@
+import {
+  listPersonas,
+  loadPersona
+} from "./chunk-Q6AB7W5Z.js";
+import {
+  toKebabCase
+} from "./chunk-KET4QQZB.js";
+import {
+  GENERATED_HEADER_AGENT,
+  VALID_PLATFORMS,
+  applySyncPlan,
+  computeSyncPlan
+} from "./chunk-ZOAWBDWU.js";
+import {
+  resolvePersonasDir,
+  resolveSkillsDir
+} from "./chunk-EOLRW32Q.js";
+import {
+  CLIError,
+  ExitCode,
+  handleError
+} from "./chunk-B7HFEHWP.js";
+
+// src/commands/generate-agent-definitions.ts
+import { Command } from "commander";
+import * as fs from "fs";
+import * as path from "path";
+import * as os 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.",
+  planner: "Create detailed implementation plans from specs with task breakdown, dependency ordering, and checkpoint placement. Use when planning a phase, breaking a spec into tasks, or creating an execution plan.",
+  verifier: "Verify implementation completeness against spec and plan at three tiers (EXISTS, SUBSTANTIVE, WIRED). Use when checking if built code matches what was planned, validating phase completion, or auditing implementation quality."
+};
+var DEFAULT_TOOLS = ["Bash", "Read", "Write", "Edit", "Glob", "Grep"];
+var GEMINI_TOOL_MAP = {
+  Bash: "run_shell_command",
+  Read: "read_file",
+  Write: "write_file",
+  Edit: "replace",
+  Glob: "glob",
+  Grep: "search_file_content"
+};
+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 toGeminiToolName(tool) {
+  return GEMINI_TOOL_MAP[tool] ?? tool;
+}
+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}`);
+  if (def.tools.length > 0) {
+    lines.push("tools:");
+    for (const tool of def.tools) {
+      lines.push(`  - ${toGeminiToolName(tool)}`);
+    }
+  }
+  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 resolveOutputDir(platform, opts) {
+  if (opts.output) {
+    return platform === "claude-code" ? path.join(opts.output, "claude-code") : path.join(opts.output, "gemini-cli");
+  }
+  if (opts.global) {
+    const home = os.homedir();
+    return platform === "claude-code" ? path.join(home, ".claude", "agents") : path.join(home, ".gemini", "agents");
+  }
+  return platform === "claude-code" ? path.join("agents", "agents", "claude-code") : path.join("agents", "agents", "gemini-cli");
+}
+function loadSkillContent(skillName) {
+  const skillsDir = resolveSkillsDir();
+  const skillMdPath = path.join(skillsDir, skillName, "SKILL.md");
+  if (!fs.existsSync(skillMdPath)) return null;
+  return fs.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 = resolveOutputDir(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 Command("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);
+    }
+  });
+}
+
+export {
+  AGENT_DESCRIPTIONS,
+  DEFAULT_TOOLS,
+  GEMINI_TOOL_MAP,
+  generateAgentDefinition,
+  renderClaudeCodeAgent,
+  renderGeminiAgent,
+  generateAgentDefinitions,
+  createGenerateAgentDefinitionsCommand
+};