@swarmcraftai/cli 0.5.0 → 0.6.0

package/dist/main.cjs

@@ -65,7 +65,9 @@ var require_assistantActions = __commonJS({
         copilotSkillPath: ".github/skills/swarmcraft-plan/SKILL.md",
         copilotInvocation: "/plan",
         codexSkillPath: ".agents/skills/swarmcraft-plan/SKILL.md",
-        codexInvocation: "$swarmcraft-plan"
+        codexInvocation: "$swarmcraft-plan",
+        claudeSkillPath: ".claude/skills/swarmcraft-plan/SKILL.md",
+        claudeInvocation: "/swarmcraft-plan"
       },
       {
         key: "do",
@@ -78,7 +80,9 @@ var require_assistantActions = __commonJS({
         copilotSkillPath: ".github/skills/swarmcraft-do/SKILL.md",
         copilotInvocation: "/do task=<packet-path>",
         codexSkillPath: ".agents/skills/swarmcraft-do/SKILL.md",
-        codexInvocation: "$swarmcraft-do task=<packet-path>"
+        codexInvocation: "$swarmcraft-do task=<packet-path>",
+        claudeSkillPath: ".claude/skills/swarmcraft-do/SKILL.md",
+        claudeInvocation: "/swarmcraft-do task=<packet-path>"
       },
       {
         key: "check",
@@ -91,7 +95,9 @@ var require_assistantActions = __commonJS({
         copilotSkillPath: ".github/skills/swarmcraft-check/SKILL.md",
         copilotInvocation: "/check task=<packet-path>",
         codexSkillPath: ".agents/skills/swarmcraft-check/SKILL.md",
-        codexInvocation: "$swarmcraft-check task=<packet-path>"
+        codexInvocation: "$swarmcraft-check task=<packet-path>",
+        claudeSkillPath: ".claude/skills/swarmcraft-check/SKILL.md",
+        claudeInvocation: "/swarmcraft-check task=<packet-path>"
       },
       {
         key: "review",
@@ -104,7 +110,9 @@ var require_assistantActions = __commonJS({
         copilotSkillPath: ".github/skills/swarmcraft-review/SKILL.md",
         copilotInvocation: "/review task=<packet-path>",
         codexSkillPath: ".agents/skills/swarmcraft-review/SKILL.md",
-        codexInvocation: "$swarmcraft-review task=<packet-path>"
+        codexInvocation: "$swarmcraft-review task=<packet-path>",
+        claudeSkillPath: ".claude/skills/swarmcraft-review/SKILL.md",
+        claudeInvocation: "/swarmcraft-review task=<packet-path>"
       },
       {
         key: "test",
@@ -116,7 +124,9 @@ var require_assistantActions = __commonJS({
         copilotSkillPath: ".github/skills/swarmcraft-test/SKILL.md",
         copilotInvocation: "/test",
         codexSkillPath: ".agents/skills/swarmcraft-test/SKILL.md",
-        codexInvocation: "$swarmcraft-test"
+        codexInvocation: "$swarmcraft-test",
+        claudeSkillPath: ".claude/skills/swarmcraft-test/SKILL.md",
+        claudeInvocation: "/swarmcraft-test"
       }
     ];
     function getSwarmCraftAssistantAction(actionKey) {
@@ -130,6 +140,14 @@ var require_assistantActions = __commonJS({
       return exports2.SWARMCRAFT_ASSISTANT_ACTIONS.filter((action) => action.kind === "stage");
     }
     function renderAssistantActionAdapterMetadata(provider, action) {
+      if (provider === "claude")
+        return {
+          provider,
+          action: action.key,
+          relativePath: action.claudeSkillPath,
+          invocation: action.claudeInvocation,
+          skillPath: action.claudeSkillPath
+        };
       if (provider === "copilot") {
         return {
           provider,
@@ -148,7 +166,7 @@ var require_assistantActions = __commonJS({
         skillPath: action.codexSkillPath
       };
     }
-    function listAssistantActionAdapterMetadata(expectedProviders = ["copilot", "codex"], expectedActions = exports2.SWARMCRAFT_ASSISTANT_ACTIONS) {
+    function listAssistantActionAdapterMetadata(expectedProviders = ["copilot", "codex", "claude"], expectedActions = exports2.SWARMCRAFT_ASSISTANT_ACTIONS) {
       return expectedProviders.flatMap((provider) => expectedActions.map((action) => renderAssistantActionAdapterMetadata(provider, action)));
     }
     function findMissingAssistantActionAdapters(expectedProviders, adapters, expectedActions = exports2.SWARMCRAFT_ASSISTANT_ACTIONS) {
@@ -178,9 +196,14 @@ var require_agentProviders = __commonJS({
     exports2.applyExternalAgentProviderDefault = applyExternalAgentProviderDefault;
     exports2.resolveExternalAgentSandboxMode = resolveExternalAgentSandboxMode2;
     exports2.resolveExternalAgentApprovalPosture = resolveExternalAgentApprovalPosture2;
-    exports2.EXTERNAL_AGENT_PROVIDERS = ["codex", "copilot", "custom"];
+    exports2.EXTERNAL_AGENT_PROVIDERS = ["codex", "copilot", "claude", "custom"];
     exports2.DEFAULT_EXTERNAL_AGENT_PROVIDER = "custom";
     exports2.EXTERNAL_AGENT_PROVIDER_DEFAULTS = {
+      claude: {
+        command: "claude --permission-mode dontAsk -p {command}",
+        sandboxMode: "claude-config",
+        approvalPosture: "dontAsk,configured-tools-only"
+      },
       codex: {
         command: "codex exec --sandbox workspace-write {command}",
         sandboxMode: "workspace-write",
@@ -196,7 +219,7 @@ var require_agentProviders = __commonJS({
       if (exports2.EXTERNAL_AGENT_PROVIDERS.includes(rawValue)) {
         return rawValue;
       }
-      throw new Error("--agent-provider must be codex, copilot, or custom.");
+      throw new Error("--agent-provider must be codex, copilot, claude, or custom.");
     }
     function resolveExternalAgentProviderDefault3(provider) {
       return exports2.EXTERNAL_AGENT_PROVIDER_DEFAULTS[provider] ?? null;
@@ -223,6 +246,8 @@ var require_agentProviders = __commonJS({
         const match = parsedArgs.agentCommand?.match(/--sandbox\s+([^\s]+)/);
         return match ? match[1] : "codex-config";
       }
+      if (parsedArgs.agentProvider === "claude")
+        return "claude-config";
       if (parsedArgs.agentProvider === "copilot") {
         return "local-cli-default";
       }
@@ -240,6 +265,8 @@ var require_agentProviders = __commonJS({
       if (parsedArgs.agentProvider === "codex") {
         return command.includes("--dangerously-bypass-approvals-and-sandbox") ? "bypass-approvals-and-sandbox" : "codex-config";
       }
+      if (parsedArgs.agentProvider === "claude")
+        return "claude-config";
       if (parsedArgs.agentProvider === "copilot") {
         return command.includes("--allow-all") || command.includes("--yolo") ? "allow-all" : "copilot-config";
       }
@@ -1051,9 +1078,11 @@ var require_stageCommands = __commonJS({
     exports2.buildPacketStageCommand = buildPacketStageCommand2;
     exports2.buildAssistantActionCommand = buildAssistantActionCommand;
     exports2.formatTaskArgument = formatTaskArgument;
+    exports2.buildSkillInvocation = buildSkillInvocation;
+    exports2.getProviderSkillRoot = getProviderSkillRoot;
     var assistantActions_js_1 = require_assistantActions();
     var workflowContract_js_1 = require_workflowContract();
-    exports2.SWARMCRAFT_AGENT_PROVIDERS = ["copilot", "codex"];
+    exports2.SWARMCRAFT_AGENT_PROVIDERS = ["copilot", "codex", "claude"];
     exports2.DEFAULT_SWARMCRAFT_AGENT_PROVIDER = "copilot";
     var COMMAND_BY_WORKFLOW_STATE = Object.fromEntries(workflowContract_js_1.SWARMCRAFT_STAGE_CONTRACTS.map((stage) => [
       stage.key,
@@ -1076,7 +1105,7 @@ var require_stageCommands = __commonJS({
     function buildAssistantActionCommand(input) {
       const action = (0, assistantActions_js_1.getSwarmCraftAssistantAction)(input.actionKey);
       const agentProvider = input.agentProvider ?? exports2.DEFAULT_SWARMCRAFT_AGENT_PROVIDER;
-      const invocation = agentProvider === "codex" ? action.codexInvocation : action.copilotInvocation;
+      const invocation = { codex: action.codexInvocation, copilot: action.copilotInvocation, claude: action.claudeInvocation }[agentProvider];
       const command = input.relativePacketFilePath ? invocation.replace("<packet-path>", formatTaskArgument(input.relativePacketFilePath)) : invocation;
       const args = [];
       if (input.relativePacketFilePath && command === invocation) {
@@ -1097,6 +1126,12 @@ var require_stageCommands = __commonJS({
     function toStageName(command) {
       return command.slice(1);
     }
+    function buildSkillInvocation(provider, action) {
+      return { copilot: `/${action}`, codex: `$swarmcraft-${action}`, claude: `/swarmcraft-${action}` }[provider];
+    }
+    function getProviderSkillRoot(provider) {
+      return { copilot: ".github/skills", codex: ".agents/skills", claude: ".claude/skills" }[provider];
+    }
   }
 });
 
@@ -1138,394 +1173,6 @@ var require_projectSeedModels = __commonJS({
   }
 });
 
-// ../../packages/repo-seed/dist/projectEnvironmentContract.js
-var require_projectEnvironmentContract = __commonJS({
-  "../../packages/repo-seed/dist/projectEnvironmentContract.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.PROJECT_EXTENSION_CATALOG = exports2.PROJECT_EXTENSION_CATALOG_VERSION = exports2.PROJECT_ENVIRONMENT_SCHEMA_VERSION = exports2.VSCODE_EXTENSIONS_PATH = exports2.PROJECT_ENVIRONMENT_PATH = void 0;
-    exports2.buildProjectEnvironmentManifest = buildProjectEnvironmentManifest;
-    exports2.renderProjectEnvironmentManifest = renderProjectEnvironmentManifest;
-    exports2.renderVsCodeExtensionRecommendations = renderVsCodeExtensionRecommendations;
-    exports2.parseProjectEnvironmentManifest = parseProjectEnvironmentManifest;
-    exports2.PROJECT_ENVIRONMENT_PATH = ".swarmcraft/environment.json";
-    exports2.VSCODE_EXTENSIONS_PATH = ".vscode/extensions.json";
-    exports2.PROJECT_ENVIRONMENT_SCHEMA_VERSION = 1;
-    exports2.PROJECT_EXTENSION_CATALOG_VERSION = 1;
-    exports2.PROJECT_EXTENSION_CATALOG = [
-      catalog("python", "ms-python.python", "Microsoft", "editorSupport", "Microsoft Marketplace terms / open-source components", "medium", "Includes its normal Python language dependencies.", "https://marketplace.visualstudio.com/items?itemName=ms-python.python"),
-      catalog("java", "vscjava.vscode-java-pack", "Microsoft", "editorSupport", "MIT", "high", "Pack already includes Java language, debug, test, Maven, and Gradle tools.", "https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-pack"),
-      catalog("dotnet", "ms-dotnettools.csharp", "Microsoft", "editorSupport", "Microsoft extension terms; source MIT", "medium", "C# Dev Kit is deliberately not required and has a different organisational licence.", "https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csharp"),
-      catalog("terraform", "HashiCorp.terraform", "HashiCorp", "editorSupport", "MPL-2.0 components / Marketplace terms", "medium", "Bundles terraform-ls; the Terraform CLI remains a separate runtime.", "https://marketplace.visualstudio.com/items?itemName=HashiCorp.terraform"),
-      catalog("kubernetes", "redhat.vscode-yaml", "Red Hat", "editorSupport", "MIT", "low", "Provides YAML and Kubernetes schema support without cluster tooling.", "https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml"),
-      catalog("kubernetes", "ms-kubernetes-tools.vscode-kubernetes-tools", "Microsoft", "optionalConvenience", "MIT", "high", "Overlaps YAML support and activates cluster/Helm/kubectl features only when chosen.", "https://marketplace.visualstudio.com/items?itemName=ms-kubernetes-tools.vscode-kubernetes-tools"),
-      catalog("containers", "ms-azuretools.vscode-containers", "Microsoft", "editorSupport", "MIT", "medium", "Replaces the legacy Docker extension's container management and Compose editing surface.", "https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-containers")
-    ];
-    function buildProjectEnvironmentManifest(project) {
-      const context = project.repoSeed?.projectContext;
-      if (!context || context.technologyPreference !== "PREFERRED")
-        return null;
-      const requirements = /* @__PURE__ */ new Map();
-      for (const technology of context.preferredTechnologies) {
-        for (const id of requirementIdsForTechnology(technology)) {
-          if (!requirements.has(id))
-            requirements.set(id, technology);
-        }
-      }
-      if (requirements.size === 0)
-        return null;
-      return {
-        schemaVersion: exports2.PROJECT_ENVIRONMENT_SCHEMA_VERSION,
-        catalogVersion: exports2.PROJECT_EXTENSION_CATALOG_VERSION,
-        source: "project-build-profile",
-        requirements: [...requirements].map(([id, evidence]) => ({ id, evidence }))
-      };
-    }
-    function renderProjectEnvironmentManifest(project) {
-      const manifest = buildProjectEnvironmentManifest(project);
-      return manifest ? `${JSON.stringify(manifest, null, 2)}
-` : null;
-    }
-    function renderVsCodeExtensionRecommendations(project) {
-      const manifest = buildProjectEnvironmentManifest(project);
-      if (!manifest)
-        return null;
-      const requirements = new Set(manifest.requirements.map(({ id }) => id));
-      const recommendations = exports2.PROJECT_EXTENSION_CATALOG.filter(({ requirementId, group }) => requirements.has(requirementId) && group === "editorSupport").map(({ extensionId }) => extensionId).filter((extensionId, index, values) => values.indexOf(extensionId) === index).sort();
-      return recommendations.length > 0 ? `${JSON.stringify({ recommendations }, null, 2)}
-` : null;
-    }
-    function parseProjectEnvironmentManifest(contents) {
-      try {
-        const value = JSON.parse(contents);
-        if (value.schemaVersion !== exports2.PROJECT_ENVIRONMENT_SCHEMA_VERSION || value.catalogVersion !== exports2.PROJECT_EXTENSION_CATALOG_VERSION || value.source !== "project-build-profile" || !Array.isArray(value.requirements))
-          return null;
-        const allowed = /* @__PURE__ */ new Set(["node", "python", "java", "dotnet", "terraform", "kubernetes", "containers"]);
-        if (!value.requirements.every((item) => item && allowed.has(item.id) && typeof item.evidence === "string" && item.evidence.length <= 128))
-          return null;
-        return value;
-      } catch {
-        return null;
-      }
-    }
-    function requirementIdsForTechnology(value) {
-      const normalized = value.trim().toLowerCase();
-      const ids = [];
-      if (/\b(node(?:\.js)?|typescript|javascript|react|next(?:\.js)?)\b/.test(normalized))
-        ids.push("node");
-      if (/\b(python|django|flask|fastapi)\b/.test(normalized))
-        ids.push("python");
-      if (/\b(java|spring|gradle)\b/.test(normalized))
-        ids.push("java");
-      if (/\b(\.net|dotnet|c#|asp\.net)\b/.test(normalized))
-        ids.push("dotnet");
-      if (/\bterraform\b/.test(normalized))
-        ids.push("terraform");
-      if (/\b(kubernetes|k8s|helm)\b/.test(normalized))
-        ids.push("kubernetes");
-      if (/\b(docker|container|compose)\b/.test(normalized))
-        ids.push("containers");
-      return ids;
-    }
-    function catalog(requirementId, extensionId, publisher, group, licence, activationCost, overlap, marketplaceUrl) {
-      return { requirementId, extensionId, publisher, group, licence, activationCost, overlap, maintained: true, reviewedAt: "2026-09-01", marketplaceUrl };
-    }
-  }
-});
-
-// ../../packages/repo-seed/dist/templates/renderCopilotAgents.js
-var require_renderCopilotAgents = __commonJS({
-  "../../packages/repo-seed/dist/templates/renderCopilotAgents.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.renderPacketInstructionsFile = renderPacketInstructionsFile;
-    exports2.renderImplementorAgentFile = renderImplementorAgentFile;
-    exports2.renderCheckerAgentFile = renderCheckerAgentFile;
-    exports2.renderReviewerAgentFile = renderReviewerAgentFile;
-    var packet_workflow_1 = require_dist();
-    function renderPacketInstructionsFile() {
-      return [
-        "---",
-        'description: "Auto-applied SwarmCraft packet rules for planning packets under .swarmcraft/projects and related workflow guidance files"',
-        'applyTo: ".swarmcraft/**/*.md"',
-        "---",
-        "",
-        "# SwarmCraft Packet Instructions",
-        "",
-        "Use SwarmCraft packet files as the source of truth for scoped task work and status updates.",
-        "",
-        "## Packet Contract",
-        "",
-        "* Preserve packet identity and sync fields such as `projectId`, `taskId`, and `syncRevision` unless SwarmCraft itself rewrites them.",
-        "* Edit packet frontmatter `lane` only when a SwarmCraft stage prompt or lane guidance explicitly tells you to request an adjacent workflow move.",
-        `* Preserve the staged packet structure: ${packet_workflow_1.PACKET_SECTIONS.map((section) => `\`${section}\``).join(", ")}.`,
-        "* Treat checklist text as board-owned scope; mark items complete only when the repo state actually supports it.",
-        "* Reviewing checklist items require explicit human approval before they are marked complete; repository evidence can inform the question but cannot replace the human confirmation.",
-        "* When all checklist items for the current lane are complete and no unresolved blocker or question remains, set packet frontmatter `lane` to the next adjacent workflow lane unless the reviewing-to-done transition is owned by the SwarmCraft extension.",
-        "* Keep `## Notes` factual and implementation-specific. Use `### Implementation Notes`, `### Checking Feedback`, and `### Review Notes` for stage-specific packet comments.",
-        "* Keep `## Agent Update` short and structured around what changed, what was validated, and what remains blocked or risky.",
-        "",
-        "## Workflow Expectations",
-        "",
-        "* Read `.swarmcraft/AGENTS.md`, `.swarmcraft/project.instructions.md`, and `.swarmcraft/project.context.md` before making substantive task changes when those files exist.",
-        "* Use the lane-specific guidance in `.swarmcraft/agents/` for the current workflow stage.",
-        "* Keep packet notes and agent update aligned with the actual code, validation status, and task state.",
-        "* Prefer small, reviewable edits and the narrowest validation that can falsify the change.",
-        "* If the packet and repo diverge, reconcile them explicitly instead of hiding the mismatch in chat only.",
-        ""
-      ].join("\n");
-    }
-    function renderImplementorAgentFile() {
-      const stage = (0, packet_workflow_1.getSwarmCraftStageContract)("doing");
-      return [
-        "---",
-        `name: "${stage.agentTitle}"`,
-        `description: "${stage.agentDescription}"`,
-        "tools: [read, edit, search, execute, todo]",
-        `argument-hint: "${stage.agentArgumentHint}"`,
-        "agents: []",
-        "---",
-        "",
-        `# ${stage.agentTitle}`,
-        "",
-        stage.agentPurpose,
-        "",
-        "## Purpose",
-        "",
-        "* Execute the current packet without inventing extra scope.",
-        "* Keep packet checklist progress, notes, and agent update consistent with the repo.",
-        "* Stop at the smallest validated change that satisfies the task.",
-        "",
-        "## Required Context",
-        "",
-        "1. Read `AGENTS.md` and the nearest scoped `AGENTS.md` files for touched code.",
-        "2. Read `.swarmcraft/AGENTS.md`, `.swarmcraft/project.instructions.md`, and `.swarmcraft/project.context.md` when present.",
-        "3. Read the linked packet under `.swarmcraft/projects/` before editing code.",
-        "4. Read `.swarmcraft/agents/doing.instructions.md` when present.",
-        "",
-        "## Constraints",
-        "",
-        "* Do not expand the scope beyond the packet unless the packet itself requires adjacent work.",
-        "* Do not rewrite packet identity fields or staged checklist text.",
-        "* Do not mark checklist items complete until code and validation actually support them.",
-        "* Do not ask whether to update completed Doing checklist items or move to checking when the evidence is complete; update the packet directly.",
-        "* Prefer the narrowest tests or checks that can falsify the change.",
-        "",
-        "## Workflow",
-        "",
-        ...(0, packet_workflow_1.renderNumberedLines)(stage.agentWorkflow),
-        "",
-        "## Output Format",
-        "",
-        "Return:",
-        "",
-        ...(0, packet_workflow_1.renderBullets)(stage.outputItems),
-        ""
-      ].join("\n");
-    }
-    function renderCheckerAgentFile() {
-      const stage = (0, packet_workflow_1.getSwarmCraftStageContract)("checking");
-      return [
-        "---",
-        `name: "${stage.agentTitle}"`,
-        `description: "${stage.agentDescription}"`,
-        "tools: [read, edit, search, execute, todo]",
-        `argument-hint: "${stage.agentArgumentHint}"`,
-        "agents: []",
-        "---",
-        "",
-        `# ${stage.agentTitle}`,
-        "",
-        stage.agentPurpose,
-        "",
-        "## Purpose",
-        "",
-        "* Falsify the implementation with the narrowest meaningful validation.",
-        "* Act as a machine judge: accept the work toward human review or reject it back to doing.",
-        "* Confirm packet checklist progress and notes still match the repo.",
-        "* Surface regressions, gaps, and incomplete acceptance criteria as packet feedback for the implementor.",
-        "",
-        "## Required Context",
-        "",
-        "1. Read `AGENTS.md` and the nearest scoped `AGENTS.md` files for any validated code.",
-        "2. Read `.swarmcraft/AGENTS.md`, `.swarmcraft/project.instructions.md`, and `.swarmcraft/project.context.md` when present.",
-        "3. Read the linked packet under `.swarmcraft/projects/` before validating.",
-        "4. Read `.swarmcraft/agents/checking.instructions.md` when present.",
-        "",
-        "## Constraints",
-        "",
-        "* Do not repair implementation defects during checking unless the user explicitly asks.",
-        "* Do not broaden validation scope unless the current check exposes a nearby defect.",
-        "* Do not claim success without naming the concrete validation that passed.",
-        "* Do not move unresolved risk out of the packet and into chat only.",
-        "* Do not rewrite packet identity fields or staged checklist text.",
-        "* Do not ask whether to update completed Checking checklist items or move to reviewing when the evidence is complete; update the packet directly.",
-        "",
-        "## Workflow",
-        "",
-        ...(0, packet_workflow_1.renderNumberedLines)(stage.agentWorkflow),
-        "",
-        "## Output Format",
-        "",
-        "Return:",
-        "",
-        ...(0, packet_workflow_1.renderBullets)(stage.outputItems),
-        ""
-      ].join("\n");
-    }
-    function renderReviewerAgentFile() {
-      const stage = (0, packet_workflow_1.getSwarmCraftStageContract)("reviewing");
-      return [
-        "---",
-        `name: "${stage.agentTitle}"`,
-        `description: "${stage.agentDescription}"`,
-        "tools: [read, edit, search, todo]",
-        `argument-hint: "${stage.agentArgumentHint}"`,
-        "agents: []",
-        "---",
-        "",
-        `# ${stage.agentTitle}`,
-        "",
-        stage.agentPurpose,
-        "",
-        "## Purpose",
-        "",
-        "* Prompt the user for each Reviewing checklist decision.",
-        "* Record the user's approval, rejection, uncertainty, and requested follow-up in the packet.",
-        "* Call out risks, missing evidence, and follow-up work explicitly.",
-        "",
-        "## Required Context",
-        "",
-        "1. Read `AGENTS.md` and the nearest scoped `AGENTS.md` files for the touched surface.",
-        "2. Read `.swarmcraft/AGENTS.md`, `.swarmcraft/project.instructions.md`, and `.swarmcraft/project.context.md` when present.",
-        "3. Read the linked packet under `.swarmcraft/projects/` before editing the handoff.",
-        "4. Read `.swarmcraft/agents/reviewing.instructions.md` when present.",
-        "",
-        "## Constraints",
-        "",
-        "* Do not hide unfinished work behind optimistic summaries.",
-        "* Do not rewrite the packet into a changelog; keep it concise and review-oriented.",
-        "* Do not claim review readiness if risks or validation gaps remain unresolved.",
-        "* Do not mark Reviewing checklist items complete from repository evidence alone; every checked item requires explicit human approval in the current review interaction.",
-        "* Do not act as the checking agent. Avoid fresh validation unless the user asks for it; use existing evidence only to help the user decide.",
-        "* Do not set packet frontmatter `lane: done`; the SwarmCraft extension owns the final done transition.",
-        "* Do not rewrite packet identity fields or staged checklist text.",
-        "",
-        "## Workflow",
-        "",
-        ...(0, packet_workflow_1.renderNumberedLines)(stage.agentWorkflow),
-        "",
-        "## Output Format",
-        "",
-        "Return:",
-        "",
-        ...(0, packet_workflow_1.renderBullets)(stage.outputItems),
-        ""
-      ].join("\n");
-    }
-  }
-});
-
-// ../../packages/repo-seed/dist/templates/renderCodexAgents.js
-var require_renderCodexAgents = __commonJS({
-  "../../packages/repo-seed/dist/templates/renderCodexAgents.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.renderCodexImplementorAgentFile = renderCodexImplementorAgentFile;
-    exports2.renderCodexCheckerAgentFile = renderCodexCheckerAgentFile;
-    exports2.renderCodexReviewerAgentFile = renderCodexReviewerAgentFile;
-    exports2.renderCodexConfigExampleFile = renderCodexConfigExampleFile;
-    var packet_workflow_1 = require_dist();
-    function renderCodexImplementorAgentFile() {
-      return renderCodexStageAgentFile("doing", "swarmcraft-implementor", "medium");
-    }
-    function renderCodexCheckerAgentFile() {
-      return renderCodexStageAgentFile("checking", "swarmcraft-checker", "medium");
-    }
-    function renderCodexReviewerAgentFile() {
-      return renderCodexStageAgentFile("reviewing", "swarmcraft-reviewer", "low");
-    }
-    function renderCodexConfigExampleFile() {
-      return [
-        "# Example project-scoped Codex config for a SwarmCraft-seeded repository.",
-        "#",
-        "# This file documents optional local setup. It is not loaded automatically.",
-        "# To use it, copy the relevant sections into `.codex/config.toml` or your",
-        "# personal `~/.codex/config.toml`, then adjust local paths and environment variables.",
-        "#",
-        "# Do not commit `.codex/config.toml` if it contains local paths, credentials,",
-        "# tokens, private keys, or machine-specific settings.",
-        "",
-        "# Keep subagent fan-out modest. SwarmCraft's default workflow is one task",
-        "# stage at a time: do, check, then review.",
-        "[agents]",
-        "max_threads = 3",
-        "max_depth = 1",
-        "",
-        "# Optional first MCP server for OpenAI or Codex documentation questions.",
-        "# Tool posture: read-only documentation lookup.",
-        "# Secret handling: no secret required.",
-        "#",
-        "# [mcp_servers.openaiDeveloperDocs]",
-        '# url = "https://developers.openai.com/mcp"',
-        "# enabled = true",
-        '# default_tools_approval_mode = "auto"',
-        "",
-        "# Optional browser automation for local UI verification.",
-        "# Tool posture: can open pages, inspect browser state, and drive browser actions.",
-        "# Approval posture: prompt by default because browser tools can interact with",
-        "# local apps and external pages.",
-        "#",
-        "# [mcp_servers.playwright]",
-        '# command = "npx"',
-        '# args = ["-y", "@playwright/mcp"]',
-        "# enabled = true",
-        '# default_tools_approval_mode = "prompt"',
-        "# tool_timeout_sec = 120",
-        ""
-      ].join("\n");
-    }
-    function renderCodexStageAgentFile(stageKey, name, reasoningEffort) {
-      const stage = (0, packet_workflow_1.getSwarmCraftStageContract)(stageKey);
-      const instructions = [
-        `You are the ${stage.agentTitle}.`,
-        "",
-        stage.agentPurpose,
-        "",
-        "Follow this workflow:",
-        ...(0, packet_workflow_1.renderNumberedLines)([
-          "Read `AGENTS.md` and the nearest scoped `AGENTS.md` files for touched code.",
-          "Read `.swarmcraft/AGENTS.md`, `.swarmcraft/project.instructions.md`, and `.swarmcraft/project.context.md` when present.",
-          "Read the linked packet under `.swarmcraft/projects/` before changing files.",
-          `Read \`.swarmcraft/agents/${stage.key}.instructions.md\` when present.`,
-          ...stage.agentWorkflow
-        ]),
-        "",
-        "Output expectations:",
-        ...stage.outputItems.map((item) => `- ${item}`),
-        "",
-        "Stage completion rule:",
-        stage.completionRule,
-        "",
-        "Do not rewrite packet identity fields, board-owned checklist text, unrelated local changes, or workflow history."
-      ].join("\n");
-      return [
-        `name = "${name}"`,
-        `description = "${escapeTomlString(stage.agentDescription)}"`,
-        `model_reasoning_effort = "${reasoningEffort}"`,
-        "",
-        'developer_instructions = """',
-        instructions,
-        '"""',
-        ""
-      ].join("\n");
-    }
-    function escapeTomlString(value) {
-      return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
-    }
-  }
-});
-
 // ../../packages/repo-seed/dist/templates/renderAssistantActionSkills.js
 var require_renderAssistantActionSkills = __commonJS({
   "../../packages/repo-seed/dist/templates/renderAssistantActionSkills.js"(exports2) {
@@ -1965,6 +1612,406 @@ var require_renderAssistantActionSkills = __commonJS({
   }
 });
 
+// ../../packages/repo-seed/dist/templates/renderClaudeGuidance.js
+var require_renderClaudeGuidance = __commonJS({
+  "../../packages/repo-seed/dist/templates/renderClaudeGuidance.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.renderClaudeGuidance = renderClaudeGuidance;
+    function renderClaudeGuidance() {
+      return "# SwarmCraft\n\nFollow AGENTS.md and the nearest scoped AGENTS.md for the files you work on.\nUse the SwarmCraft skills under .claude/skills/ for the requested workflow.\nPreserve existing review, authority, and packet transition rules.\n";
+    }
+  }
+});
+
+// ../../packages/repo-seed/dist/projectEnvironmentContract.js
+var require_projectEnvironmentContract = __commonJS({
+  "../../packages/repo-seed/dist/projectEnvironmentContract.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.PROJECT_EXTENSION_CATALOG = exports2.PROJECT_EXTENSION_CATALOG_VERSION = exports2.PROJECT_ENVIRONMENT_SCHEMA_VERSION = exports2.VSCODE_EXTENSIONS_PATH = exports2.PROJECT_ENVIRONMENT_PATH = void 0;
+    exports2.buildProjectEnvironmentManifest = buildProjectEnvironmentManifest;
+    exports2.renderProjectEnvironmentManifest = renderProjectEnvironmentManifest;
+    exports2.renderVsCodeExtensionRecommendations = renderVsCodeExtensionRecommendations;
+    exports2.parseProjectEnvironmentManifest = parseProjectEnvironmentManifest;
+    exports2.PROJECT_ENVIRONMENT_PATH = ".swarmcraft/environment.json";
+    exports2.VSCODE_EXTENSIONS_PATH = ".vscode/extensions.json";
+    exports2.PROJECT_ENVIRONMENT_SCHEMA_VERSION = 1;
+    exports2.PROJECT_EXTENSION_CATALOG_VERSION = 1;
+    exports2.PROJECT_EXTENSION_CATALOG = [
+      catalog("python", "ms-python.python", "Microsoft", "editorSupport", "Microsoft Marketplace terms / open-source components", "medium", "Includes its normal Python language dependencies.", "https://marketplace.visualstudio.com/items?itemName=ms-python.python"),
+      catalog("java", "vscjava.vscode-java-pack", "Microsoft", "editorSupport", "MIT", "high", "Pack already includes Java language, debug, test, Maven, and Gradle tools.", "https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-pack"),
+      catalog("dotnet", "ms-dotnettools.csharp", "Microsoft", "editorSupport", "Microsoft extension terms; source MIT", "medium", "C# Dev Kit is deliberately not required and has a different organisational licence.", "https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csharp"),
+      catalog("terraform", "HashiCorp.terraform", "HashiCorp", "editorSupport", "MPL-2.0 components / Marketplace terms", "medium", "Bundles terraform-ls; the Terraform CLI remains a separate runtime.", "https://marketplace.visualstudio.com/items?itemName=HashiCorp.terraform"),
+      catalog("kubernetes", "redhat.vscode-yaml", "Red Hat", "editorSupport", "MIT", "low", "Provides YAML and Kubernetes schema support without cluster tooling.", "https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml"),
+      catalog("kubernetes", "ms-kubernetes-tools.vscode-kubernetes-tools", "Microsoft", "optionalConvenience", "MIT", "high", "Overlaps YAML support and activates cluster/Helm/kubectl features only when chosen.", "https://marketplace.visualstudio.com/items?itemName=ms-kubernetes-tools.vscode-kubernetes-tools"),
+      catalog("containers", "ms-azuretools.vscode-containers", "Microsoft", "editorSupport", "MIT", "medium", "Replaces the legacy Docker extension's container management and Compose editing surface.", "https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-containers")
+    ];
+    function buildProjectEnvironmentManifest(project) {
+      const context = project.repoSeed?.projectContext;
+      if (!context || context.technologyPreference !== "PREFERRED")
+        return null;
+      const requirements = /* @__PURE__ */ new Map();
+      for (const technology of context.preferredTechnologies) {
+        for (const id of requirementIdsForTechnology(technology)) {
+          if (!requirements.has(id))
+            requirements.set(id, technology);
+        }
+      }
+      if (requirements.size === 0)
+        return null;
+      return {
+        schemaVersion: exports2.PROJECT_ENVIRONMENT_SCHEMA_VERSION,
+        catalogVersion: exports2.PROJECT_EXTENSION_CATALOG_VERSION,
+        source: "project-build-profile",
+        requirements: [...requirements].map(([id, evidence]) => ({ id, evidence }))
+      };
+    }
+    function renderProjectEnvironmentManifest(project) {
+      const manifest = buildProjectEnvironmentManifest(project);
+      return manifest ? `${JSON.stringify(manifest, null, 2)}
+` : null;
+    }
+    function renderVsCodeExtensionRecommendations(project) {
+      const manifest = buildProjectEnvironmentManifest(project);
+      if (!manifest)
+        return null;
+      const requirements = new Set(manifest.requirements.map(({ id }) => id));
+      const recommendations = exports2.PROJECT_EXTENSION_CATALOG.filter(({ requirementId, group }) => requirements.has(requirementId) && group === "editorSupport").map(({ extensionId }) => extensionId).filter((extensionId, index, values) => values.indexOf(extensionId) === index).sort();
+      return recommendations.length > 0 ? `${JSON.stringify({ recommendations }, null, 2)}
+` : null;
+    }
+    function parseProjectEnvironmentManifest(contents) {
+      try {
+        const value = JSON.parse(contents);
+        if (value.schemaVersion !== exports2.PROJECT_ENVIRONMENT_SCHEMA_VERSION || value.catalogVersion !== exports2.PROJECT_EXTENSION_CATALOG_VERSION || value.source !== "project-build-profile" || !Array.isArray(value.requirements))
+          return null;
+        const allowed = /* @__PURE__ */ new Set(["node", "python", "java", "dotnet", "terraform", "kubernetes", "containers"]);
+        if (!value.requirements.every((item) => item && allowed.has(item.id) && typeof item.evidence === "string" && item.evidence.length <= 128))
+          return null;
+        return value;
+      } catch {
+        return null;
+      }
+    }
+    function requirementIdsForTechnology(value) {
+      const normalized = value.trim().toLowerCase();
+      const ids = [];
+      if (/\b(node(?:\.js)?|typescript|javascript|react|next(?:\.js)?)\b/.test(normalized))
+        ids.push("node");
+      if (/\b(python|django|flask|fastapi)\b/.test(normalized))
+        ids.push("python");
+      if (/\b(java|spring|gradle)\b/.test(normalized))
+        ids.push("java");
+      if (/\b(\.net|dotnet|c#|asp\.net)\b/.test(normalized))
+        ids.push("dotnet");
+      if (/\bterraform\b/.test(normalized))
+        ids.push("terraform");
+      if (/\b(kubernetes|k8s|helm)\b/.test(normalized))
+        ids.push("kubernetes");
+      if (/\b(docker|container|compose)\b/.test(normalized))
+        ids.push("containers");
+      return ids;
+    }
+    function catalog(requirementId, extensionId, publisher, group, licence, activationCost, overlap, marketplaceUrl) {
+      return { requirementId, extensionId, publisher, group, licence, activationCost, overlap, maintained: true, reviewedAt: "2026-09-01", marketplaceUrl };
+    }
+  }
+});
+
+// ../../packages/repo-seed/dist/templates/renderCopilotAgents.js
+var require_renderCopilotAgents = __commonJS({
+  "../../packages/repo-seed/dist/templates/renderCopilotAgents.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.renderPacketInstructionsFile = renderPacketInstructionsFile;
+    exports2.renderImplementorAgentFile = renderImplementorAgentFile;
+    exports2.renderCheckerAgentFile = renderCheckerAgentFile;
+    exports2.renderReviewerAgentFile = renderReviewerAgentFile;
+    var packet_workflow_1 = require_dist();
+    function renderPacketInstructionsFile() {
+      return [
+        "---",
+        'description: "Auto-applied SwarmCraft packet rules for planning packets under .swarmcraft/projects and related workflow guidance files"',
+        'applyTo: ".swarmcraft/**/*.md"',
+        "---",
+        "",
+        "# SwarmCraft Packet Instructions",
+        "",
+        "Use SwarmCraft packet files as the source of truth for scoped task work and status updates.",
+        "",
+        "## Packet Contract",
+        "",
+        "* Preserve packet identity and sync fields such as `projectId`, `taskId`, and `syncRevision` unless SwarmCraft itself rewrites them.",
+        "* Edit packet frontmatter `lane` only when a SwarmCraft stage prompt or lane guidance explicitly tells you to request an adjacent workflow move.",
+        `* Preserve the staged packet structure: ${packet_workflow_1.PACKET_SECTIONS.map((section) => `\`${section}\``).join(", ")}.`,
+        "* Treat checklist text as board-owned scope; mark items complete only when the repo state actually supports it.",
+        "* Reviewing checklist items require explicit human approval before they are marked complete; repository evidence can inform the question but cannot replace the human confirmation.",
+        "* When all checklist items for the current lane are complete and no unresolved blocker or question remains, set packet frontmatter `lane` to the next adjacent workflow lane unless the reviewing-to-done transition is owned by the SwarmCraft extension.",
+        "* Keep `## Notes` factual and implementation-specific. Use `### Implementation Notes`, `### Checking Feedback`, and `### Review Notes` for stage-specific packet comments.",
+        "* Keep `## Agent Update` short and structured around what changed, what was validated, and what remains blocked or risky.",
+        "",
+        "## Workflow Expectations",
+        "",
+        "* Read `.swarmcraft/AGENTS.md`, `.swarmcraft/project.instructions.md`, and `.swarmcraft/project.context.md` before making substantive task changes when those files exist.",
+        "* Use the lane-specific guidance in `.swarmcraft/agents/` for the current workflow stage.",
+        "* Keep packet notes and agent update aligned with the actual code, validation status, and task state.",
+        "* Prefer small, reviewable edits and the narrowest validation that can falsify the change.",
+        "* If the packet and repo diverge, reconcile them explicitly instead of hiding the mismatch in chat only.",
+        ""
+      ].join("\n");
+    }
+    function renderImplementorAgentFile() {
+      const stage = (0, packet_workflow_1.getSwarmCraftStageContract)("doing");
+      return [
+        "---",
+        `name: "${stage.agentTitle}"`,
+        `description: "${stage.agentDescription}"`,
+        "tools: [read, edit, search, execute, todo]",
+        `argument-hint: "${stage.agentArgumentHint}"`,
+        "agents: []",
+        "---",
+        "",
+        `# ${stage.agentTitle}`,
+        "",
+        stage.agentPurpose,
+        "",
+        "## Purpose",
+        "",
+        "* Execute the current packet without inventing extra scope.",
+        "* Keep packet checklist progress, notes, and agent update consistent with the repo.",
+        "* Stop at the smallest validated change that satisfies the task.",
+        "",
+        "## Required Context",
+        "",
+        "1. Read `AGENTS.md` and the nearest scoped `AGENTS.md` files for touched code.",
+        "2. Read `.swarmcraft/AGENTS.md`, `.swarmcraft/project.instructions.md`, and `.swarmcraft/project.context.md` when present.",
+        "3. Read the linked packet under `.swarmcraft/projects/` before editing code.",
+        "4. Read `.swarmcraft/agents/doing.instructions.md` when present.",
+        "",
+        "## Constraints",
+        "",
+        "* Do not expand the scope beyond the packet unless the packet itself requires adjacent work.",
+        "* Do not rewrite packet identity fields or staged checklist text.",
+        "* Do not mark checklist items complete until code and validation actually support them.",
+        "* Do not ask whether to update completed Doing checklist items or move to checking when the evidence is complete; update the packet directly.",
+        "* Prefer the narrowest tests or checks that can falsify the change.",
+        "",
+        "## Workflow",
+        "",
+        ...(0, packet_workflow_1.renderNumberedLines)(stage.agentWorkflow),
+        "",
+        "## Output Format",
+        "",
+        "Return:",
+        "",
+        ...(0, packet_workflow_1.renderBullets)(stage.outputItems),
+        ""
+      ].join("\n");
+    }
+    function renderCheckerAgentFile() {
+      const stage = (0, packet_workflow_1.getSwarmCraftStageContract)("checking");
+      return [
+        "---",
+        `name: "${stage.agentTitle}"`,
+        `description: "${stage.agentDescription}"`,
+        "tools: [read, edit, search, execute, todo]",
+        `argument-hint: "${stage.agentArgumentHint}"`,
+        "agents: []",
+        "---",
+        "",
+        `# ${stage.agentTitle}`,
+        "",
+        stage.agentPurpose,
+        "",
+        "## Purpose",
+        "",
+        "* Falsify the implementation with the narrowest meaningful validation.",
+        "* Act as a machine judge: accept the work toward human review or reject it back to doing.",
+        "* Confirm packet checklist progress and notes still match the repo.",
+        "* Surface regressions, gaps, and incomplete acceptance criteria as packet feedback for the implementor.",
+        "",
+        "## Required Context",
+        "",
+        "1. Read `AGENTS.md` and the nearest scoped `AGENTS.md` files for any validated code.",
+        "2. Read `.swarmcraft/AGENTS.md`, `.swarmcraft/project.instructions.md`, and `.swarmcraft/project.context.md` when present.",
+        "3. Read the linked packet under `.swarmcraft/projects/` before validating.",
+        "4. Read `.swarmcraft/agents/checking.instructions.md` when present.",
+        "",
+        "## Constraints",
+        "",
+        "* Do not repair implementation defects during checking unless the user explicitly asks.",
+        "* Do not broaden validation scope unless the current check exposes a nearby defect.",
+        "* Do not claim success without naming the concrete validation that passed.",
+        "* Do not move unresolved risk out of the packet and into chat only.",
+        "* Do not rewrite packet identity fields or staged checklist text.",
+        "* Do not ask whether to update completed Checking checklist items or move to reviewing when the evidence is complete; update the packet directly.",
+        "",
+        "## Workflow",
+        "",
+        ...(0, packet_workflow_1.renderNumberedLines)(stage.agentWorkflow),
+        "",
+        "## Output Format",
+        "",
+        "Return:",
+        "",
+        ...(0, packet_workflow_1.renderBullets)(stage.outputItems),
+        ""
+      ].join("\n");
+    }
+    function renderReviewerAgentFile() {
+      const stage = (0, packet_workflow_1.getSwarmCraftStageContract)("reviewing");
+      return [
+        "---",
+        `name: "${stage.agentTitle}"`,
+        `description: "${stage.agentDescription}"`,
+        "tools: [read, edit, search, todo]",
+        `argument-hint: "${stage.agentArgumentHint}"`,
+        "agents: []",
+        "---",
+        "",
+        `# ${stage.agentTitle}`,
+        "",
+        stage.agentPurpose,
+        "",
+        "## Purpose",
+        "",
+        "* Prompt the user for each Reviewing checklist decision.",
+        "* Record the user's approval, rejection, uncertainty, and requested follow-up in the packet.",
+        "* Call out risks, missing evidence, and follow-up work explicitly.",
+        "",
+        "## Required Context",
+        "",
+        "1. Read `AGENTS.md` and the nearest scoped `AGENTS.md` files for the touched surface.",
+        "2. Read `.swarmcraft/AGENTS.md`, `.swarmcraft/project.instructions.md`, and `.swarmcraft/project.context.md` when present.",
+        "3. Read the linked packet under `.swarmcraft/projects/` before editing the handoff.",
+        "4. Read `.swarmcraft/agents/reviewing.instructions.md` when present.",
+        "",
+        "## Constraints",
+        "",
+        "* Do not hide unfinished work behind optimistic summaries.",
+        "* Do not rewrite the packet into a changelog; keep it concise and review-oriented.",
+        "* Do not claim review readiness if risks or validation gaps remain unresolved.",
+        "* Do not mark Reviewing checklist items complete from repository evidence alone; every checked item requires explicit human approval in the current review interaction.",
+        "* Do not act as the checking agent. Avoid fresh validation unless the user asks for it; use existing evidence only to help the user decide.",
+        "* Do not set packet frontmatter `lane: done`; the SwarmCraft extension owns the final done transition.",
+        "* Do not rewrite packet identity fields or staged checklist text.",
+        "",
+        "## Workflow",
+        "",
+        ...(0, packet_workflow_1.renderNumberedLines)(stage.agentWorkflow),
+        "",
+        "## Output Format",
+        "",
+        "Return:",
+        "",
+        ...(0, packet_workflow_1.renderBullets)(stage.outputItems),
+        ""
+      ].join("\n");
+    }
+  }
+});
+
+// ../../packages/repo-seed/dist/templates/renderCodexAgents.js
+var require_renderCodexAgents = __commonJS({
+  "../../packages/repo-seed/dist/templates/renderCodexAgents.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.renderCodexImplementorAgentFile = renderCodexImplementorAgentFile;
+    exports2.renderCodexCheckerAgentFile = renderCodexCheckerAgentFile;
+    exports2.renderCodexReviewerAgentFile = renderCodexReviewerAgentFile;
+    exports2.renderCodexConfigExampleFile = renderCodexConfigExampleFile;
+    var packet_workflow_1 = require_dist();
+    function renderCodexImplementorAgentFile() {
+      return renderCodexStageAgentFile("doing", "swarmcraft-implementor", "medium");
+    }
+    function renderCodexCheckerAgentFile() {
+      return renderCodexStageAgentFile("checking", "swarmcraft-checker", "medium");
+    }
+    function renderCodexReviewerAgentFile() {
+      return renderCodexStageAgentFile("reviewing", "swarmcraft-reviewer", "low");
+    }
+    function renderCodexConfigExampleFile() {
+      return [
+        "# Example project-scoped Codex config for a SwarmCraft-seeded repository.",
+        "#",
+        "# This file documents optional local setup. It is not loaded automatically.",
+        "# To use it, copy the relevant sections into `.codex/config.toml` or your",
+        "# personal `~/.codex/config.toml`, then adjust local paths and environment variables.",
+        "#",
+        "# Do not commit `.codex/config.toml` if it contains local paths, credentials,",
+        "# tokens, private keys, or machine-specific settings.",
+        "",
+        "# Keep subagent fan-out modest. SwarmCraft's default workflow is one task",
+        "# stage at a time: do, check, then review.",
+        "[agents]",
+        "max_threads = 3",
+        "max_depth = 1",
+        "",
+        "# Optional first MCP server for OpenAI or Codex documentation questions.",
+        "# Tool posture: read-only documentation lookup.",
+        "# Secret handling: no secret required.",
+        "#",
+        "# [mcp_servers.openaiDeveloperDocs]",
+        '# url = "https://developers.openai.com/mcp"',
+        "# enabled = true",
+        '# default_tools_approval_mode = "auto"',
+        "",
+        "# Optional browser automation for local UI verification.",
+        "# Tool posture: can open pages, inspect browser state, and drive browser actions.",
+        "# Approval posture: prompt by default because browser tools can interact with",
+        "# local apps and external pages.",
+        "#",
+        "# [mcp_servers.playwright]",
+        '# command = "npx"',
+        '# args = ["-y", "@playwright/mcp"]',
+        "# enabled = true",
+        '# default_tools_approval_mode = "prompt"',
+        "# tool_timeout_sec = 120",
+        ""
+      ].join("\n");
+    }
+    function renderCodexStageAgentFile(stageKey, name, reasoningEffort) {
+      const stage = (0, packet_workflow_1.getSwarmCraftStageContract)(stageKey);
+      const instructions = [
+        `You are the ${stage.agentTitle}.`,
+        "",
+        stage.agentPurpose,
+        "",
+        "Follow this workflow:",
+        ...(0, packet_workflow_1.renderNumberedLines)([
+          "Read `AGENTS.md` and the nearest scoped `AGENTS.md` files for touched code.",
+          "Read `.swarmcraft/AGENTS.md`, `.swarmcraft/project.instructions.md`, and `.swarmcraft/project.context.md` when present.",
+          "Read the linked packet under `.swarmcraft/projects/` before changing files.",
+          `Read \`.swarmcraft/agents/${stage.key}.instructions.md\` when present.`,
+          ...stage.agentWorkflow
+        ]),
+        "",
+        "Output expectations:",
+        ...stage.outputItems.map((item) => `- ${item}`),
+        "",
+        "Stage completion rule:",
+        stage.completionRule,
+        "",
+        "Do not rewrite packet identity fields, board-owned checklist text, unrelated local changes, or workflow history."
+      ].join("\n");
+      return [
+        `name = "${name}"`,
+        `description = "${escapeTomlString(stage.agentDescription)}"`,
+        `model_reasoning_effort = "${reasoningEffort}"`,
+        "",
+        'developer_instructions = """',
+        instructions,
+        '"""',
+        ""
+      ].join("\n");
+    }
+    function escapeTomlString(value) {
+      return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    }
+  }
+});
+
 // ../../packages/repo-seed/dist/templates/renderCodexSkills.js
 var require_renderCodexSkills = __commonJS({
   "../../packages/repo-seed/dist/templates/renderCodexSkills.js"(exports2) {
@@ -2789,7 +2836,7 @@ var require_renderProjectGuide = __commonJS({
         "",
         "Primary assistant actions:",
         "",
-        ...packet_workflow_1.SWARMCRAFT_ASSISTANT_ACTIONS.map((action) => `- \`${action.copilotInvocation}\` in Copilot or \`${action.codexInvocation}\` in Codex: ${action.description}`),
+        ...packet_workflow_1.SWARMCRAFT_ASSISTANT_ACTIONS.map((action) => `- \`${action.copilotInvocation}\` in Copilot, \`${action.codexInvocation}\` in Codex, or \`${action.claudeInvocation}\` in Claude Code: ${action.description}`),
         "",
         "Collaborative decision aid:",
         "",
@@ -2951,11 +2998,12 @@ var require_renderPrototype = __commonJS({
     exports2.renderPrototypeSkill = renderPrototypeSkill;
     exports2.renderGreenfieldReactPrototypeReference = renderGreenfieldReactPrototypeReference;
     exports2.renderPrototypePrompt = renderPrototypePrompt;
+    var packet_workflow_1 = require_dist();
     exports2.COPILOT_PROTOTYPE_SKILL_PATH = ".github/skills/swarmcraft-prototype/SKILL.md";
     exports2.COPILOT_PROTOTYPE_PROMPT_PATH = ".github/prompts/prototype.prompt.md";
     exports2.CODEX_PROTOTYPE_SKILL_PATH = ".agents/skills/swarmcraft-prototype/SKILL.md";
     function renderPrototypeSeedFiles(provider) {
-      const skillRoot = provider === "copilot" ? ".github/skills/swarmcraft-prototype" : ".agents/skills/swarmcraft-prototype";
+      const skillRoot = `${(0, packet_workflow_1.getProviderSkillRoot)(provider)}/swarmcraft-prototype`;
       const files = [
         { relativePath: `${skillRoot}/SKILL.md`, contents: renderPrototypeSkill(provider) },
         { relativePath: `${skillRoot}/references/greenfield-react-prototype.md`, contents: renderGreenfieldReactPrototypeReference() },
@@ -2970,7 +3018,7 @@ var require_renderPrototype = __commonJS({
       return files;
     }
     function renderPrototypeSkill(provider) {
-      const invocation = provider === "codex" ? "$swarmcraft-prototype" : "/prototype";
+      const invocation = (0, packet_workflow_1.buildSkillInvocation)(provider, "prototype");
       return `---
 name: swarmcraft-prototype
 description: Build or revise disposable, locally reviewable prototypes that help owners understand and decide uncertain workflows, interfaces, state transitions, responsive behavior, authority boundaries, or failure paths during SwarmCraft discovery, planning, implementation departure review, or human review.
@@ -3008,7 +3056,7 @@ When a surrounding discovery or planning workflow invokes this skill again, insp
 - For material greenfield web discovery, default to a small React/Vite application at \`apps/prototypes/<short-slug>\` that consumes \`packages/design-system\`; keep its owner-facing companion and screenshots at \`docs/prototypes/<short-slug>\`.
 - Use the standalone HTML/CSS/JavaScript template only for non-web work, a materially incompatible or unavailable stack, a truly isolated low-dependency decision surface, or an explicit owner-authorized constraint. Record why the fallback is appropriate. An empty repository is not a fallback reason.
 - Classify every new design need as foundation, component, pattern, adapter, or application; record provenance as \`COMPANY_SYSTEM\`, \`ADAPTED\`, or \`NEW\`; and keep prototype proposals \`EXPERIMENTAL\`.
-- Do not mutate the authoritative system merely to make a prototype convenient. When the owner accepts a reusable extension, route the change through **${provider === "codex" ? "$swarmcraft-design mode=extend" : "/design mode=extend"}**, update inventory and stories there, and create a decision record for a public API, dependency, ownership, cross-component, or company-alignment change.
+- Do not mutate the authoritative system merely to make a prototype convenient. When the owner accepts a reusable extension, route the change through **${(0, packet_workflow_1.buildSkillInvocation)(provider, "design") + " mode=extend"}**, update inventory and stories there, and create a decision record for a public API, dependency, ownership, cross-component, or company-alignment change.
 - Never copy disposable prototype HTML, CSS, JavaScript, fixtures, screenshots, or application-specific state into a production design-system package by default. Review and reimplement accepted behavior through the design skill and repository conventions.
 
 ## Build the smallest decision surface
@@ -3256,6 +3304,7 @@ var require_renderReports = __commonJS({
     exports2.listReportingSkillDefinitions = listReportingSkillDefinitions;
     exports2.renderReportSeedFiles = renderReportSeedFiles;
     exports2.renderReportsGuide = renderReportsGuide;
+    var packet_workflow_1 = require_dist();
     var DEFINITIONS = [
       {
         key: "spend-analysis",
@@ -3303,7 +3352,7 @@ var require_renderReports = __commonJS({
       return DEFINITIONS;
     }
     function renderReportSeedFiles(provider) {
-      const skillRoot = provider === "codex" ? ".agents/skills" : ".github/skills";
+      const skillRoot = (0, packet_workflow_1.getProviderSkillRoot)(provider);
       return DEFINITIONS.flatMap((definition) => {
         const root = `${skillRoot}/swarmcraft-${definition.key}`;
         const supportFiles = [
@@ -3353,7 +3402,7 @@ Reports may contain commercially or operationally sensitive derived evidence. Re
 `;
     }
     function renderReportingSkill(definition, provider) {
-      const invocation = provider === "codex" ? `$swarmcraft-${definition.key}` : `/${definition.key}`;
+      const invocation = (0, packet_workflow_1.buildSkillInvocation)(provider, definition.key);
       return `---
 name: swarmcraft-${definition.key}
 description: ${JSON.stringify(definition.description)}
@@ -3631,8 +3680,9 @@ var require_renderPlanning = __commonJS({
     exports2.renderPlanningSeedFiles = renderPlanningSeedFiles;
     exports2.renderPlanContract = renderPlanContract;
     exports2.renderInitiativePlanTemplate = renderInitiativePlanTemplate;
+    var packet_workflow_1 = require_dist();
     function renderPlanningSeedFiles(provider) {
-      const root = `${provider === "codex" ? ".agents/skills" : ".github/skills"}/swarmcraft-plan`;
+      const root = `${(0, packet_workflow_1.getProviderSkillRoot)(provider)}/swarmcraft-plan`;
       return [
         { relativePath: `${root}/references/plan-contract.md`, contents: renderPlanContract() },
         { relativePath: `${root}/assets/initiative-plan-template.md`, contents: renderInitiativePlanTemplate() }
@@ -3952,12 +4002,13 @@ var require_renderDesign = __commonJS({
     exports2.renderBrandAssetsTemplate = renderBrandAssetsTemplate;
     exports2.renderDesignDecisionRecordTemplate = renderDesignDecisionRecordTemplate;
     exports2.renderDesignPrompt = renderDesignPrompt;
+    var packet_workflow_1 = require_dist();
     var designSystemContract_1 = require_designSystemContract();
     exports2.COPILOT_DESIGN_SKILL_PATH = ".github/skills/swarmcraft-design/SKILL.md";
     exports2.COPILOT_DESIGN_PROMPT_PATH = ".github/prompts/design.prompt.md";
     exports2.CODEX_DESIGN_SKILL_PATH = ".agents/skills/swarmcraft-design/SKILL.md";
     function renderDesignSeedFiles(provider) {
-      const root = provider === "copilot" ? ".github/skills/swarmcraft-design" : ".agents/skills/swarmcraft-design";
+      const root = `${(0, packet_workflow_1.getProviderSkillRoot)(provider)}/swarmcraft-design`;
       const files = [
         { relativePath: `${root}/SKILL.md`, contents: renderDesignSkill(provider) },
         { relativePath: `${root}/references/design-system-contract.md`, contents: renderDesignSystemReference() },
@@ -3975,7 +4026,7 @@ var require_renderDesign = __commonJS({
       return files;
     }
     function renderDesignSkill(provider) {
-      const invocation = provider === "codex" ? "$swarmcraft-design" : "/design";
+      const invocation = (0, packet_workflow_1.buildSkillInvocation)(provider, "design");
       return `---
 name: swarmcraft-design
 description: Establish, extend, adopt, or read-only assess a mature company-specific design system with official identity, comprehensive foundations, product-neutral components, patterns, a reusable implementation boundary, and a Storybook or repository-native workbench.
@@ -4226,6 +4277,9 @@ var require_seedProjectContext = __commonJS({
     exports2.buildStaticProjectSeedFiles = buildStaticProjectSeedFiles;
     exports2.buildDynamicProjectSeedFiles = buildDynamicProjectSeedFiles;
     exports2.buildProjectSeedFiles = buildProjectSeedFiles;
+    var packet_workflow_1 = require_dist();
+    var renderAssistantActionSkills_1 = require_renderAssistantActionSkills();
+    var renderClaudeGuidance_1 = require_renderClaudeGuidance();
     var projectEnvironmentContract_1 = require_projectEnvironmentContract();
     var renderCopilotAgents_1 = require_renderCopilotAgents();
     var renderCodexAgents_1 = require_renderCodexAgents();
@@ -4326,7 +4380,10 @@ var require_seedProjectContext = __commonJS({
       ];
       return [
         ...sharedFiles,
-        ...provider === "copilot" ? copilotFiles : codexFiles,
+        ...provider === "claude" ? [
+          { relativePath: "CLAUDE.md", contents: (0, renderClaudeGuidance_1.renderClaudeGuidance)() },
+          ...packet_workflow_1.SWARMCRAFT_ASSISTANT_ACTIONS.map((action) => ({ relativePath: action.claudeSkillPath, contents: (0, renderAssistantActionSkills_1.renderSwarmCraftActionSkillFile)(action.key) }))
+        ] : provider === "copilot" ? copilotFiles : codexFiles,
         ...(0, renderPlanning_1.renderPlanningSeedFiles)(provider),
         ...(0, renderReports_1.renderReportSeedFiles)(provider),
         ...(0, renderPrototype_1.renderPrototypeSeedFiles)(provider),
@@ -6543,7 +6600,7 @@ var require_seedProjectFiles = __commonJS({
     var seedOperationProject_1 = require_seedOperationProject();
     exports2.ROOT_AGENTS_FILE_PATH = "AGENTS.md";
     exports2.PROJECT_SEED_STATE_PATH = ".swarmcraft/project.seed-state.json";
-    exports2.PROJECT_TEMPLATE_SET_VERSION = 7;
+    exports2.PROJECT_TEMPLATE_SET_VERSION = 8;
     async function seedProjectFiles2(project, provider, dependencies, options = {}) {
       const desired = [
         ...classifyFiles((0, seedProjectContext_1.buildDynamicProjectSeedFiles)(project), "dynamic", provider),
@@ -6564,7 +6621,7 @@ var require_seedProjectFiles = __commonJS({
       return files.map((file) => ({
         ...file,
         scope,
-        ownership: file.relativePath === renderReports_1.REPORTS_README_PATH || file.relativePath === projectEnvironmentContract_1.PROJECT_ENVIRONMENT_PATH || file.relativePath === projectEnvironmentContract_1.VSCODE_EXTENSIONS_PATH ? "CREATE_ONCE_HUMAN" : "GENERATED_MANAGED",
+        ownership: file.relativePath === "CLAUDE.md" || file.relativePath === renderReports_1.REPORTS_README_PATH || file.relativePath === projectEnvironmentContract_1.PROJECT_ENVIRONMENT_PATH || file.relativePath === projectEnvironmentContract_1.VSCODE_EXTENSIONS_PATH ? "CREATE_ONCE_HUMAN" : "GENERATED_MANAGED",
         ...isProviderPath(file.relativePath) ? { provider } : {}
       }));
     }
@@ -6703,7 +6760,7 @@ var require_seedProjectFiles = __commonJS({
       };
     }
     function isProviderPath(relativePath) {
-      return relativePath.startsWith(".github/") || relativePath.startsWith(".agents/") || relativePath.startsWith(".codex/");
+      return relativePath.startsWith(".claude/skills/") || relativePath.startsWith(".github/") || relativePath.startsWith(".agents/") || relativePath.startsWith(".codex/");
     }
     function digest(contents) {
       return (0, node_crypto_1.createHash)("sha256").update(contents, "utf8").digest("hex");
@@ -64900,11 +64957,12 @@ var require_renderDiscovery = __commonJS({
     exports2.renderCuratedDiscoveryDocument = renderCuratedDiscoveryDocument;
     exports2.renderSourceGuide = renderSourceGuide;
     exports2.renderDiscoveryRootSection = renderDiscoveryRootSection;
+    var packet_workflow_1 = require_dist();
     var accounting_discovery_1 = require_dist3();
     exports2.DISCOVERY_MANAGED_SECTION_START = "<!-- BEGIN SWARMCRAFT DISCOVERY MANAGED SECTION -->";
     exports2.DISCOVERY_MANAGED_SECTION_END = "<!-- END SWARMCRAFT DISCOVERY MANAGED SECTION -->";
     function renderDiscoverySkill(provider) {
-      const invocation = provider === "codex" ? "$swarmcraft-discover" : "/discover";
+      const invocation = (0, packet_workflow_1.buildSkillInvocation)(provider, "discover");
       return `---
 name: swarmcraft-discover
 description: Guide recommendation-led, prototype-first, owner-reviewed discovery before a SwarmCraft project exists.
@@ -65027,7 +65085,7 @@ Treat the nine curated documents as one coverage map, not nine consecutive inter
 - Reuse the owner's brand, terminology, product shape, and operating context when supported by that research. Do not treat public positioning as unquestioned operational truth.
 - When an owner-authorized company source exposes official first-party identity, let design establishment locate, safely adopt, provenance-record, and demonstrate it before the first branded prototype. Do not add a logo questionnaire, fabricate a substitute, hotlink the source, or treat nearby partner, client, accreditation, certification, or supplier marks as company identity.
 - Before the first material branded prototype, classify interface relevance as **MATERIAL_INTERFACE** or **NON_MATERIAL_INTERFACE**, then classify the design context as **AUTHORITATIVE_COMPANY_SYSTEM**, **EXTENSIBLE_EXISTING_SYSTEM**, **BRAND_EVIDENCE_WITHOUT_USABLE_SYSTEM**, **NO_MEANINGFUL_FOUNDATION**, or **UNRESOLVED**. Inspect and validate \`.swarmcraft/design-system.json\` when present. Record evidence, inaccessible context, and the classification in **experience-and-interface.md** and **sources/owner-interview.md**.
-- For **MATERIAL_INTERFACE** with an authoritative or extensible system, resolve and reuse it. For brand evidence without a usable system or no meaningful foundation, invoke **${provider === "codex" ? "$swarmcraft-design mode=establish" : "/design mode=establish"}** before the first material branded prototype. Establish a mature company-specific initial system broad enough for the discovered product, its prototypes, and later implementation. Preserve a compatible established framework and package manager; when none exists for material greenfield web work, use the design skill's pnpm, React, TypeScript, Vite, \`packages/design-system\`, and \`apps/design-system\` default. Do not ask the owner to choose framework, component families, package topology, or Storybook configuration unless evidence reveals a material incompatibility. Let the design skill apply its baseline internally; do not ask the owner to select or approve component categories.
+- For **MATERIAL_INTERFACE** with an authoritative or extensible system, resolve and reuse it. For brand evidence without a usable system or no meaningful foundation, invoke **${(0, packet_workflow_1.buildSkillInvocation)(provider, "design") + " mode=establish"}** before the first material branded prototype. Establish a mature company-specific initial system broad enough for the discovered product, its prototypes, and later implementation. Preserve a compatible established framework and package manager; when none exists for material greenfield web work, use the design skill's pnpm, React, TypeScript, Vite, \`packages/design-system\`, and \`apps/design-system\` default. Do not ask the owner to choose framework, component families, package topology, or Storybook configuration unless evidence reveals a material incompatibility. Let the design skill apply its baseline internally; do not ask the owner to select or approve component categories.
 - Do not establish a design system for backend-only, infrastructure-only, routine integration, non-interface, or otherwise immaterial work. An explicit deferral or unresolved technology-dependent implementation detail may preserve discovery completion when the proposed workflow remains coherent; record why establishment is not material or what later decision owns it. Never disguise a material company-language decision as a technical deferral.
 - Before marking an initial direction reviewed, present the integrated design system through official identity and its provenance, company fit, proposed adaptations, typography, density, layout rhythm, action hierarchy, content voice, accessibility, and representative composed workflows for owner correction by exception. Keep official identity separate from adapted styling and new proposals. Ask a targeted question only when a material company-language decision cannot be responsibly recommended from available evidence. Record accepted conclusions in **experience-and-interface.md**. Keep the implementation, workbench, inventory, locator, stories, identity files, and prototype assets as local repository artifacts; they do not enter the text-only Discovery Package unless separately selected as supported text evidence.
 - In **goals-and-success.md**, propose a short plain-language **projectTitle** in frontmatter and include it in whole-document review. Do not use a digest, workspace folder, or generic "Deep Discovery project" label as the owner-facing name.
@@ -65035,9 +65093,9 @@ Treat the nine curated documents as one coverage map, not nine consecutive inter
 - Draft a coherent proposed understanding across goals, roles, workflows, records and rules, integrations, experience, quality and operations, risks and decisions, and acceptance. Present the recommended direction in concise owner language, with alternatives only where a material fork exists.
 - Before fixing the target shape, reconcile a product-disposition matrix across **goals-and-success.md**, **domain-data-and-rules.md**, **integrations-and-boundaries.md**, and **decisions-risks-and-open-questions.md**. Distinguish owner-confirmed dispositions from recommendations and unresolved choices. If an undecided product could materially change whether the outcome is orchestration, selective replacement, consolidation, or staged transition, ask one grouped exception question and keep affected documents out of **REVIEWED** until answered.
 - Do the initial thinking for the owner. Ask what is incorrect, missing, unsafe, or materially different rather than asking the owner to originate every role, rule, status, exception, or measure.
-- For **Recommend, then refine**, invoke **${provider === "codex" ? "$swarmcraft-prototype" : "/prototype"}** after the initial synthesis and no more than one focused clarification round. Start with the smallest useful branded flow that exposes the primary workflow and its important authority, safety, failure, or recovery decision. Balanced and detail-first discovery may resolve more high-impact boundaries first, but must not revert to a document-by-document questionnaire.
+- For **Recommend, then refine**, invoke **${(0, packet_workflow_1.buildSkillInvocation)(provider, "prototype")}** after the initial synthesis and no more than one focused clarification round. Start with the smallest useful branded flow that exposes the primary workflow and its important authority, safety, failure, or recovery decision. Balanced and detail-first discovery may resolve more high-impact boundaries first, but must not revert to a document-by-document questionnaire.
 - After each prototype review, perform a prototype-coverage check across independently meaningful user or operator journeys, materially different roles and authority boundaries, consequential safety or payment decisions, exception and recovery paths, offline or degraded operation, and interaction-heavy integration failures. Do not proceed to consolidation merely because one prototype exists.
-- Extend the current prototype when remaining scenarios share the same product shell, actors, interaction model, and decision context. Invoke **${provider === "codex" ? "$swarmcraft-prototype" : "/prototype"}** again to create another focused prototype when combining a distinct role, operating context, workflow, or recovery model would obscure the decisions being reviewed. Preserve and link every reviewed prototype.
+- Extend the current prototype when remaining scenarios share the same product shell, actors, interaction model, and decision context. Invoke **${(0, packet_workflow_1.buildSkillInvocation)(provider, "prototype")}** again to create another focused prototype when combining a distinct role, operating context, workflow, or recovery model would obscure the decisions being reviewed. Preserve and link every reviewed prototype.
 - Use no fixed prototype count. Stop when material interaction uncertainty is experienceable and owner-corrected, already clear from evidence and prose, or explicitly recorded as delivery-stage validation because a disposable prototype cannot resolve it. Do not prototype routine screens or implementation detail merely for completeness.
 - Before Stage 4, record a concise prototype-coverage summary in **sources/owner-interview.md** and affected curated documents: each prototype path and decision scope, important scenarios covered, material areas intentionally handled in prose, deferred validation with rationale, and why the combined evidence is sufficient for discovery. A material gap that could change what is built remains discovery work.
 - Ask follow-up questions only for owner corrections, contradictions, genuine blockers, or high-impact safety, security, privacy, authority, payment, compliance, destructive migration, and observable acceptance boundaries. Group related questions and do not ask what the evidence or accepted proposal already answers.
@@ -65095,7 +65153,7 @@ These files are the owner-and-agent working surface before SwarmCraft creates a
 
 ## Start here
 
-1. Paste the command for the **AI provider** shown in the SwarmCraft sidebar into chat and send it: Codex uses \`$swarmcraft-discover\`; Copilot uses \`/discover\`. The discovery assistant will inspect the current workspace state and begin at the right stage.
+1. Paste the command for the **AI provider** shown in the SwarmCraft sidebar into chat and send it: Codex uses \`$swarmcraft-discover\`; Copilot uses \`/discover\`; Claude Code uses \`/swarmcraft-discover\`. The discovery assistant will inspect the current workspace state and begin at the right stage.
 2. After that, use the first action shown beneath **Deep Discovery** in the SwarmCraft sidebar whenever you want to continue. It is the context-sensitive next step: click it to open the right local guidance or workflow action. When the row is **Continue Discovery with AI**, SwarmCraft also copies the next provider instruction so you can paste it into chat.
 
 ## Journey
@@ -65200,12 +65258,14 @@ var require_seedDiscoveryFiles = __commonJS({
     exports2.DISCOVERY_SEED_STATE_PATH = exports2.DISCOVERY_SEED_VERSION = void 0;
     exports2.buildDiscoverySeedFiles = buildDiscoverySeedFiles;
     exports2.seedDiscoveryFiles = seedDiscoveryFiles;
+    var packet_workflow_1 = require_dist();
+    var renderClaudeGuidance_1 = require_renderClaudeGuidance();
     var node_crypto_1 = require("node:crypto");
     var renderDiscovery_1 = require_renderDiscovery();
     var renderPrototype_1 = require_renderPrototype();
     var renderDesign_1 = require_renderDesign();
     var renderReports_1 = require_renderReports();
-    exports2.DISCOVERY_SEED_VERSION = 14;
+    exports2.DISCOVERY_SEED_VERSION = 15;
     exports2.DISCOVERY_SEED_STATE_PATH = ".swarmcraft/discovery.seed-state.json";
     var LEGACY_UNCHANGED_DISCOVERY_GUIDE_HASHES = /* @__PURE__ */ new Set([
       "810536d02524e6a11b4b93d1828d5e799380de2619dc481e91c6a02eb487984b",
@@ -65225,22 +65285,16 @@ var require_seedDiscoveryFiles = __commonJS({
       ["acceptance-scenarios.md", "Acceptance scenarios", "Capture observable scenarios, expected evidence, and human-review obligations."]
     ];
     function buildDiscoverySeedFiles(provider) {
-      const providerFiles = provider === "codex" ? [{
-        relativePath: ".agents/skills/swarmcraft-discover/SKILL.md",
-        contents: (0, renderDiscovery_1.renderDiscoverySkill)(provider),
-        ownership: "GENERATED_MANAGED",
-        provider
-      }] : [{
-        relativePath: ".github/skills/swarmcraft-discover/SKILL.md",
+      const providerFiles = [{
+        relativePath: `${(0, packet_workflow_1.getProviderSkillRoot)(provider)}/swarmcraft-discover/SKILL.md`,
         contents: (0, renderDiscovery_1.renderDiscoverySkill)(provider),
         ownership: "GENERATED_MANAGED",
         provider
-      }, {
-        relativePath: ".github/prompts/discover.prompt.md",
-        contents: (0, renderDiscovery_1.renderDiscoveryPrompt)(),
-        ownership: "GENERATED_MANAGED",
-        provider
       }];
+      if (provider === "copilot")
+        providerFiles.push({ relativePath: ".github/prompts/discover.prompt.md", contents: (0, renderDiscovery_1.renderDiscoveryPrompt)(), ownership: "GENERATED_MANAGED", provider });
+      if (provider === "claude")
+        providerFiles.push({ relativePath: "CLAUDE.md", contents: (0, renderClaudeGuidance_1.renderClaudeGuidance)(), ownership: "CREATE_ONCE_HUMAN" });
       const spendFiles = (0, renderReports_1.renderReportSeedFiles)(provider).filter(({ relativePath }) => relativePath.includes("swarmcraft-spend-analysis") || relativePath === ".github/prompts/spend-analysis.prompt.md").map((file) => ({ ...file, ownership: "GENERATED_MANAGED", provider }));
       return [
         { relativePath: "docs/discovery/README.md", contents: (0, renderDiscovery_1.renderDiscoveryGuide)(), ownership: "CREATE_ONCE_HUMAN" },
@@ -65261,6 +65315,10 @@ var require_seedDiscoveryFiles = __commonJS({
     async function seedDiscoveryFiles(provider, dependencies) {
       const result = { written: [], removed: [], conflicts: [] };
       const previous = await readState(dependencies);
+      if (previous?.seedVersion && previous.seedVersion > exports2.DISCOVERY_SEED_VERSION) {
+        result.conflicts.push({ relativePath: exports2.DISCOVERY_SEED_STATE_PATH, reason: "Newer discovery seed version was preserved." });
+        return result;
+      }
       if (previous && previous.provider !== provider)
         await reconcileOldProvider(previous, dependencies, result);
       const files = buildDiscoverySeedFiles(provider);
@@ -65282,7 +65340,7 @@ var require_seedDiscoveryFiles = __commonJS({
         if (exists) {
           const current = await dependencies.readFile(file.relativePath);
           const oldHash = previous?.files[file.relativePath];
-          if (oldHash && hash(current) !== oldHash && current !== file.contents) {
+          if ((!oldHash || hash(current) !== oldHash) && current !== file.contents) {
             result.conflicts.push({ relativePath: file.relativePath, reason: "Owner-edited generated file was preserved." });
             continue;
           }
@@ -65527,6 +65585,7 @@ var require_renderOperation = __commonJS({
     exports2.renderOperationRepositoryFiles = renderOperationRepositoryFiles;
     exports2.renderOperationProviderFiles = renderOperationProviderFiles;
     exports2.renderOperationSkill = renderOperationSkill;
+    var packet_workflow_1 = require_dist();
     var operation_contract_1 = require_dist2();
     var renderOperationAutomate_1 = require_renderOperationAutomate();
     var renderOperationFormalise_1 = require_renderOperationFormalise();
@@ -65598,7 +65657,7 @@ var require_renderOperation = __commonJS({
       ];
     }
     function renderOperationProviderFiles(provider) {
-      const root = provider === "codex" ? ".agents/skills" : ".github/skills";
+      const root = (0, packet_workflow_1.getProviderSkillRoot)(provider);
       const files = exports2.OPERATION_SKILL_NAMES.map((name) => ({
         relativePath: root + "/" + name + "/SKILL.md",
         contents: renderOperationSkill(name, provider)
@@ -65613,8 +65672,8 @@ var require_renderOperation = __commonJS({
     }
     function renderOperationSkill(name, provider) {
       const action = name.slice("swarmcraft-".length);
-      const invocation = provider === "codex" ? "$" + name : "/" + action;
-      const companion = provider === "codex" ? { work: "$swarmcraft-work", automate: "$swarmcraft-automate", formalise: "$swarmcraft-formalise" } : { work: "/work", automate: "/automate", formalise: "/formalise" };
+      const invocation = (0, packet_workflow_1.buildSkillInvocation)(provider, action);
+      const companion = { work: (0, packet_workflow_1.buildSkillInvocation)(provider, "work"), automate: (0, packet_workflow_1.buildSkillInvocation)(provider, "automate"), formalise: (0, packet_workflow_1.buildSkillInvocation)(provider, "formalise") };
       const descriptions = {
         "swarmcraft-work": "Complete useful operational work while progressively maintaining the authoritative operation map.",
         "swarmcraft-automate": "Turn stable bounded work into reviewed local automation with dry runs, tests, and recovery.",
@@ -65732,7 +65791,7 @@ var require_renderOperation = __commonJS({
       return document3("# Operation formalisation", "", "Status: **NOT_STARTED**", "", "This is the plain-language review surface for selecting what may later enter Deep Discovery. Repository presence does not imply consent. Existing authority remains unchanged until an explicit pilot or cutover decision.", "", "Formalise records the bounded capability, actors, outcomes, systems, rules, exceptions, authority, safety constraints, evidence, gaps, candidate cutover, rollback, selected evidence, explicit exclusions, and unresolved decisions here. Its separate digest-bound manifest is the machine-readable consent boundary.");
     }
     function renderOperationRootGuide() {
-      return document3("# SwarmCraft Operate repository", "", "Start with `$swarmcraft-work` in Codex or `/work` in Copilot. Describe one useful outcome and provide one safe representative example; do not begin by designing the model.", "", "SwarmCraft maintains the authoritative technical model from operational meaning you review in plain language. It keeps raw imports, proposals, exports, and run scratch out of Git by default, commits only scoped reviewed authority, and never pushes automatically.");
+      return document3("# SwarmCraft Operate repository", "", "Start with `$swarmcraft-work` in Codex , `/work` in Copilot, or `/swarmcraft-work` in Claude Code. Describe one useful outcome and provide one safe representative example; do not begin by designing the model.", "", "SwarmCraft maintains the authoritative technical model from operational meaning you review in plain language. It keeps raw imports, proposals, exports, and run scratch out of Git by default, commits only scoped reviewed authority, and never pushes automatically.");
     }
     function vocabulary(vocabularyId, valueId, value, label, description) {
       return {
@@ -65765,16 +65824,18 @@ var require_seedOperationFiles = __commonJS({
     exports2.OPERATION_SEED_STATE_PATH = exports2.OPERATION_SEED_VERSION = void 0;
     exports2.buildOperationSeedFiles = buildOperationSeedFiles2;
     exports2.seedOperationFiles = seedOperationFiles2;
+    var renderClaudeGuidance_1 = require_renderClaudeGuidance();
     var node_crypto_1 = require("node:crypto");
     var operation_contract_1 = require_dist2();
     var renderOperation_1 = require_renderOperation();
-    exports2.OPERATION_SEED_VERSION = 4;
+    exports2.OPERATION_SEED_VERSION = 5;
     exports2.OPERATION_SEED_STATE_PATH = ".swarmcraft/operation.seed-state.json";
     function buildOperationSeedFiles2(locatorValue, provider) {
       const locator = (0, operation_contract_1.parseOperationLocator)(locatorValue);
       const files = [
         ...(0, renderOperation_1.renderOperationRepositoryFiles)(locator),
-        ...(0, renderOperation_1.renderOperationProviderFiles)(provider)
+        ...(0, renderOperation_1.renderOperationProviderFiles)(provider),
+        ...provider === "claude" ? [{ relativePath: "CLAUDE.md", contents: (0, renderClaudeGuidance_1.renderClaudeGuidance)() }] : []
       ].map((file) => classifyOperationFile(file, locator, provider));
       const paths = files.map((file) => file.relativePath);
       if (new Set(paths).size !== paths.length) {
@@ -65976,7 +66037,7 @@ var require_seedOperationFiles = __commonJS({
       };
     }
     function isProviderPath(relativePath) {
-      return relativePath.startsWith(".github/") || relativePath.startsWith(".agents/");
+      return relativePath.startsWith(".claude/skills/") || relativePath.startsWith(".github/") || relativePath.startsWith(".agents/");
     }
     function unique(values) {
       return [...new Set(values)].sort();
@@ -66770,7 +66831,7 @@ var import_packet_workflow6 = __toESM(require_dist(), 1);
 // package.json
 var package_default = {
   name: "@swarmcraftai/cli",
-  version: "0.5.0",
+  version: "0.6.0",
   description: "Prepare repositories and run packet-based SwarmCraft agent workflows from the terminal.",
   license: "SEE LICENSE IN LICENSE.txt",
   type: "module",
@@ -67274,8 +67335,8 @@ async function runBootstrap(client, accessToken, options) {
     linkedPackets,
     skippedTasks,
     nextCommands: [
-      `swarmcraft one-shot --project ${project.id} --workspace ${workspace.workspacePath} --agent-provider codex${options.delegationId ? ` --delegation ${options.delegationId}` : ""}`,
-      "Review generated files under .swarmcraft/, .github/, .agents/, and .codex/ before running agents."
+      `swarmcraft one-shot --project ${project.id} --workspace ${workspace.workspacePath} --agent-provider ${options.agentProvider}${options.delegationId ? ` --delegation ${options.delegationId}` : ""}`,
+      "Review generated files under .swarmcraft/, .github/, .agents/, .codex/, .claude/, and CLAUDE.md before running agents."
     ]
   };
 }
@@ -67395,6 +67456,9 @@ async function persistRunManifest(manifestPath, manifest) {
 var import_promises4 = require("node:fs/promises");
 var import_packet_workflow2 = __toESM(require_dist(), 1);
 async function buildAgentEnvironment(options, stageEnv) {
+  if (options.agentProvider === "claude" && (options.agentApiKeyEnvName || options.agentEnvFilePath)) {
+    throw new Error("Claude subscription runs use your local login; provider credential flags are not supported.");
+  }
   const env2 = {
     PATH: process.env.PATH ?? "",
     HOME: process.env.HOME,
@@ -67402,6 +67466,11 @@ async function buildAgentEnvironment(options, stageEnv) {
     TERM: process.env.TERM,
     ...stageEnv
   };
+  if (options.agentProvider === "claude") {
+    for (const name of ["USER", "USERPROFILE", "APPDATA", "LOCALAPPDATA", "SystemRoot", "TEMP", "TMP", "CLAUDE_CONFIG_DIR", "CLAUDE_CODE_GIT_BASH_PATH"]) {
+      if (process.env[name]) env2[name] = process.env[name];
+    }
+  }
   if (options.commitPolicy === "done") {
     env2.SWARMCRAFT_DRIVER_AUTO_COMMIT = "true";
     env2.SWARMCRAFT_CLI_AUTO_COMMIT = "true";
@@ -67455,6 +67524,17 @@ async function readEnvFile(envFilePath) {
 function shellQuote(value) {
   return `'${String(value).replace(/'/g, "'\\''")}'`;
 }
+async function requireClaudeSubscription(cwd, env2, execute = runProcess) {
+  const result = await execute("claude", ["auth", "status"], cwd, { env: env2 });
+  let method;
+  try {
+    method = JSON.parse(result.stdout).authMethod;
+  } catch {
+  }
+  if (result.exitCode !== 0 || method !== "claude.ai") {
+    throw new Error("Claude subscription login is not ready. Install the standalone Claude Code CLI, run claude auth login, and confirm /status uses your Claude subscription. API and third-party authentication are not accepted for --agent-provider claude.");
+  }
+}
 
 // src/workflows/one-shot-board-sync.ts
 var import_packet_workflow3 = __toESM(require_dist(), 1);
@@ -67541,6 +67621,9 @@ async function runOneShot(client, accessTokenProvider, options) {
   if (workspace.dirtyFileCount > 0 && !options.allowDirty) {
     throw new Error(`Workspace has ${workspace.dirtyFileCount} changed file(s). Commit, stash, or rerun with --allow-dirty before one-shot.`);
   }
+  if (options.agentProvider === "claude") {
+    await requireClaudeSubscription(workspace.workspacePath, await buildAgentEnvironment(options, {}));
+  }
   if (options.resumeRunId) {
     printProgress("Resume detected; using existing packet files without re-running bootstrap.");
   } else {
@@ -67550,7 +67633,7 @@ async function runOneShot(client, accessTokenProvider, options) {
       taskIds: options.taskIds,
       taskLimit: options.taskLimit,
       delegationId: options.delegation?.id ?? null,
-      agentProvider: options.agentProvider === "copilot" ? "copilot" : "codex"
+      agentProvider: options.agentProvider === "custom" || options.agentProvider === "managed" ? "codex" : options.agentProvider
     });
   }
   const project = await client.loadProject(options.projectId, await getAccessToken(), options.delegation?.id ?? null);
@@ -67636,7 +67719,16 @@ async function runOneShot(client, accessTokenProvider, options) {
         }
       });
     } catch (failure2) {
-      if (!(failure2 instanceof ManagedAiCreditsExhaustedError)) throw failure2;
+      if (!(failure2 instanceof ManagedAiCreditsExhaustedError)) {
+        if (options.agentProvider === "claude") {
+          taskOutcome.outcome = "blocked-agent-failure";
+          taskOutcome.finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+          taskOutcome.elapsedMs = (0, import_packet_workflow4.computeElapsedMs)(taskOutcome.startedAt, taskOutcome.finishedAt);
+          finalizeManifest(manifest);
+          await persistRunManifest(manifestPath, manifest);
+        }
+        throw failure2;
+      }
       result = { board, task: selectedTask, outcome: "blocked-insufficient-credits" };
       printProgress("Managed AI paused before the next provider call. Add credits, then resume this run.");
     }
@@ -67785,7 +67877,8 @@ async function runStageAndSync(context) {
     await context.getAccessToken()
   ) : null;
   const managedToken = managedStage ? await context.getAccessToken() : null;
-  const execution = await runTrustedShellAgentCommand(command, context.workspacePath, {
+  const executeAgent = context.options.agentProvider === "claude" && !context.options.agentCommand ? (_command, cwd, options) => runProcess("claude", ["--permission-mode", "dontAsk", "-p", stageCommand], cwd, options) : runTrustedShellAgentCommand;
+  const execution = await executeAgent(command, context.workspacePath, {
     env: await buildAgentEnvironment(context.options, {
       SWARMCRAFT_STAGE: context.stage,
       SWARMCRAFT_PACKET: context.packetPath,
@@ -67812,6 +67905,9 @@ ${execution.stdout}`;
     if (context.options.agentProvider === "managed" && (failureOutput.includes("INSUFFICIENT_CREDITS") || failureOutput.toLowerCase().includes("insufficient credits"))) {
       throw new ManagedAiCreditsExhaustedError("Managed AI credits exhausted.");
     }
+    if (context.options.agentProvider === "claude") {
+      throw new Error(`Claude failed during ${context.stage}. Check subscription availability and configured tool permissions, then resume the run. No API fallback was attempted.`);
+    }
     throw new Error(`Agent command failed during ${context.stage}: ${execution.stderr || execution.stdout || command}`);
   }
   const allowLaneSync = context.options.checking || context.stage !== "do";
@@ -68724,7 +68820,7 @@ var import_packet_workflow5 = __toESM(require_dist(), 1);
 var COMMANDS = [
   {
     name: "operate init",
-    usage: "swarmcraft operate init --workspace <path> --agent-provider codex|copilot [--adopt] [--json] [--client-surface cli|vscode-extension] [--session-stdin]",
+    usage: "swarmcraft operate init --workspace <path> --agent-provider codex|copilot|claude [--adopt] [--json] [--client-surface cli|vscode-extension] [--session-stdin]",
     summary: "Sign in, initialize or reconcile local Operate skills, and report content-free activity.",
     implemented: true
   },
@@ -68784,7 +68880,7 @@ var COMMANDS = [
   },
   {
     name: "init",
-    usage: "swarmcraft init --project <project-id> --workspace <path> --agent-provider codex|copilot [--task <task-id>] [--task-limit <n|all>] [--delegation <id>]",
+    usage: "swarmcraft init --project <project-id> --workspace <path> --agent-provider codex|copilot|claude [--task <task-id>] [--task-limit <n|all>] [--delegation <id>]",
     summary: "Prepare a repository with SwarmCraft packet and agent guidance files.",
     implemented: true
   },
@@ -68808,7 +68904,7 @@ var COMMANDS = [
   },
   {
     name: "doctor",
-    usage: "swarmcraft doctor [--workspace <path>] [--agent-provider codex|copilot|custom] [--delegation <id>]",
+    usage: "swarmcraft doctor [--workspace <path>] [--agent-provider codex|copilot|claude|custom] [--delegation <id>]",
     summary: "Check local auth, API, git, workspace, runtime, and agent prerequisites.",
     implemented: true
   },
@@ -69031,7 +69127,8 @@ async function initializeOperation(options, deps) {
   const before = /* @__PURE__ */ new Map();
   const owned = new Set([
     ...(0, import_repo_seed3.buildOperationSeedFiles)(locator, "codex"),
-    ...(0, import_repo_seed3.buildOperationSeedFiles)(locator, "copilot")
+    ...(0, import_repo_seed3.buildOperationSeedFiles)(locator, "copilot"),
+    ...(0, import_repo_seed3.buildOperationSeedFiles)(locator, "claude")
   ].map((file) => file.relativePath));
   owned.add(".swarmcraft/operation.seed-state.json");
   const requireOwned = (file) => {
@@ -69106,7 +69203,7 @@ async function initializeOperation(options, deps) {
         activity,
         occurrenceId: state.occurrenceId,
         clientSurface: options.clientSurface ?? "CLI",
-        providerKind: options.provider === "codex" ? "CODEX" : "COPILOT",
+        providerKind: { codex: "CODEX", copilot: "COPILOT", claude: "CLAUDE" }[options.provider],
         contractVersion: import_operation_contract3.OPERATION_CONTRACT_VERSION,
         seedVersion: import_repo_seed3.OPERATION_SEED_VERSION,
         repositoryKind: state.repositoryKind
@@ -69253,10 +69350,10 @@ async function runOperateCommand(parsed, action, version2) {
     let result;
     if (action === "init") {
       const provider = requireOption(parsed, "agent-provider");
-      if (provider !== "codex" && provider !== "copilot") throw new OperateCommandError(
+      if (provider !== "codex" && provider !== "copilot" && provider !== "claude") throw new OperateCommandError(
         "OPERATE_PROVIDER_INVALID",
         4,
-        "Select --agent-provider codex or copilot."
+        "Select --agent-provider codex, copilot, or claude."
       );
       const surface = getOption(parsed, "client-surface") ?? "cli";
       if (surface !== "cli" && surface !== "vscode-extension") throw new OperateCommandError(
@@ -69450,7 +69547,7 @@ async function runInit(parsed) {
     taskIds: getOptions(parsed, "task"),
     taskLimit,
     delegationId: delegation?.id ?? null,
-    agentProvider: parseChoice(requireOption(parsed, "agent-provider"), ["codex", "copilot"], "--agent-provider")
+    agentProvider: parseChoice(requireOption(parsed, "agent-provider"), ["codex", "copilot", "claude"], "--agent-provider")
   });
   printBootstrapSummary(summary);
 }
@@ -69532,8 +69629,8 @@ async function runDoctor(parsed) {
   }
   const provider = getOption(parsed, "agent-provider");
   if (provider && provider !== "custom") {
-    const commandName = provider === "codex" ? "codex" : "copilot";
-    const result = await runProcess("which", [commandName], process.cwd());
+    const commandName = (0, import_packet_workflow6.parseExternalAgentProvider)(provider);
+    const result = await runProcess(process.platform === "win32" ? "where.exe" : "which", [commandName], process.cwd());
     console.log(`${commandName}: ${result.exitCode === 0 ? result.stdout.trim() : "not found"}`);
   }
 }