@kaddo/cli 3.0.0 → 3.2.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Judlup Luna
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Judlup Luna
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -432,6 +432,8 @@ create --from roadmap → owners → guard → explain`.
 | v2.7 | Multirepo hardening: module artifacts from the template registry, module-aware `context`/`explain`, opt-in `guard --workspace` |
 | v2.8 | `kaddo bootstrap` for new projects (Business → Product → Tech → Delivery); business templates + bootstrap agents |
 | v3.0 | Knowledge-centric realignment: `architecture/` → `knowledge/` with layers Business → Product → Tech → Delivery; context/explain by layer (breaking) |
+| v3.1 | Minimum Sufficient Knowledge: bootstrap one consolidated file per layer; progressive `add agents` by group (state default, `--all`, `--group`) |
+| v3.2 | New-project flow hardening: agents in per-layer folders; `new` recommends capability+architecture agents; explain Work Item parser fix; intent vs reality (codebase vs current-state) |
 
 **Optional modules (installed with `kaddo add`):**
 

package/dist/index.js

@@ -566,8 +566,8 @@ function loadConfig(dir) {
   const parsed = configSchema.safeParse(raw ?? {});
   if (!parsed.success) {
     const issues = parsed.error.issues.map((i) => {
-      const path6 = i.path.join(".");
-      return path6 ? `  - ${path6}: ${i.message}` : `  - ${i.message}`;
+      const path5 = i.path.join(".");
+      return path5 ? `  - ${path5}: ${i.message}` : `  - ${i.message}`;
     }).join("\n");
     throw new ConfigError(`Invalid .kaddo/config.yml:
 ${issues}`);
@@ -2487,6 +2487,81 @@ var AGENT_PROMPTS = [
   { fileName: "codebase-agent.md", content: CODEBASE_FOUNDATION_AGENT }
 ];
 
+// src/agents/groups.ts
+var AGENT_GROUPS = {
+  business: ["business-agent.md"],
+  product: ["bootstrap-agent.md", "capability-agent.md"],
+  tech: [
+    "architecture-agent.md",
+    "codebase-agent.md",
+    "stack-agent.md",
+    "security-agent.md",
+    "standards-agent.md",
+    "module-design-agent.md",
+    "adr-agent.md"
+  ],
+  delivery: ["roadmap-agent.md", "work-item-agent.md", "git-strategy-agent.md"],
+  utilities: ["legacy-agent.md"]
+};
+var AGENT_GROUP_NAMES = Object.keys(AGENT_GROUPS);
+function agentGroupOf(fileName) {
+  for (const g of AGENT_GROUP_NAMES) {
+    if (AGENT_GROUPS[g].includes(fileName)) return g;
+  }
+  return "utilities";
+}
+function agentInstallPath(fileName) {
+  return `knowledge/agents/${agentGroupOf(fileName)}/${fileName}`;
+}
+var RECOMMENDED_BY_STATE = {
+  new: [
+    "business-agent.md",
+    "bootstrap-agent.md",
+    "capability-agent.md",
+    "architecture-agent.md",
+    "codebase-agent.md",
+    "roadmap-agent.md",
+    "work-item-agent.md",
+    "adr-agent.md"
+  ],
+  "pre-ai": [
+    "capability-agent.md",
+    "architecture-agent.md",
+    "roadmap-agent.md",
+    "work-item-agent.md"
+  ],
+  legacy: [
+    "legacy-agent.md",
+    "architecture-agent.md",
+    "capability-agent.md",
+    "roadmap-agent.md",
+    "work-item-agent.md"
+  ]
+};
+function recommendedAgents(state) {
+  return RECOMMENDED_BY_STATE[state ?? "pre-ai"] ?? RECOMMENDED_BY_STATE["pre-ai"];
+}
+function selectAgentFiles(opts) {
+  if (opts.all) {
+    const all = AGENT_GROUP_NAMES.flatMap((g) => AGENT_GROUPS[g]);
+    return { files: all, label: "all agents" };
+  }
+  if (opts.group) {
+    const group = opts.group;
+    const files = AGENT_GROUPS[group];
+    if (!files) {
+      throw new Error(
+        `Unknown agent group "${opts.group}". Valid groups: ${AGENT_GROUP_NAMES.join(", ")}.`
+      );
+    }
+    return { files, label: `group: ${group}` };
+  }
+  return {
+    files: recommendedAgents(opts.state),
+    label: `recommended for state: ${opts.state ?? "pre-ai"}`
+  };
+}
+
 // src/modules/agents.ts
 var agentReadme = {
   path: "knowledge/agents/README.md",
@@ -2538,7 +2613,7 @@ var agentReadme = {
   ].join("\n")
 };
 var agentFiles = AGENT_PROMPTS.map((a) => ({
-  path: `knowledge/agents/${a.fileName}`,
+  path: agentInstallPath(a.fileName),
   content: a.content
 }));
 var agentsModule = {
@@ -3518,9 +3593,8 @@ function readArtifacts(archDir) {
 
 // src/core/diff-analysis.ts
 import { minimatch } from "minimatch";
-import path3 from "path";
 function normalizePath(p2) {
-  return p2.split(path3.sep).join("/");
+  return p2.replace(/\\/g, "/");
 }
 function fileMatchesGlob(file, glob) {
   return minimatch(normalizePath(file), glob, { matchBase: false, dot: true });
@@ -3578,10 +3652,10 @@ function analyzeGuard(touchedFiles, artifacts, silentWithoutOwnership) {
 import { parse as parseYaml4, stringify as stringifyYaml2 } from "yaml";
 var IGNORE_FILE = ".kaddo/ignores.yml";
 function loadIgnores(dir) {
-  const path6 = join(dir, IGNORE_FILE);
-  if (!exists(path6)) return [];
+  const path5 = join(dir, IGNORE_FILE);
+  if (!exists(path5)) return [];
   try {
-    const raw = readFile(path6);
+    const raw = readFile(path5);
     const parsed = parseYaml4(raw);
     return Array.isArray(parsed) ? parsed : [];
   } catch {
@@ -3589,7 +3663,7 @@ function loadIgnores(dir) {
   }
 }
 function saveIgnore(dir, entry) {
-  const path6 = join(dir, IGNORE_FILE);
+  const path5 = join(dir, IGNORE_FILE);
   const existing = loadIgnores(dir);
   const idx = existing.findIndex((e) => e.artifact_id === entry.artifact_id);
   if (idx >= 0) {
@@ -3597,17 +3671,17 @@ function saveIgnore(dir, entry) {
   } else {
     existing.push(entry);
   }
-  writeFile(path6, stringifyYaml2(existing));
+  writeFile(path5, stringifyYaml2(existing));
 }
 function isIgnored(ignores, artifactId) {
   return ignores.find((e) => e.artifact_id === artifactId);
 }
 function removeIgnore(dir, artifactId) {
-  const path6 = join(dir, IGNORE_FILE);
+  const path5 = join(dir, IGNORE_FILE);
   const existing = loadIgnores(dir);
   const filtered = existing.filter((e) => e.artifact_id !== artifactId);
   if (filtered.length === existing.length) return false;
-  writeFile(path6, stringifyYaml2(filtered));
+  writeFile(path5, stringifyYaml2(filtered));
   return true;
 }
 
@@ -3629,11 +3703,11 @@ function moduleArtifactCoverage(dir, id) {
   };
 }
 function loadMappedModules(dir) {
-  const path6 = join(dir, DESCRIPTOR_PATH);
-  if (!exists(path6)) return [];
+  const path5 = join(dir, DESCRIPTOR_PATH);
+  if (!exists(path5)) return [];
   let parsed;
   try {
-    parsed = parseYaml5(readFile(path6));
+    parsed = parseYaml5(readFile(path5));
   } catch {
     return [];
   }
@@ -3725,7 +3799,7 @@ async function collectWorkspaceChanges(dir, mode = "head", deps = defaultDeps) {
 }
 
 // src/commands/guard.ts
-import path4 from "path";
+import path3 from "path";
 import { parse as parseYaml7 } from "yaml";
 
 // src/plugins/prisma.ts
@@ -3929,7 +4003,7 @@ function printHeader(touchedFiles) {
 function artifactLabel(artifact, dir) {
   if (artifact.id) return artifact.id;
   if (artifact.title) return artifact.title;
-  const rel = path4.relative(dir, artifact.filePath).split(path4.sep).join("/");
+  const rel = path3.relative(dir, artifact.filePath).split(path3.sep).join("/");
   return rel || artifact.filePath;
 }
 function printWorkspaceHeader(scan2) {
@@ -4212,6 +4286,12 @@ function knowledgeLayers(dir) {
     items: items.map((it) => ({ name: it.name, present: exists(join(dir, it.path)) }))
   }));
 }
+function currentPhase(layers) {
+  for (const { layer, items } of layers) {
+    if (items.some((i) => !i.present)) return layer;
+  }
+  return "Delivery";
+}
 function renderLayersMarkdown(layers) {
   const lines = [];
   for (const { layer, items } of layers) {
@@ -4256,7 +4336,18 @@ function loadScan(dir) {
 function hasAgents(dir) {
   const agentsDir = join(dir, ARCH_DIR3, "agents");
   if (!exists(agentsDir)) return false;
-  return readDir(agentsDir).some((e) => e.endsWith(".md") && isFile(join(agentsDir, e)));
+  function hasAgentMd(d) {
+    for (const e of readDir(d)) {
+      const full = join(d, e);
+      if (isFile(full)) {
+        if (e.endsWith("-agent.md")) return true;
+      } else if (hasAgentMd(full)) {
+        return true;
+      }
+    }
+    return false;
+  }
+  return hasAgentMd(agentsDir);
 }
 function buildProjectExplanation(dir) {
   const config = loadConfig(dir);
@@ -4288,9 +4379,10 @@ function buildProjectExplanation(dir) {
   };
   const archDir = join(dir, ARCH_DIR3);
   const allArtifacts = exists(archDir) ? readArtifacts(archDir) : [];
-  const workItemArtifacts = allArtifacts.filter(
-    (a) => a.type !== "current-state" && a.type !== "roadmap"
-  );
+  const workItemArtifacts = allArtifacts.filter((a) => {
+    const p2 = a.filePath.replace(/\\/g, "/");
+    return p2.includes("/delivery/work-items/") && Boolean(a.type);
+  });
   const items = workItemArtifacts.map((a) => ({
     id: a.id || a.title,
     title: a.title,
@@ -4520,7 +4612,7 @@ function explainForHuman(dir, artifacts, opts) {
     console.log("");
   }
   const workItems = artifacts.filter(
-    (a) => a.type !== "current-state" && a.type !== "roadmap" && a.status === "in-progress"
+    (a) => a.filePath.replace(/\\/g, "/").includes("/delivery/work-items/") && Boolean(a.type) && a.status === "in-progress"
   );
   if (workItems.length > 0) {
     console.log("## Active work items");
@@ -4940,6 +5032,9 @@ function runContext(opts = {}) {
 }
 
 // src/core/understand.ts
+function agentIsInstalled(dir, fileName) {
+  return exists(join(dir, agentInstallPath(fileName))) || exists(join(dir, "knowledge", "agents", fileName));
+}
 function flowForState(state) {
   switch (state) {
     case "new":
@@ -4967,7 +5062,7 @@ function buildUnderstandPlan(dir, config) {
   const state = config.project.state;
   const flow = flowForState(state);
   const steps = flow.map((s) => {
-    const installed = exists(join(dir, "knowledge", "agents", s.agent));
+    const installed = agentIsInstalled(dir, s.agent);
     return { agent: s.agent, output: s.output, installed };
   });
   const missingAgents = steps.filter((s) => !s.installed).map((s) => s.agent);
@@ -5122,13 +5217,43 @@ function runUnderstand() {
     );
   }
   console.log(renderUnderstandTerminal(plan));
+  const phase = currentPhase(knowledgeLayers(dir));
+  const group = phase.toLowerCase();
+  const groupAgents = (AGENT_GROUPS[group] ?? []).map((a) => a.replace(/\.md$/, ""));
+  const NEXT_STEPS = {
+    business: ["Use business-agent \u2192 refine knowledge/business/business.md"],
+    product: [
+      "Use bootstrap-agent \u2192 refine knowledge/product/product.md",
+      "Use capability-agent \u2192 knowledge/product/capabilities.md"
+    ],
+    tech: [
+      "Use architecture-agent \u2192 knowledge/tech/current-state.md (reality)",
+      "Use codebase-agent \u2192 knowledge/tech/codebase.md (intent)",
+      "Record decisions as ADRs in knowledge/tech/decisions/"
+    ],
+    delivery: [
+      "Use roadmap-agent \u2192 knowledge/delivery/roadmap.md",
+      "Run `kaddo create --from roadmap`, then `kaddo owners suggest`"
+    ],
+    utilities: ["Use legacy-agent to surface risks and unknowns"]
+  };
+  console.log("");
+  console.log(`Current phase: ${phase}`);
+  console.log("Recommended next steps:");
+  console.log("  1. Run `kaddo scan`   (technical signals \u2192 knowledge/inventory.md)");
+  console.log("  2. Run `kaddo context`  (package knowledge for your LLM)");
+  let n = 3;
+  for (const step of NEXT_STEPS[group] ?? []) console.log(`  ${n++}. ${step}`);
+  if (groupAgents.length > 0) {
+    console.log(`Agents for this phase: ${groupAgents.join(", ")}`);
+  }
   writeFile(join(dir, ".kaddo", "understand.md"), renderUnderstand(plan));
   log2.success("Wrote .kaddo/understand.md");
   outro2("Handoff ready. CLI prepares context \u2014 your LLM creates the understanding.");
 }
 
 // src/core/classifier.ts
-import path5 from "path";
+import path4 from "path";
 var MIGRATION_PATTERNS = [
   /supabase\/migrations\//,
   /prisma\/migrations\//,
@@ -5167,7 +5292,7 @@ var DEP_PATTERNS = [
   /^pom\.xml$/
 ];
 function normalizePath2(p2) {
-  return p2.split(path5.sep).join("/");
+  return p2.split(path4.sep).join("/");
 }
 function matchesAny(file, patterns) {
   const normalized = normalizePath2(file);
@@ -5556,6 +5681,24 @@ function runHistory(opts = {}) {
 // src/commands/add.ts
 import { parse as parseYaml10, stringify as stringifyYaml3 } from "yaml";
 var CONFIG_PATH5 = ".kaddo/config.yml";
+function readProjectState(dir) {
+  const configPath = join(dir, CONFIG_PATH5);
+  if (!exists(configPath)) return void 0;
+  try {
+    const config = parseYaml10(readFile(configPath));
+    return config.project?.state;
+  } catch {
+    return void 0;
+  }
+}
+function selectAgentModuleFiles(files, opts, state) {
+  const { files: names, label } = selectAgentFiles({ all: opts.all, group: opts.group, state });
+  const wanted = new Set(names);
+  const selected = files.filter(
+    (f) => f.path.endsWith("README.md") || names.some((n) => f.path.endsWith(n)) || wanted.has(f.path)
+  );
+  return { files: selected, label };
+}
 function markModuleInstalled(dir, configKey, moduleName) {
   const configPath = join(dir, CONFIG_PATH5);
   if (!exists(configPath)) return;
@@ -5580,7 +5723,7 @@ function isModuleInstalled(dir, configKey) {
     return false;
   }
 }
-function runAdd(moduleName, dir = cwd()) {
+function runAdd(moduleName, opts = {}, dir = cwd()) {
   if (!moduleName) {
     console.log("");
     console.log("Available modules:");
@@ -5606,9 +5749,20 @@ function runAdd(moduleName, dir = cwd()) {
   for (const d of mod.dirs) {
     ensureDir(join(dir, d));
   }
+  let filesToInstall = mod.files;
+  if (mod.name === "agents") {
+    try {
+      const sel = selectAgentModuleFiles(mod.files, opts, readProjectState(dir));
+      filesToInstall = sel.files;
+      log2.info(`Installing agents (${sel.label}).`);
+    } catch (err) {
+      console.error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  }
   const written = [];
   const skipped = [];
-  for (const file of mod.files) {
+  for (const file of filesToInstall) {
     const fullPath = join(dir, file.path);
     if (exists(fullPath)) {
       skipped.push(file.path);
@@ -5631,6 +5785,7 @@ function runAdd(moduleName, dir = cwd()) {
     console.log("    2. Open your preferred LLM chat");
     console.log("    3. Paste `.kaddo/context-pack.md`");
     console.log("    4. Use the recommended agent for your project state");
+    log2.info("More agents: `kaddo add agents --all` or `--group <business|product|tech|delivery|utilities>`.");
     outro2("Agents installed. Kaddo prepares context \u2014 your LLM does the interpretation.");
     return;
   }
@@ -5888,10 +6043,10 @@ ${globs.map((g) => `  - ${g}`).join("\n")}`);
 import { parse as parseYaml11, stringify as stringifyYaml4 } from "yaml";
 var DESCRIPTOR_PATH2 = "knowledge/module.yml";
 function readDescriptor(dir) {
-  const path6 = join(dir, DESCRIPTOR_PATH2);
-  if (!exists(path6)) return null;
+  const path5 = join(dir, DESCRIPTOR_PATH2);
+  if (!exists(path5)) return null;
   try {
-    return parseYaml11(readFile(path6));
+    return parseYaml11(readFile(path5));
   } catch {
     return null;
   }
@@ -6920,47 +7075,138 @@ ${QUALITY}
 - [ ] Attributes are prioritized, not all "high".
 - [ ] Trade-offs are explicit.
 `;
+var BUSINESS_CONSOLIDATED = `---
+type: business
+status: draft
+---
+
+# Business
+
+> Created by \`kaddo bootstrap\`. The minimal **why** of the project. Refine with the
+> business-agent. As this matures it can split into problem.md, users.md, \u2026
+
+## Problem
+
+TBD
+
+## Users
+
+TBD
+
+## Value Proposition
+
+TBD
+
+## Business Rules
+
+- TBD
+
+## Constraints
+
+- TBD
+
+## Assumptions
+
+- ...
+
+## Open Questions
+
+- ...
+
+${QUALITY}
+
+- [ ] The problem is stated without assuming the solution.
+- [ ] Users have goals, not just labels.
+`;
+var PRODUCT_CONSOLIDATED = `---
+type: product
+status: draft
+---
+
+# Product
+
+> Created by \`kaddo bootstrap\`. The minimal **what** of the project. Refine with the
+> bootstrap-agent / capability-agent. As this matures it can split into product-brief.md
+> and capabilities.md.
+
+## Product Brief
+
+TBD
+
+## Capabilities
+
+- TBD
+
+## Scope
+
+- TBD
+
+## Out of Scope
+
+- TBD
+
+## Success Criteria
+
+- TBD
+
+## Assumptions
+
+- ...
+
+## Open Questions
+
+- ...
+
+${QUALITY}
+
+- [ ] The product fits in one page.
+- [ ] Scope and out-of-scope are explicit.
+`;
 var CODEBASE_FOUNDATION = `---
-type: codebase-foundation
+type: codebase
 status: draft
 ---
 
-# Codebase Foundation
+# Codebase
 
-> Created by \`kaddo bootstrap\`. Refine with the codebase-agent.
-> This describes the intended base \u2014 it does **not** generate code.
+> Created by \`kaddo bootstrap\`. The minimal **how** of the project. Refine with the
+> codebase-agent. It describes the intended base \u2014 it does **not** generate code.
 
-## Suggested structure
+## Repository Structure
 
 TBD
 
-## Initial modules / boundaries
+## Candidate Stack
 
 - TBD
 
-## Conventions
+## Quality Attributes
 
 - TBD
 
-## Git strategy
+## Development Standards
 
-See \`knowledge/tech/git-strategy.md\`.
+- TBD
 
-## Minimum criteria to start development
+## Git Strategy
 
-- [ ] TBD
+GitHub Flow + Conventional Commits + SemVer (default). See \`kaddo add git-strategy\`.
+
+## Initial Modules
+
+- TBD
 
 ## Assumptions
 
 - ...
 
-## Open questions
+## Open Questions
 
 - ...
 
 ${QUALITY}
 
-- [ ] Structure follows the business and architecture, not a framework default.
+- [ ] Structure follows business and product, not a framework default.
 - [ ] No production code is described here \u2014 only the foundation.
 `;
 var BOOTSTRAP_SUMMARY = `---
@@ -7034,6 +7280,7 @@ var KADDO_TEMPLATES = [
     description: "What the system can do from the product point of view.",
     whenToUse: "When mapping product capabilities to the system.",
     relatedAgent: "capability-agent",
+    advanced: true,
     content: CAPABILITIES
   },
   {
@@ -7046,7 +7293,30 @@ var KADDO_TEMPLATES = [
     relatedCommand: "kaddo init",
     content: KNOWLEDGE2
   },
-  // business (bootstrap)
+  // business / product (bootstrap — consolidated, minimal)
+  {
+    id: "business",
+    name: "Business",
+    category: "business",
+    outputPath: "knowledge/business/business.md",
+    description: "The minimal why: problem, users, value, rules, constraints (one file).",
+    whenToUse: "Generated by kaddo bootstrap for new projects.",
+    relatedCommand: "kaddo bootstrap",
+    relatedAgent: "business-agent",
+    content: BUSINESS_CONSOLIDATED
+  },
+  {
+    id: "product",
+    name: "Product",
+    category: "product",
+    outputPath: "knowledge/product/product.md",
+    description: "The minimal what: product brief, capabilities, scope (one file).",
+    whenToUse: "Generated by kaddo bootstrap for new projects.",
+    relatedCommand: "kaddo bootstrap",
+    relatedAgent: "bootstrap-agent",
+    content: PRODUCT_CONSOLIDATED
+  },
+  // business (advanced — split out as knowledge matures, not generated by bootstrap)
   {
     id: "business-product-brief",
     name: "Product Brief",
@@ -7056,6 +7326,7 @@ var KADDO_TEMPLATES = [
     whenToUse: "At the start of a new project (kaddo bootstrap).",
     relatedCommand: "kaddo bootstrap",
     relatedAgent: "business-agent",
+    advanced: true,
     content: BUSINESS_PRODUCT_BRIEF
   },
   {
@@ -7067,6 +7338,7 @@ var KADDO_TEMPLATES = [
     whenToUse: "When defining a new project (kaddo bootstrap).",
     relatedCommand: "kaddo bootstrap",
     relatedAgent: "business-agent",
+    advanced: true,
     content: BUSINESS_PROBLEM
   },
   {
@@ -7078,6 +7350,7 @@ var KADDO_TEMPLATES = [
     whenToUse: "When defining a new project (kaddo bootstrap).",
     relatedCommand: "kaddo bootstrap",
     relatedAgent: "business-agent",
+    advanced: true,
     content: BUSINESS_USERS
   },
   {
@@ -7089,6 +7362,7 @@ var KADDO_TEMPLATES = [
     whenToUse: "When defining a new project (kaddo bootstrap).",
     relatedCommand: "kaddo bootstrap",
     relatedAgent: "business-agent",
+    advanced: true,
     content: BUSINESS_VALUE_PROPOSITION
   },
   {
@@ -7100,6 +7374,7 @@ var KADDO_TEMPLATES = [
     whenToUse: "When defining a new project (kaddo bootstrap).",
     relatedCommand: "kaddo bootstrap",
     relatedAgent: "business-agent",
+    advanced: true,
     content: BUSINESS_RULES
   },
   {
@@ -7111,6 +7386,7 @@ var KADDO_TEMPLATES = [
     whenToUse: "When defining a new project (kaddo bootstrap).",
     relatedCommand: "kaddo bootstrap",
     relatedAgent: "business-agent",
+    advanced: true,
     content: BUSINESS_CONSTRAINTS
   },
   {
@@ -7122,6 +7398,7 @@ var KADDO_TEMPLATES = [
     whenToUse: "When defining a new project (kaddo bootstrap).",
     relatedCommand: "kaddo bootstrap",
     relatedAgent: "business-agent",
+    advanced: true,
     content: BUSINESS_GLOSSARY
   },
   // architecture
@@ -7163,6 +7440,7 @@ var KADDO_TEMPLATES = [
     whenToUse: "During bootstrap, to record what matters most technically.",
     relatedCommand: "kaddo bootstrap",
     relatedAgent: "bootstrap-agent",
+    advanced: true,
     content: QUALITY_ATTRIBUTES
   },
   {
@@ -7364,10 +7642,10 @@ function slugify2(name) {
   return name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
 function readModulesDescriptor(dir) {
-  const path6 = join(dir, DESCRIPTOR_PATH3);
-  if (!exists(path6)) return { version: 1, modules: [] };
+  const path5 = join(dir, DESCRIPTOR_PATH3);
+  if (!exists(path5)) return { version: 1, modules: [] };
   try {
-    const parsed = parseYaml12(readFile(path6));
+    const parsed = parseYaml12(readFile(path5));
     return { version: parsed.version ?? 1, modules: parsed.modules ?? [] };
   } catch {
     return { version: 1, modules: [] };
@@ -7574,16 +7852,11 @@ function runModulesList(dir = cwd()) {
 // src/commands/bootstrap.ts
 var CONFIG_PATH8 = ".kaddo/config.yml";
 var TARGETS = [
-  // Business — why it exists
-  { layer: "Business", path: "knowledge/business/problem.md", templateId: "business-problem" },
-  { layer: "Business", path: "knowledge/business/users.md", templateId: "business-users" },
-  { layer: "Business", path: "knowledge/business/value-proposition.md", templateId: "business-value-proposition" },
-  { layer: "Business", path: "knowledge/business/constraints.md", templateId: "business-constraints" },
-  { layer: "Business", path: "knowledge/business/business-rules.md", templateId: "business-rules" },
-  // Product — what we build
-  { layer: "Product", path: "knowledge/product/product-brief.md", templateId: "business-product-brief" },
-  { layer: "Product", path: "knowledge/product/capabilities.md", templateId: "capabilities" },
-  // Tech — how we build it
+  // Minimum sufficient knowledge: one consolidated file per layer. Specialized
+  // artifacts (problem.md, users.md, capabilities.md, …) appear later, as the project
+  // matures, via agents and refinement — not at bootstrap.
+  { layer: "Business", path: "knowledge/business/business.md", templateId: "business" },
+  { layer: "Product", path: "knowledge/product/product.md", templateId: "product" },
   { layer: "Tech", path: "knowledge/tech/codebase.md", templateId: "codebase" }
 ];
 var BOOTSTRAP_LAYERS = ["Business", "Product", "Tech"];
@@ -7652,7 +7925,7 @@ async function runBootstrap(dir = cwd()) {
 
 // src/index.ts
 var program = new Command();
-program.name("kaddo").description("Knowledge Driven Development toolkit").version("3.0.0");
+program.name("kaddo").description("Knowledge Driven Development toolkit").version("3.2.0");
 program.command("init").description("Initialize Kaddo in the current project").action(async () => {
   await runInit();
 });
@@ -7716,8 +7989,8 @@ modulesCmd.command("map").description("Register a secondary repository as a modu
 modulesCmd.command("list").description("List mapped modules").action(() => {
   runModulesList();
 });
-program.command("add [module]").description("Install an optional Kaddo module (adr, incident, rfc, migration, legacy, agents, standards, security, stack, git-strategy)").action((moduleName) => {
-  runAdd(moduleName ?? "");
+program.command("add [module]").description("Install an optional Kaddo module (adr, incident, rfc, migration, legacy, agents, standards, security, stack, git-strategy)").option("--all", "For `add agents`: install every agent (not just the recommended set)").option("--group <name>", "For `add agents`: install one layer group (business, product, tech, delivery, utilities)").action((moduleName, opts) => {
+  runAdd(moduleName ?? "", { all: opts.all, group: opts.group });
 });
 program.parseAsync(process.argv).catch((err) => {
   console.error(err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaddo/cli",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "Knowledge Driven Development toolkit",
   "license": "MIT",
   "repository": {