@structured-vibe-coding/core 0.3.0 → 0.4.0

package/dist/agents-2ONGBIGG.js

@@ -0,0 +1,20 @@
+import {
+  AGENT_TARGET_OPTIONS,
+  ALL_AGENT_TARGETS,
+  PROTOCOL_MD,
+  SDD_AGENT_ROLES,
+  installAgentIntegrations,
+  parseAgentTargets,
+  refreshActiveAgentContext,
+  renderThinAgent
+} from "./chunk-BP54LEAD.js";
+export {
+  AGENT_TARGET_OPTIONS,
+  ALL_AGENT_TARGETS,
+  PROTOCOL_MD,
+  SDD_AGENT_ROLES,
+  installAgentIntegrations,
+  parseAgentTargets,
+  refreshActiveAgentContext,
+  renderThinAgent
+};

package/dist/{chunk-PT2BZ23N.js → chunk-BP54LEAD.js}

@@ -518,7 +518,7 @@ async function createChange(input) {
   await materializeStageArtifacts(projectRoot, config, id, workflow, meta, firstStage);
   await setActiveChange(projectRoot, config, id);
   try {
-    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-7PTSPJFQ.js");
+    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-2ONGBIGG.js");
     await refreshActiveAgentContext2(projectRoot);
   } catch {
   }
@@ -738,7 +738,7 @@ async function advanceStage(projectRoot, config, changeId, opts) {
     stage
   );
   try {
-    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-7PTSPJFQ.js");
+    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-2ONGBIGG.js");
     await refreshActiveAgentContext2(projectRoot);
   } catch {
   }
@@ -961,8 +961,83 @@ async function buildAgentPrompt(ctx, config, projectRoot) {
 
 // src/agents.ts
 var ALL_AGENT_TARGETS = ["copilot", "claude-code", "intellij"];
+var AGENT_TARGET_OPTIONS = [
+  {
+    id: "copilot",
+    label: "GitHub Copilot",
+    hint: ".github/agents/*.agent.md"
+  },
+  {
+    id: "claude-code",
+    label: "Claude Code",
+    hint: ".claude/agents/*.md"
+  },
+  {
+    id: "intellij",
+    label: "IntelliJ / JetBrains",
+    hint: ".idea/sdd-agent-notes.md"
+  }
+];
+function parseAgentTargets(raw) {
+  const parts = (Array.isArray(raw) ? raw : [raw]).flatMap((s) => String(s).split(",")).map((s) => s.trim().toLowerCase()).filter(Boolean);
+  const out = [];
+  for (const p of parts) {
+    const id = p === "claude" || p === "claude-code" || p === "claudecode" ? "claude-code" : p === "github-copilot" || p === "gh-copilot" || p === "copilot" ? "copilot" : p === "jetbrains" || p === "idea" || p === "intellij" ? "intellij" : p;
+    if (!ALL_AGENT_TARGETS.includes(id)) {
+      throw new Error(
+        `Unknown agent platform "${p}". Choose one of: ${ALL_AGENT_TARGETS.join(", ")}`
+      );
+    }
+    if (!out.includes(id)) out.push(id);
+  }
+  return out;
+}
+var SDD_AGENT_ROLES = [
+  {
+    id: "sdd",
+    description: "Default SDD agent. Use for any Spec-Driven Development work on the active change pack.",
+    roleLine: "Router: inspect stage in active-context; plan or implement accordingly.",
+    roleRules: [
+      "If stage is intent/feature/design/tasks/stories/research: act as planner (artifacts, little or no product code).",
+      "If stage is implement: act as implementer (scoped code only).",
+      "If stage is local_verify: act as reviewer (gaps vs acceptance; fixes only)."
+    ]
+  },
+  {
+    id: "sdd-planner",
+    description: "SDD planner. Use when filling intent, design, research, stories, or tasks \u2014 not large code changes.",
+    roleLine: "Planner: produce/update stage markdown only.",
+    roleRules: [
+      "Do not make large product code changes unless the user explicitly overrides.",
+      "Keep artifacts short and actionable."
+    ]
+  },
+  {
+    id: "sdd-implementer",
+    description: "SDD implementer. Use when coding the active change (implement stage).",
+    roleLine: "Implementer: code only for the active change pack.",
+    roleRules: [
+      "Follow tasks.md / acceptance; honor arb-decision and design constraints.",
+      "Do not expand scope beyond the change title/intent."
+    ]
+  },
+  {
+    id: "sdd-reviewer",
+    description: "SDD reviewer. Use before verify/complete or to check work against the change pack.",
+    roleLine: "Reviewer: compare work to acceptance and stage artifacts.",
+    roleRules: [
+      "List gaps; suggest minimal fixes only.",
+      "Remind user to run sdd verify before sdd complete."
+    ]
+  }
+];
 async function installAgentIntegrations(opts) {
-  const targets = opts.targets?.length ? opts.targets : ALL_AGENT_TARGETS;
+  if (!opts.targets?.length) {
+    throw new Error(
+      `Specify at least one agent platform: ${ALL_AGENT_TARGETS.join(", ")} (do not install all by default)`
+    );
+  }
+  const targets = opts.targets;
   const created = [];
   const skipped = [];
   const root = opts.projectRoot;
@@ -976,36 +1051,34 @@ async function installAgentIntegrations(opts) {
     await writeText(full, content);
     created.push(rel);
   };
+  await write(join4(".sdd", "protocol.md"), PROTOCOL_MD);
   await refreshActiveAgentContext(root);
-  if (targets.includes("copilot")) {
-    await write(
-      ".github/copilot-instructions.md",
-      COPILOT_INSTRUCTIONS
-    );
-    await write(
-      ".github/agents/sdd.agent.md",
-      COPILOT_SDD_AGENT
-    );
-    await write(
-      ".github/instructions/sdd.instructions.md",
-      COPILOT_PATH_INSTRUCTIONS
-    );
-  }
-  if (targets.includes("claude-code")) {
-    await write(".claude/skills/sdd/SKILL.md", CLAUDE_SDD_SKILL);
-    await write(".claude/CLAUDE.md", CLAUDE_PROJECT_MD);
+  if (targets.includes("copilot") || targets.includes("claude-code")) {
+    for (const role of SDD_AGENT_ROLES) {
+      const body = renderThinAgent(role);
+      if (targets.includes("claude-code")) {
+        await write(`.claude/agents/${role.id}.md`, body);
+      }
+      if (targets.includes("copilot")) {
+        await write(`.github/agents/${role.id}.agent.md`, body);
+      }
+    }
   }
   if (targets.includes("intellij")) {
     await write(".idea/sdd-agent-notes.md", INTELLIJ_NOTES);
-    await write("AGENTS.md", AGENTS_MD);
-  } else if (targets.includes("copilot") || targets.includes("claude-code")) {
-    await write("AGENTS.md", AGENTS_MD);
+  }
+  if (targets.includes("copilot") || targets.includes("claude-code") || targets.includes("intellij")) {
+    await write("AGENTS.md", AGENTS_MD_THIN);
   }
   await write(
     join4(".sdd", "agents.json"),
     JSON.stringify(
       {
-        version: 1,
+        version: 2,
+        mode: "agents-only",
+        protocol: ".sdd/protocol.md",
+        activeContext: ".sdd/active-context.md",
+        roles: SDD_AGENT_ROLES.map((r) => r.id),
         installed: targets,
         updated: (/* @__PURE__ */ new Date()).toISOString()
       },
@@ -1015,11 +1088,42 @@ async function installAgentIntegrations(opts) {
   );
   return { created, skipped, targets };
 }
+function renderThinAgent(role) {
+  const rules = role.roleRules.map((r) => `- ${r}`).join("\n");
+  return `---
+name: ${role.id}
+description: ${role.description}
+---
+
+# ${role.id}
+
+${role.roleLine}
+
+## Required reads (in order)
+
+1. \`.sdd/active-context.md\` \u2014 current change and stage
+2. \`.sdd/protocol.md\` \u2014 SDD rules for this repo (single playbook)
+3. Active change files under \`changes/<id>/\` as listed in active-context
+
+## Role rules
+
+${rules}
+
+## Done
+
+Remind the human: \`sdd verify\` then \`sdd next\` / \`sdd complete\` as appropriate.
+Do not claim the change is complete without local verification when the workflow requires it.
+`;
+}
 async function refreshActiveAgentContext(projectRoot) {
   const markerDir = sddRoot(projectRoot);
   if (!await pathExists(join4(markerDir, "config.yaml"))) {
     return null;
   }
+  const protocolPath = join4(markerDir, "protocol.md");
+  if (!await pathExists(protocolPath)) {
+    await writeText(protocolPath, PROTOCOL_MD);
+  }
   const config = await loadConfig(projectRoot);
   const activeId = await getActiveChangeId(projectRoot, config);
   const outPath = join4(markerDir, "active-context.md");
@@ -1029,6 +1133,8 @@ async function refreshActiveAgentContext(projectRoot) {
 _No active change._ Run \`sdd new "\u2026"\` or **SDD: New Change** in the IDE.
 
 Then re-run \`sdd agents refresh\` (or advance a stage) to update this file.
+
+Protocol: \`.sdd/protocol.md\`
 `;
     await writeText(outPath, empty);
     return outPath;
@@ -1038,8 +1144,9 @@ Then re-run \`sdd agents refresh\` (or advance a stage) to update this file.
   const status = formatStatus(ctx);
   const body = `# SDD active context
 
-> Auto-generated for GitHub Copilot, Claude Code, and IDE agents.  
-> Change: **${ctx.meta.title}** \xB7 \`${ctx.id}\` \xB7 stage **${ctx.meta.stage}**
+> Auto-generated for coding agents.  
+> Change: **${ctx.meta.title}** \xB7 \`${ctx.id}\` \xB7 stage **${ctx.meta.stage}**  
+> Protocol: \`.sdd/protocol.md\`
 
 ## Status
 
@@ -1052,191 +1159,85 @@ ${handoff}
   await writeText(outPath, body);
   return outPath;
 }
-var AGENTS_MD = `# Agent instructions \u2014 Structured Vibe Coding (SDD)
-
-This repository uses **Spec-Driven Development** via the \`sdd\` tool (CLI / VS Code / IntelliJ).
+var PROTOCOL_MD = `# SDD protocol
 
-## Always
+This repo uses **Structured Vibe Coding** (\`sdd\`). Agents must follow this file plus \`.sdd/active-context.md\`. Do not invent a parallel process.
 
-1. Prefer the **active change pack** under \`changes/<id>/\` as the source of truth for the current task.
-2. Read \`.sdd/active-context.md\` at the start of a coding session (refresh with \`sdd agents refresh\`).
-3. Read \`memory/\` for product and architecture constraints.
-4. Do **not** invent large features outside the current change intent.
-5. Respect **ARB / gate decisions** (e.g. \`arb-decision.md\`) and workflow constraints.
-6. When implementation is done, remind the human to run **local verify** (\`sdd verify\`) before \`sdd complete\`.
+## Source of truth
 
-## Workflows
+| What | Where |
+|------|--------|
+| Process state | \`changes/<id>/meta.yaml\` (workflow, stage, gates) |
+| Current task snapshot | \`.sdd/active-context.md\` |
+| Stable product/tech rules | \`memory/*.md\` |
+| Stage artifacts | files in \`changes/<id>/\` for the active change |
 
-Process is defined in \`.sdd/workflows/*.yaml\`. Stages produce markdown artifacts in the change folder. Do not skip hard gates.
+## Required read order
 
-## Tools
-
-| Surface | How |
-|---------|-----|
-| CLI | \`sdd status\`, \`sdd next\`, \`sdd agent\`, \`sdd verify\` |
-| VS Code / Cursor | Command Palette \u2192 **SDD:*** |
-| IntelliJ | Tools \u2192 **SDD** actions (runs CLI) |
-| GitHub Copilot | \`.github/copilot-instructions.md\` + agent \`sdd\` |
-| Claude Code | \`.claude/skills/sdd/SKILL.md\` |
-
-## Local only
-
-Verification is **local development**. Do not assume CI replaced \`sdd verify\`.
-`;
-var COPILOT_INSTRUCTIONS = `<!-- Structured Vibe Coding (SDD) \u2014 GitHub Copilot instructions -->
-
-# Project coding agent rules
-
-This repo uses **Spec-Driven Development (SDD)** with the \`sdd\` CLI / IDE plugins.
-
-## Before writing code
-
-1. Open and follow \`.sdd/active-context.md\` if present.
-2. Open the active change under \`changes/\` (see \`changes/.active\` or the latest in-progress folder).
-3. Prefer artifacts for the **current stage** (intent/feature/design/tasks) over guessing.
-4. Honor \`memory/product.md\`, \`memory/architecture.md\`, \`memory/conventions.md\`.
+1. \`.sdd/active-context.md\`
+2. This file (\`.sdd/protocol.md\`)
+3. \`meta.yaml\` + artifacts for the **current stage** (and prior stages if needed)
+4. \`memory/\` when architecture or conventions matter
 
-## While coding
+## Stage behavior
 
-- Stay within the change scope (title + intent/feature).
-- Match patterns described in \`research.md\` / design when present.
-- Do not violate constraints in \`arb-decision.md\` or gate notes.
-- Prefer small, reviewable diffs.
+| Stage kind | Agent focus |
+|------------|-------------|
+| intent / feature / stories | Clarify scope; write short artifacts |
+| design / lld / db / research / hl_arb | Specs and decisions; minimal product code |
+| tasks | Break work into implementable checklist |
+| implement | Code only for this change; follow tasks/acceptance |
+| local_verify | Check acceptance; fix only; prepare for complete |
 
-## When finishing
+## Hard rules
 
-- Suggest \`sdd verify\` (local) and only then \`sdd complete\`.
-- Do not claim the change is complete without local verification when the workflow has a verify stage.
+1. **Do not skip hard gates.** If blocked, tell the human to run \`sdd gate approve\` (or fix the gate).
+2. **Stay in scope** of the active change title/intent. No drive-by refactors or new features.
+3. **Honor constraints** in \`arb-decision.md\`, design, and memory non-negotiables.
+4. **Local verify** is part of done when the workflow has a verify stage: \`sdd verify\`.
+5. Prefer small, reviewable diffs.
 
-## Commands the human may run
+## Commands (human / shell)
 
 \`\`\`bash
 sdd status
 sdd next
-sdd agent          # print handoff
-sdd agents refresh # refresh .sdd/active-context.md
+sdd agent              # print handoff
+sdd agents refresh     # refresh active-context.md
 sdd verify
 sdd complete
 \`\`\`
-`;
-var COPILOT_SDD_AGENT = `---
-name: sdd
-description: Spec-Driven Development agent for this repo. Use when implementing the active sdd change, advancing stages, or following .sdd workflows.
----
-
-# SDD agent (GitHub Copilot)
-
-You are the **SDD implementer** for this workspace.
-
-## Mission
-
-Implement only what the **active change pack** specifies. Specs and gates win over improvisation.
-
-## Required reads (in order)
-
-1. \`.sdd/active-context.md\`
-2. \`changes/<active-id>/meta.yaml\` (workflow + stage)
-3. Artifacts for the current stage and prior stages in that folder
-4. \`memory/*.md\`
-
-## Behavior
-
-- If there is no active change, tell the user to run \`sdd new "\u2026"\` or **SDD: New Change**.
-- If \`meta.yaml\` stage is not \`implement\`, help fill the current stage artifact instead of large code rewrites\u2014unless the user explicitly wants implementation early.
-- On implement stage: execute tasks from \`tasks.md\` / acceptance criteria; keep diffs scoped.
-- After code changes: remind them to run **local** \`sdd verify\`.
 
-## Out of scope
+## Out of scope for agents
 
-- Redesigning the whole product
-- Skipping hard gates
-- Inventing requirements not in the change pack
+- Replacing CI/CD or team process tools
+- Deleting \`.sdd\` / archive history
+- Claiming complete without verify when required
 `;
-var COPILOT_PATH_INSTRUCTIONS = `---
-applyTo: "changes/**,memory/**,.sdd/**"
----
-
-# SDD paths
-
-Files under \`changes/\`, \`memory/\`, and \`.sdd/\` drive Spec-Driven Development.
-
-- Treat \`changes/**/meta.yaml\` as process state (do not invent fields).
-- Prefer editing stage artifacts over deleting workflow history.
-- When modifying code for an active change, keep alignment with that change's intent/design/tasks.
-`;
-var CLAUDE_SDD_SKILL = `---
-name: sdd
-description: Use Spec-Driven Development (sdd) for this repository \u2014 read active change, follow stages, implement within scope, local verify.
----
-
-# Skill: Structured Vibe Coding (SDD)
-
-## When to use
+var AGENTS_MD_THIN = `# Agents
 
-- User asks to implement a feature/fix in this repo
-- User mentions sdd, change packs, stages, ARB, or local verify
-- You need the source of truth for the current task
+This repo uses **SDD agents only** (no skills).
 
-## Instructions
+| Read first | |
+|------------|--|
+| Live task | \`.sdd/active-context.md\` |
+| Playbook | \`.sdd/protocol.md\` |
 
-1. Read \`.sdd/active-context.md\` (if missing, run \`sdd agents refresh\` via bash or ask the user).
-2. Read \`changes/<id>/meta.yaml\` for \`workflow\` and \`stage\`.
-3. Read relevant artifacts in that change folder (intent/feature/design/tasks/acceptance).
-4. Read \`memory/\` for global constraints.
-5. Implement **only** in-scope work for the current change.
-6. Prefer project conventions in \`memory/conventions.md\`.
-7. When done coding, instruct the user to run:
+| Host | Agents |
+|------|--------|
+| Claude Code | \`.claude/agents/\` (\`sdd\`, \`sdd-planner\`, \`sdd-implementer\`, \`sdd-reviewer\`) |
+| GitHub Copilot | \`.github/agents/*.agent.md\` (same roles) |
 
-\`\`\`bash
-sdd verify
-sdd gate approve   # if hard gate
-sdd next           # or sdd complete on last stage
-\`\`\`
-
-## Bash helpers (if tools allow)
-
-\`\`\`bash
-sdd status
-sdd agent
-sdd agents refresh
-\`\`\`
-
-## Do not
-
-- Skip hard gates
-- Expand scope beyond the change title/intent
-- Delete \`.sdd\` or archive history casually
-`;
-var CLAUDE_PROJECT_MD = `# Claude Code \u2014 this repo uses SDD
-
-Load the **sdd** skill under \`.claude/skills/sdd/\` for implementation work.
-
-Always check \`.sdd/active-context.md\` and the active folder under \`changes/\` before large edits.
-
-CLI: \`sdd\` (npm: \`@structured-vibe-coding/cli\`).
+Refresh context: \`sdd agents refresh\`.
 `;
-var INTELLIJ_NOTES = `# SDD + IntelliJ / GitHub Copilot
-
-This project uses Structured Vibe Coding (\`sdd\`).
-
-## IntelliJ plugin
-
-Install the **Structured Vibe Coding (SDD)** plugin (or run the Gradle plugin from \`packages/intellij\`).  
-Actions under **Tools \u2192 SDD** shell out to the \`sdd\` CLI \u2014 install the CLI on PATH:
-
-\`\`\`bash
-npm i -g @structured-vibe-coding/cli
-\`\`\`
-
-## GitHub Copilot in IntelliJ
-
-Copilot respects repository instructions:
+var INTELLIJ_NOTES = `# SDD + IntelliJ
 
-- \`.github/copilot-instructions.md\`
-- \`AGENTS.md\`
-- \`.sdd/active-context.md\` (refresh often)
+Agents only. Playbook: \`.sdd/protocol.md\`. Live: \`.sdd/active-context.md\`.
 
-Use the SDD plugin action **Refresh agent context** after \`sdd new\` / stage changes.
+1. Install \`sdd\` on PATH: \`npm i -g @structured-vibe-coding/cli\`
+2. Tools \u2192 SDD \u2192 Initialize / Install Agent Integrations
+3. GitHub Copilot uses \`.github/agents/*\` + active-context (same as VS Code)
+4. After stage changes: **Refresh Agent Context**
 `;
 
 export {
@@ -1292,8 +1293,13 @@ export {
   changeDirName,
   uniqueChangeDirName,
   ALL_AGENT_TARGETS,
+  AGENT_TARGET_OPTIONS,
+  parseAgentTargets,
+  SDD_AGENT_ROLES,
   installAgentIntegrations,
+  renderThinAgent,
   refreshActiveAgentContext,
+  PROTOCOL_MD,
   createChange,
   loadChangeMeta,
   saveChangeMeta,

package/dist/index.d.ts

@@ -1166,6 +1166,24 @@ declare function buildAgentPrompt(ctx: ChangeContext, config: Config, projectRoo
 
 type AgentTarget = "copilot" | "claude-code" | "intellij";
 declare const ALL_AGENT_TARGETS: AgentTarget[];
+/** Human-facing labels for interactive platform pick (CLI / IDE). */
+declare const AGENT_TARGET_OPTIONS: {
+    id: AgentTarget;
+    label: string;
+    hint: string;
+}[];
+/** Parse `copilot`, `claude-code,copilot`, etc. Throws on unknown ids. */
+declare function parseAgentTargets(raw: string | string[]): AgentTarget[];
+/** Roles emitted as thin agents (shared body generator — no skill files). */
+type SddAgentRoleId = "sdd" | "sdd-planner" | "sdd-implementer" | "sdd-reviewer";
+interface SddAgentRole {
+    id: SddAgentRoleId;
+    description: string;
+    roleLine: string;
+    /** Extra one-liner constraints for this role only */
+    roleRules: string[];
+}
+declare const SDD_AGENT_ROLES: SddAgentRole[];
 interface InstallAgentsOptions {
     projectRoot: string;
     targets?: AgentTarget[];
@@ -1177,19 +1195,30 @@ interface InstallAgentsResult {
     targets: AgentTarget[];
 }
 /**
- * Install IDE / coding-agent integration files so GitHub Copilot, Claude Code,
- * and JetBrains (via shared instructions) follow SDD.
+ * Install **agents only** (no skills, no fat instructions).
+ *
+ * Single playbook: `.sdd/protocol.md`
+ * Live state:      `.sdd/active-context.md`
+ * Thin agents:     `.claude/agents/*` and `.github/agents/*` (pointers + role)
  */
 declare function installAgentIntegrations(opts: InstallAgentsOptions): Promise<InstallAgentsResult>;
+/** Thin agent body shared by Claude Code and GitHub Copilot (same text). */
+declare function renderThinAgent(role: SddAgentRole): string;
 /** Write .sdd/active-context.md for the current change (all agents read this). */
 declare function refreshActiveAgentContext(projectRoot: string): Promise<string | null>;
+/** Single playbook — only long agent-facing content we author once. */
+declare const PROTOCOL_MD = "# SDD protocol\n\nThis repo uses **Structured Vibe Coding** (`sdd`). Agents must follow this file plus `.sdd/active-context.md`. Do not invent a parallel process.\n\n## Source of truth\n\n| What | Where |\n|------|--------|\n| Process state | `changes/<id>/meta.yaml` (workflow, stage, gates) |\n| Current task snapshot | `.sdd/active-context.md` |\n| Stable product/tech rules | `memory/*.md` |\n| Stage artifacts | files in `changes/<id>/` for the active change |\n\n## Required read order\n\n1. `.sdd/active-context.md`\n2. This file (`.sdd/protocol.md`)\n3. `meta.yaml` + artifacts for the **current stage** (and prior stages if needed)\n4. `memory/` when architecture or conventions matter\n\n## Stage behavior\n\n| Stage kind | Agent focus |\n|------------|-------------|\n| intent / feature / stories | Clarify scope; write short artifacts |\n| design / lld / db / research / hl_arb | Specs and decisions; minimal product code |\n| tasks | Break work into implementable checklist |\n| implement | Code only for this change; follow tasks/acceptance |\n| local_verify | Check acceptance; fix only; prepare for complete |\n\n## Hard rules\n\n1. **Do not skip hard gates.** If blocked, tell the human to run `sdd gate approve` (or fix the gate).\n2. **Stay in scope** of the active change title/intent. No drive-by refactors or new features.\n3. **Honor constraints** in `arb-decision.md`, design, and memory non-negotiables.\n4. **Local verify** is part of done when the workflow has a verify stage: `sdd verify`.\n5. Prefer small, reviewable diffs.\n\n## Commands (human / shell)\n\n```bash\nsdd status\nsdd next\nsdd agent              # print handoff\nsdd agents refresh     # refresh active-context.md\nsdd verify\nsdd complete\n```\n\n## Out of scope for agents\n\n- Replacing CI/CD or team process tools\n- Deleting `.sdd` / archive history\n- Claiming complete without verify when required\n";
 
 interface InitOptions {
     projectRoot: string;
     force?: boolean;
     pack?: "default" | "enterprise";
-    /** Install Copilot / Claude Code / IntelliJ agent files (default: all). */
-    agents?: boolean | AgentTarget[];
+    /**
+     * Agent platforms to install. Opt-in only — never defaults to all platforms.
+     * - omit / `false` — no agent files
+     * - `AgentTarget[]` — install only those hosts
+     */
+    agents?: false | AgentTarget[];
 }
 interface InitResult {
     created: string[];
@@ -1247,4 +1276,4 @@ declare function listFiles(path: string): Promise<string[]>;
 declare function copyDir(src: string, dest: string): Promise<void>;
 declare function removePath(path: string): Promise<void>;
 
-export { ALL_AGENT_TARGETS, type AdvanceResult, type AgentTarget, type ArtifactDef, ArtifactDefSchema, type ChangeContext, type ChangeMeta, ChangeMetaSchema, type Complexity, type Config, ConfigSchema, type CreateChangeInput, type Gate, GateSchema, type InitOptions, type InitResult, type InstallAgentsOptions, type InstallAgentsResult, SDD_DIR, type Stage, StageSchema, VerifyCommandSchema, type VerifyResult, type Workflow, WorkflowSchema, activePointerPath, activeStages, advanceStage, approveGate, archiveDir, buildAgentPrompt, buildContext, canLeaveStage, changeDirName, changeMetaPath, changePath, changesDir, clearActiveIf, completeChange, configPath, copyDir, createChange, defaultConfig, defaultMemoryDir, defaultTemplatesDir, defaultWorkflowsDir, defaultsRoot, domainsDir, ensureDir, firstActiveStageId, formatStatus, getActiveChangeId, getStage, inferComplexity, initProject, installAgentIntegrations, isInitialized, isStageSkipped, listChanges, listDirs, listFiles, listWorkflowNames, loadChangeMeta, loadConfig, loadWorkflow, memoryDir, nextStageId, nowIso, pathExists, previousStageId, projectPaths, readText, readYaml, recommendWorkflow, refreshActiveAgentContext, removePath, resolveChangeId, resolveStages, runLocalVerify, saveChangeMeta, saveConfig, sddRoot, setActiveChange, shouldAutoSkip, skipStage, slugify, switchWorkflow, templatesDir, todayIsoDate, uniqueChangeDirName, workflowsDir, writeText, writeYaml };
+export { AGENT_TARGET_OPTIONS, ALL_AGENT_TARGETS, type AdvanceResult, type AgentTarget, type ArtifactDef, ArtifactDefSchema, type ChangeContext, type ChangeMeta, ChangeMetaSchema, type Complexity, type Config, ConfigSchema, type CreateChangeInput, type Gate, GateSchema, type InitOptions, type InitResult, type InstallAgentsOptions, type InstallAgentsResult, PROTOCOL_MD, SDD_AGENT_ROLES, SDD_DIR, type SddAgentRole, type SddAgentRoleId, type Stage, StageSchema, VerifyCommandSchema, type VerifyResult, type Workflow, WorkflowSchema, activePointerPath, activeStages, advanceStage, approveGate, archiveDir, buildAgentPrompt, buildContext, canLeaveStage, changeDirName, changeMetaPath, changePath, changesDir, clearActiveIf, completeChange, configPath, copyDir, createChange, defaultConfig, defaultMemoryDir, defaultTemplatesDir, defaultWorkflowsDir, defaultsRoot, domainsDir, ensureDir, firstActiveStageId, formatStatus, getActiveChangeId, getStage, inferComplexity, initProject, installAgentIntegrations, isInitialized, isStageSkipped, listChanges, listDirs, listFiles, listWorkflowNames, loadChangeMeta, loadConfig, loadWorkflow, memoryDir, nextStageId, nowIso, parseAgentTargets, pathExists, previousStageId, projectPaths, readText, readYaml, recommendWorkflow, refreshActiveAgentContext, removePath, renderThinAgent, resolveChangeId, resolveStages, runLocalVerify, saveChangeMeta, saveConfig, sddRoot, setActiveChange, shouldAutoSkip, skipStage, slugify, switchWorkflow, templatesDir, todayIsoDate, uniqueChangeDirName, workflowsDir, writeText, writeYaml };

package/dist/index.js

@@ -1,9 +1,12 @@
 import {
+  AGENT_TARGET_OPTIONS,
   ALL_AGENT_TARGETS,
   ArtifactDefSchema,
   ChangeMetaSchema,
   ConfigSchema,
   GateSchema,
+  PROTOCOL_MD,
+  SDD_AGENT_ROLES,
   SDD_DIR,
   StageSchema,
   VerifyCommandSchema,
@@ -46,6 +49,7 @@ import {
   memoryDir,
   nextStageId,
   nowIso,
+  parseAgentTargets,
   pathExists,
   previousStageId,
   projectPaths,
@@ -54,6 +58,7 @@ import {
   recommendWorkflow,
   refreshActiveAgentContext,
   removePath,
+  renderThinAgent,
   resolveChangeId,
   resolveStages,
   saveChangeMeta,
@@ -70,7 +75,7 @@ import {
   workflowsDir,
   writeText,
   writeYaml
-} from "./chunk-PT2BZ23N.js";
+} from "./chunk-BP54LEAD.js";
 
 // src/init.ts
 import { join as join2 } from "pathe";
@@ -189,11 +194,10 @@ sdd complete
     created.push(sddReadme);
   }
   let agentsResult;
-  if (opts.agents !== false) {
-    const targets = Array.isArray(opts.agents) && opts.agents.length ? opts.agents : void 0;
+  if (Array.isArray(opts.agents) && opts.agents.length > 0) {
     const ag = await installAgentIntegrations({
       projectRoot,
-      targets,
+      targets: opts.agents,
       force
     });
     created.push(...ag.created);
@@ -333,11 +337,14 @@ ${output}`
   };
 }
 export {
+  AGENT_TARGET_OPTIONS,
   ALL_AGENT_TARGETS,
   ArtifactDefSchema,
   ChangeMetaSchema,
   ConfigSchema,
   GateSchema,
+  PROTOCOL_MD,
+  SDD_AGENT_ROLES,
   SDD_DIR,
   StageSchema,
   VerifyCommandSchema,
@@ -385,6 +392,7 @@ export {
   memoryDir,
   nextStageId,
   nowIso,
+  parseAgentTargets,
   pathExists,
   previousStageId,
   projectPaths,
@@ -393,6 +401,7 @@ export {
   recommendWorkflow,
   refreshActiveAgentContext,
   removePath,
+  renderThinAgent,
   resolveChangeId,
   resolveStages,
   runLocalVerify,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@structured-vibe-coding/core",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Core engine for structured vibe coding (local-first Spec-Driven Development)",
   "type": "module",
   "main": "./dist/index.js",

package/dist/agents-7PTSPJFQ.js

@@ -1,10 +0,0 @@
-import {
-  ALL_AGENT_TARGETS,
-  installAgentIntegrations,
-  refreshActiveAgentContext
-} from "./chunk-PT2BZ23N.js";
-export {
-  ALL_AGENT_TARGETS,
-  installAgentIntegrations,
-  refreshActiveAgentContext
-};