@kaddo/cli 3.49.0 → 3.51.0

package/dist/index.js

@@ -9052,7 +9052,7 @@ function buildReadinessReport(dir, now = /* @__PURE__ */ new Date()) {
   const ctx = buildCodexAdapterContext(dir);
   const agents = ctx.hasAgents ? "present" : "missing";
   const skills = ctx.hasSkills ? "present" : "missing";
-  const bootstrapBaseline = presence.business !== "missing" && presence.product !== "missing" ? "complete" : "incomplete";
+  const bootstrapBaseline2 = presence.business !== "missing" && presence.product !== "missing" ? "complete" : "incomplete";
   const roadmap = roadmapSignal(dir);
   const work_items = workItemsSignal(dir);
   const adapters = installedAdapters(dir);
@@ -9060,7 +9060,7 @@ function buildReadinessReport(dir, now = /* @__PURE__ */ new Date()) {
   const signals = {
     scan: scan2,
     understand,
-    bootstrap_baseline: bootstrapBaseline,
+    bootstrap_baseline: bootstrapBaseline2,
     agents,
     skills,
     current_state: presence.current_state,
@@ -9079,7 +9079,7 @@ function buildReadinessReport(dir, now = /* @__PURE__ */ new Date()) {
   const firstWeak = KNOWLEDGE_FILES.find((f) => presence[f.key] !== "useful");
   let overall;
   if (scan2 === "missing") overall = "initialized";
-  else if (bootstrapBaseline === "incomplete") overall = "bootstrap-incomplete";
+  else if (bootstrapBaseline2 === "incomplete") overall = "bootstrap-incomplete";
   else if (agents === "missing") overall = "agents-missing";
   else if (skills === "missing") overall = "skills-missing";
   else if (understand === "missing") overall = "scanned";
@@ -9346,6 +9346,14 @@ var scanRepository = {
     return { status: "done", evidence: [".kaddo/scan.json"] };
   }
 };
+var bootstrapBaseline = {
+  id: "bootstrap",
+  label: "Bootstrap knowledge baseline",
+  evaluate: (ctx) => {
+    if (ctx.qBusiness !== "missing" && ctx.qProduct !== "missing") return { status: "done", evidence: ["knowledge/business/business.md", "knowledge/product/product.md"] };
+    return { status: "pending", command: "kaddo bootstrap", reason: "The knowledge baseline is incomplete." };
+  }
+};
 var defineBusiness = {
   id: "define-business",
   label: "Define business context",
@@ -9542,6 +9550,7 @@ var NEW_STEPS = [
 var PRE_AI_STEPS = [
   enableKaddo,
   scanRepository,
+  bootstrapBaseline,
   defineBusiness,
   defineProduct,
   discoverCapabilities,
@@ -9559,6 +9568,7 @@ var PRE_AI_STEPS = [
 var LEGACY_STEPS = [
   enableKaddo,
   scanRepository,
+  bootstrapBaseline,
   identifyLegacyModules,
   { ...discoverCapabilities, label: "Discover critical capabilities" },
   describeArchitecture,
@@ -9650,7 +9660,7 @@ function loadScanWarnings(dir) {
 function mapNextStepId(id) {
   const MAP = {
     init: "enable-kaddo",
-    bootstrap: "define-business",
+    bootstrap: "bootstrap",
     "add-agents": "enable-kaddo",
     "add-skills": "enable-kaddo",
     scan: "scan-repository",
@@ -9819,6 +9829,15 @@ function hasAgents(dir) {
   }
   return hasAgentMd(agentsDir);
 }
+function hasSkills(dir) {
+  const skillsDir = join(dir, ARCH_DIR4, "skills");
+  if (!exists(skillsDir)) return false;
+  try {
+    return readDir(skillsDir).some((e) => e.endsWith(".md") && isFile(join(skillsDir, e)));
+  } catch {
+    return false;
+  }
+}
 function buildProjectExplanation(dir) {
   const config = loadConfig(dir);
   const project = {
@@ -9845,10 +9864,13 @@ function buildProjectExplanation(dir) {
     hasInventory: exists(join(dir, ARCH_DIR4, "inventory.md")),
     hasContextPack: exists(join(dir, ".kaddo", "context-pack.md")),
     hasUnderstand: exists(join(dir, ".kaddo", "understand.md")),
+    hasBusiness: exists(join(dir, "knowledge/business/business.md")),
+    hasProduct: exists(join(dir, "knowledge/product/product.md")),
     hasCapabilities: layerStatus("Product") !== "Missing",
     hasArchitecture: layerStatus("Tech") !== "Missing",
     hasRoadmap: layerStatus("Delivery") !== "Missing",
-    hasAgents: hasAgents(dir)
+    hasAgents: hasAgents(dir),
+    hasSkills: hasSkills(dir)
   };
   const workItemArtifacts = discoverWorkItems(dir);
   const items = workItemArtifacts.map((a) => {
@@ -9913,33 +9935,42 @@ function buildProjectExplanation(dir) {
   if (!knowledge.hasAgents) missingKnowledge.push("Agents (knowledge/agents/)");
   if (items.length === 0) missingKnowledge.push("Work items (knowledge/delivery/work-items/)");
   const suggestedNextSteps = [];
-  if (!knowledge.hasScan) {
-    suggestedNextSteps.push("Run `kaddo scan` to detect the technical stack.");
-  } else if (!knowledge.hasContextPack) {
-    suggestedNextSteps.push("Run `kaddo context` to prepare an LLM context pack.");
-  }
-  if (!knowledge.hasAgents) {
-    suggestedNextSteps.push("Run `kaddo add agents` to install knowledge agents.");
-  }
-  if (!knowledge.hasCapabilities) {
-    suggestedNextSteps.push("Use capability-agent to generate knowledge/product/capabilities.md.");
-  }
-  if (!knowledge.hasArchitecture) {
-    suggestedNextSteps.push("Use architecture-agent to generate knowledge/tech/current-state.md.");
-  }
-  if (!knowledge.hasRoadmap) {
-    suggestedNextSteps.push("Use roadmap-agent to generate knowledge/delivery/roadmap.md.");
-  } else if (roadmap.remaining > 0) {
-    suggestedNextSteps.push(
-      `Materialize ${roadmap.remaining} roadmap candidate(s) with \`kaddo create --from roadmap\`.`
-    );
-  }
-  if (items.length === 0 && !roadmap.present) {
-    suggestedNextSteps.push("Create your first Work Item with `kaddo create`.");
-  } else if (ownership.workItemsMissingOwnership > 0) {
-    suggestedNextSteps.push(
-      "Run `kaddo owners suggest` for Work Items without code ownership."
-    );
+  const baselineIncomplete = !knowledge.hasBusiness || !knowledge.hasProduct;
+  if (baselineIncomplete) {
+    suggestedNextSteps.push("Run `kaddo bootstrap` to create the project knowledge baseline.");
+    if (!knowledge.hasAgents) suggestedNextSteps.push("Then run `kaddo add agents`.");
+    if (!knowledge.hasSkills) suggestedNextSteps.push("Then run `kaddo add skills`.");
+    suggestedNextSteps.push("Then run `kaddo context`.");
+    suggestedNextSteps.push("Then run `kaddo understand`.");
+  } else {
+    if (!knowledge.hasScan) {
+      suggestedNextSteps.push("Run `kaddo scan` to detect the technical stack.");
+    } else if (!knowledge.hasContextPack) {
+      suggestedNextSteps.push("Run `kaddo context` to prepare an LLM context pack.");
+    }
+    if (!knowledge.hasAgents) {
+      suggestedNextSteps.push("Run `kaddo add agents` to install knowledge agents.");
+    }
+    if (!knowledge.hasCapabilities) {
+      suggestedNextSteps.push("Use capability-agent to generate knowledge/product/capabilities.md.");
+    }
+    if (!knowledge.hasArchitecture) {
+      suggestedNextSteps.push("Use architecture-agent to generate knowledge/tech/current-state.md.");
+    }
+    if (!knowledge.hasRoadmap) {
+      suggestedNextSteps.push("Use roadmap-agent to generate knowledge/delivery/roadmap.md.");
+    } else if (roadmap.remaining > 0) {
+      suggestedNextSteps.push(
+        `Materialize ${roadmap.remaining} roadmap candidate(s) with \`kaddo create --from roadmap\`.`
+      );
+    }
+    if (items.length === 0 && !roadmap.present) {
+      suggestedNextSteps.push("Create your first Work Item with `kaddo create`.");
+    } else if (ownership.workItemsMissingOwnership > 0) {
+      suggestedNextSteps.push(
+        "Run `kaddo owners suggest` for Work Items without code ownership."
+      );
+    }
   }
   const readiness = buildReadinessReport(dir);
   return {
@@ -10653,10 +10684,14 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
   if (techKnowledge.discovery.legacyLocation) {
     missing.push("Tech discovery files are in the legacy `knowledge/tech/` root. Run `kaddo tech organize` to move them to `knowledge/tech/discovery/`.");
   }
+  const isBootstrap = nextStepRecommendation.id === "bootstrap";
   const unifiedPhase = {
     ...phase,
+    phase: isBootstrap ? "Setup" : phase.phase,
+    reasons: isBootstrap ? ["The knowledge baseline is incomplete."] : phase.reasons,
     nextStep: nextStepRecommendation.label,
-    recommendedAgents: nextStepRecommendation.agent ? [nextStepRecommendation.agent] : phase.recommendedAgents
+    recommendedAgents: isBootstrap ? [] : nextStepRecommendation.agent ? [nextStepRecommendation.agent] : phase.recommendedAgents,
+    llmInstructions: isBootstrap ? ["Run `kaddo bootstrap` before using agent handoff.", "Do not ask an LLM to generate baseline knowledge until bootstrap files exist."] : phase.llmInstructions
   };
   const deliveryState = { ...buildDeliveryState(dir), phase: nextStepRecommendation.phase };
   return {
@@ -10712,9 +10747,9 @@ function buildContextPack(dir, config, now = /* @__PURE__ */ new Date()) {
     // VS-052/VS-073.2: the handoff is driven by the unified next step, so the pack never contradicts
     // the Current Phase block above it.
     handoff: {
-      recommendedAgents: unifiedPhase.recommendedAgents.length > 0 ? unifiedPhase.recommendedAgents : recommendedAgentsForState(state),
+      recommendedAgents: isBootstrap ? [] : unifiedPhase.recommendedAgents.length > 0 ? unifiedPhase.recommendedAgents : recommendedAgentsForState(state),
       nextSteps: [nextStepRecommendation.label],
-      instructions: unifiedPhase.llmInstructions.length > 0 ? unifiedPhase.llmInstructions : LLM_INSTRUCTIONS,
+      instructions: isBootstrap ? ["No agent handoff yet.", "Run `kaddo bootstrap` first to create the baseline files."] : unifiedPhase.llmInstructions.length > 0 ? unifiedPhase.llmInstructions : LLM_INSTRUCTIONS,
       operatingRules: OPERATING_RULES
     }
   };
@@ -10978,19 +11013,35 @@ function renderContextPack(pack) {
     parts.push(pack.skills.map((s) => `- ${s}`).join("\n") + "\n");
     parts.push("Read full skill definitions in `knowledge/skills/` or via the Kaddo MCP server (`kaddo://skills`).\n");
   }
+  const isBootstrapIncomplete = rec.id === "bootstrap";
   parts.push("## Missing Context\n");
-  if (missing.length > 0) {
+  if (isBootstrapIncomplete) {
+    const baselineMissing = [
+      "- Bootstrap baseline is incomplete.",
+      ...!pack.knowledgeQuality.business || pack.knowledgeQuality.business.status === "Missing" ? ["- Missing business knowledge."] : [],
+      ...!pack.knowledgeQuality.product || pack.knowledgeQuality.product.status === "Missing" ? ["- Missing product knowledge."] : []
+    ];
+    if (missing.length > 0) {
+      baselineMissing.push(...missing.filter((m) => !baselineMissing.some((b) => b.includes(m))));
+    }
+    parts.push(baselineMissing.join("\n") + "\n");
+  } else if (missing.length > 0) {
     parts.push(missing.map((m) => `- ${m}`).join("\n") + "\n");
   } else {
     parts.push("_None \u2014 all expected context is present._\n");
   }
   parts.push("## Recommended Agent Handoff\n");
-  parts.push(`Recommended next for the **${pack.phase.phase}** phase:
+  if (isBootstrapIncomplete) {
+    parts.push("No agent handoff yet.\n");
+    parts.push("Run `kaddo bootstrap` first to create the baseline files.\n");
+  } else {
+    parts.push(`Recommended next for the **${pack.phase.phase}** phase:
 `);
-  parts.push(handoff.recommendedAgents.map((a, i) => `${i + 1}. ${a}`).join("\n") + "\n");
-  if (handoff.nextSteps.length > 0) {
-    parts.push("Next step:\n");
-    parts.push(handoff.nextSteps.map((s) => `- ${s}`).join("\n") + "\n");
+    parts.push(handoff.recommendedAgents.map((a, i) => `${i + 1}. ${a}`).join("\n") + "\n");
+    if (handoff.nextSteps.length > 0) {
+      parts.push("Next step:\n");
+      parts.push(handoff.nextSteps.map((s) => `- ${s}`).join("\n") + "\n");
+    }
   }
   parts.push("## Instructions for the LLM\n");
   parts.push(handoff.instructions.map((i) => `- ${i}`).join("\n") + "\n");
@@ -11155,7 +11206,12 @@ function renderUnderstand(plan) {
     parts.push("## Project Route\n");
     parts.push(renderRouteCompact(plan.projectRoute));
   }
-  if (steps.length > 0) {
+  const isBootstrap = rec && rec.id === "bootstrap";
+  if (isBootstrap) {
+    parts.push("## Agent Handoff\n");
+    parts.push("Agent handoff is not ready yet.\n");
+    parts.push("Run `kaddo bootstrap` first.\n");
+  } else if (steps.length > 0) {
     parts.push("## Recommended Agent Flow\n");
     parts.push(`Recommended order for a ${stateLabel2(project.state)} project:
 `);
@@ -11207,75 +11263,87 @@ function renderUnderstand(plan) {
   const scanNote = plan.scanAvailable ? "" : " (incomplete \u2014 run `kaddo scan` first for a richer baseline)";
   parts.push(`Use \`${plan.contextPackPath}\` as the primary input${scanNote}.
 `);
-  const agentPaths = [];
-  if (plan.recommendedPaths && plan.recommendedPaths.length > 0) {
-    agentPaths.push(...plan.recommendedPaths);
-  } else if (steps.length > 0) {
-    agentPaths.push(...steps.map((s) => agentInstallPath(s.agent)));
-  }
-  if (plan.recommendedSkillPaths && plan.recommendedSkillPaths.length > 0) {
-    agentPaths.push(...plan.recommendedSkillPaths);
-  }
-  agentPaths.push(plan.contextPackPath);
-  parts.push("## Agent Prompts\n");
-  if (agentPaths.length > 1) {
-    parts.push("Use:\n");
-    parts.push(agentPaths.map((p2) => `- \`${p2}\``).join("\n") + "\n");
-  } else {
-    parts.push(`- \`${plan.contextPackPath}\`
+  if (!isBootstrap) {
+    const agentPaths = [];
+    if (plan.recommendedPaths && plan.recommendedPaths.length > 0) {
+      agentPaths.push(...plan.recommendedPaths);
+    } else if (steps.length > 0) {
+      agentPaths.push(...steps.map((s) => agentInstallPath(s.agent)));
+    }
+    if (plan.recommendedSkillPaths && plan.recommendedSkillPaths.length > 0) {
+      agentPaths.push(...plan.recommendedSkillPaths);
+    }
+    agentPaths.push(plan.contextPackPath);
+    parts.push("## Agent Prompts\n");
+    if (agentPaths.length > 1) {
+      parts.push("Use:\n");
+      parts.push(agentPaths.map((p2) => `- \`${p2}\``).join("\n") + "\n");
+    } else {
+      parts.push(`- \`${plan.contextPackPath}\`
 `);
-  }
-  if (steps.length > 0) {
-    parts.push("## Expected Outputs\n");
-    parts.push(steps.map((s) => `- \`${s.output}\``).join("\n") + "\n");
-  } else if (rec) {
-    parts.push("## Expected Outputs\n");
-    const outputs = [];
-    if (rec.target) outputs.push(`- \`${rec.target}\``);
-    if (rec.id === "refine-work-item" || rec.id === "resolve-blocker")
-      outputs.push("- Refined Work Item content.");
-    if (rec.id === "create-work-item")
-      outputs.push("- A new Work Item under `knowledge/delivery/work-items/`.");
-    if (rec.id === "implement")
-      outputs.push("- Implementation plan or code changes guided by the Work Item.");
-    if (rec.id === "guard")
-      outputs.push("- Updated knowledge artifacts reflecting recent code changes.");
-    if (rec.id === "install-adapter")
-      outputs.push("- An adapter configured and injected (`kaddo adapters list`).");
-    if (outputs.length > 0) {
-      parts.push("The LLM should produce:\n");
-      parts.push(outputs.join("\n") + "\n");
+    }
+    if (steps.length > 0) {
+      parts.push("## Expected Outputs\n");
+      parts.push(steps.map((s) => `- \`${s.output}\``).join("\n") + "\n");
+    } else if (rec) {
+      parts.push("## Expected Outputs\n");
+      const outputs = [];
+      if (rec.target) outputs.push(`- \`${rec.target}\``);
+      if (rec.id === "refine-work-item" || rec.id === "resolve-blocker")
+        outputs.push("- Refined Work Item content.");
+      if (rec.id === "create-work-item")
+        outputs.push("- A new Work Item under `knowledge/delivery/work-items/`.");
+      if (rec.id === "implement")
+        outputs.push("- Implementation plan or code changes guided by the Work Item.");
+      if (rec.id === "guard")
+        outputs.push("- Updated knowledge artifacts reflecting recent code changes.");
+      if (rec.id === "install-adapter")
+        outputs.push("- An adapter configured and injected (`kaddo adapters list`).");
+      if (outputs.length > 0) {
+        parts.push("The LLM should produce:\n");
+        parts.push(outputs.join("\n") + "\n");
+      } else {
+        parts.push("_See the primary recommendation above._\n");
+      }
+    }
+    parts.push("## Copy/Paste Instructions\n");
+    if (steps.length > 0) {
+      const first2 = steps[0];
+      parts.push(
+        [
+          `Start with **${agentName(first2.agent)}**:`,
+          "",
+          "1. Open your preferred LLM chat (Claude, ChatGPT, Cursor, Copilot, Windsurf\u2026).",
+          `2. Paste the context pack: \`${plan.contextPackPath}\``,
+          `3. Paste the agent prompt: \`${agentInstallPath(first2.agent)}\``,
+          `4. Ask the LLM to produce: \`${first2.output}\``,
+          `5. Save the result in: \`${first2.output}\``
+        ].join("\n") + "\n"
+      );
+    } else if (agentPaths.length > 1) {
+      parts.push("Paste the following into your LLM chat:\n");
+      parts.push(agentPaths.map((p2, i) => `${i + 1}. \`${p2}\``).join("\n") + "\n");
+      if (rec?.agent) {
+        parts.push(`Ask the LLM to follow the ${agentName(rec.agent)} instructions.
+`);
+      }
     } else {
-      parts.push("_See the primary recommendation above._\n");
+      parts.push(`Paste \`${plan.contextPackPath}\` into your LLM chat.
+`);
     }
   }
-  parts.push("## Copy/Paste Instructions\n");
-  if (steps.length > 0) {
-    const first2 = steps[0];
+  parts.push("## Next Steps\n");
+  if (isBootstrap) {
     parts.push(
       [
-        `Start with **${agentName(first2.agent)}**:`,
-        "",
-        "1. Open your preferred LLM chat (Claude, ChatGPT, Cursor, Copilot, Windsurf\u2026).",
-        `2. Paste the context pack: \`${plan.contextPackPath}\``,
-        `3. Paste the agent prompt: \`${agentInstallPath(first2.agent)}\``,
-        `4. Ask the LLM to produce: \`${first2.output}\``,
-        `5. Save the result in: \`${first2.output}\``
+        "1. Run `kaddo bootstrap`.",
+        "2. Run `kaddo add agents`.",
+        "3. Run `kaddo add skills`.",
+        "4. Run `kaddo context`.",
+        "5. Run `kaddo understand`."
       ].join("\n") + "\n"
     );
-  } else if (agentPaths.length > 1) {
-    parts.push("Paste the following into your LLM chat:\n");
-    parts.push(agentPaths.map((p2, i) => `${i + 1}. \`${p2}\``).join("\n") + "\n");
-    if (rec?.agent) {
-      parts.push(`Ask the LLM to follow the ${agentName(rec.agent)} instructions.
-`);
-    }
-  } else {
-    parts.push(`Paste \`${plan.contextPackPath}\` into your LLM chat.
-`);
-  }
-  parts.push("## Next Steps\n");
-  if (rec) {
+  } else if (rec) {
     const nextLines = [];
     nextLines.push(`1. ${rec.label}`);
     let n = 2;
@@ -11308,25 +11376,41 @@ function renderUnderstandTerminal(plan) {
   lines.push(`Team: ${project.teamSize}`);
   lines.push(`Structure: ${project.structure}`);
   lines.push("");
-  const first2 = steps[0];
-  if (first2) {
-    lines.push("Foundational knowledge still needed:");
-    steps.forEach((s, i) => {
-      const flag = s.installed ? "" : "  (not installed)";
-      lines.push(`  ${i + 1}. ${agentName(s.agent)} \u2192 ${s.output}${flag}`);
-    });
-    lines.push("");
-    lines.push(`First step: use ${agentName(first2.agent)}.`);
+  const rec = plan.nextStepRecommendation;
+  const isBootstrapIncomplete = rec && rec.id === "bootstrap";
+  if (isBootstrapIncomplete) {
+    lines.push("Current phase: Setup");
+    lines.push("Next step: Run `kaddo bootstrap` to create the project knowledge baseline.");
+    lines.push("Reason: The knowledge baseline is incomplete.");
     lines.push("");
-    lines.push(`  Context:         ${plan.contextPackPath}`);
-    lines.push(`  Agent prompt:    ${agentInstallPath(first2.agent)}`);
-    lines.push(`  Expected output: ${first2.output}`);
+    lines.push("Agent handoff is not ready yet.");
     lines.push("");
-    lines.push("Instructions:");
-    lines.push("  Open your preferred LLM chat, paste the context pack, then paste the agent");
-    lines.push("  prompt. Ask the LLM to generate the expected output and save it in the target file.");
+    lines.push("Run `kaddo bootstrap` first. Then run:");
+    lines.push("  1. kaddo add agents");
+    lines.push("  2. kaddo add skills");
+    lines.push("  3. kaddo context");
+    lines.push("  4. kaddo understand");
   } else {
-    lines.push("Foundational knowledge looks complete \u2014 see the phase recommendation below.");
+    const first2 = steps[0];
+    if (first2) {
+      lines.push("Foundational knowledge still needed:");
+      steps.forEach((s, i) => {
+        const flag = s.installed ? "" : "  (not installed)";
+        lines.push(`  ${i + 1}. ${agentName(s.agent)} \u2192 ${s.output}${flag}`);
+      });
+      lines.push("");
+      lines.push(`First step: use ${agentName(first2.agent)}.`);
+      lines.push("");
+      lines.push(`  Context:         ${plan.contextPackPath}`);
+      lines.push(`  Agent prompt:    ${agentInstallPath(first2.agent)}`);
+      lines.push(`  Expected output: ${first2.output}`);
+      lines.push("");
+      lines.push("Instructions:");
+      lines.push("  Open your preferred LLM chat, paste the context pack, then paste the agent");
+      lines.push("  prompt. Ask the LLM to generate the expected output and save it in the target file.");
+    } else {
+      lines.push("Foundational knowledge looks complete \u2014 see the phase recommendation below.");
+    }
   }
   lines.push("");
   lines.push("Kaddo does not call an LLM. You stay in control of the interpretation.");
@@ -11420,73 +11504,77 @@ function runUnderstand() {
   writeFile(join(dir, ".kaddo", "context-pack.md"), renderContextPack(pack));
   log2.success("Refreshed .kaddo/context-pack.md");
   const plan = buildUnderstandPlan(dir, config);
-  if (plan.missingAgents.length > 0) {
+  const earlyRec = resolveNextStep(dir);
+  if (earlyRec.id !== "bootstrap" && plan.missingAgents.length > 0) {
     log2.warn(
       `Agents are not installed (${plan.missingAgents.map((a) => a.replace(/\.md$/, "")).join(", ")}). Run \`kaddo add agents\`.`
     );
   }
+  plan.nextStepRecommendation = earlyRec;
   console.log(renderUnderstandTerminal(plan));
   console.log(`Project language: ${pack.project.language} (knowledge artifacts are written in this language)`);
   const exp = buildProjectExplanation(dir);
   const assessment = assessPhase(exp);
   const rec = exp.nextStepRecommendation;
-  console.log("");
-  console.log(`Current phase: ${assessment.phase}`);
-  if (assessment.reasons.length > 0) {
-    console.log("Reason:");
-    for (const r of assessment.reasons) console.log(`  - ${r}`);
-  }
-  if (rec.agent) console.log(`Recommended: ${rec.agent}`);
-  if (rec.skill) console.log(`Recommended skill: ${rec.skill}`);
-  console.log(`Next step: ${rec.label}`);
-  if (rec.reason) console.log(`Why: ${rec.reason}`);
-  if (rec.secondary && rec.secondary.length > 0) {
-    console.log("Also:");
-    for (const s of rec.secondary) console.log(`  - ${s.label}`);
-  }
-  const installedSkills = discoverInstalledSkills(dir);
-  if (installedSkills.length > 0 && assessment.recommendedAgents.length > 0) {
-    const recSkills = skillsForAgents(installedSkills, assessment.recommendedAgents);
-    if (recSkills.length > 0) {
-      console.log("Recommended skills:");
-      for (const s of recSkills) console.log(`  - ${s}`);
-    }
-  }
-  const td = exp.techDecisions;
-  if (td.candidates > 0 && td.adrs === 0) {
-    console.log("");
-    console.log(`Tech decisions: ${td.candidates} decision candidate(s) not yet materialized as ADRs.`);
-    console.log("  \u2192 Use the adr-writing skill to create ADR drafts from `knowledge/tech/decision-candidates.md`");
-    console.log("    into `knowledge/tech/decisions/` before implementing affected technical Work Items (`kaddo adr`).");
-  }
-  const rqi = exp.roadmapQuality.initiatives;
-  if (rqi.needs_refinement) {
-    console.log("");
-    console.log(`Roadmap quality: ${rqi.grounded}/${rqi.total} initiatives grounded.`);
-    console.log("  \u2192 Use roadmap-agent to ground roadmap initiatives in capability domains, gaps and source signals");
-    console.log("    before `kaddo create --from roadmap`.");
-  } else if (rqi.total > 0 && rqi.grounded === rqi.total && exp.roadmap.materialized_work_items === 0) {
+  if (earlyRec.id !== "bootstrap") {
     console.log("");
-    console.log("Roadmap initiatives are grounded. \u2192 Run `kaddo create --from roadmap` to materialize the first Work Item.");
-  }
-  const ia = exp.installedAssets;
-  const outdatedRecommended = ia.agents.items.filter(
-    (a) => (a.state === "outdated" || a.state === "unknown-version") && assessment.recommendedAgents.includes(a.name)
-  );
-  if (outdatedRecommended.length > 0) {
-    console.log("");
-    for (const a of outdatedRecommended) {
-      console.log(`Recommended agent ${a.name} is ${a.state} (installed ${a.installed ?? "unknown"}, available ${a.available}).`);
+    console.log(`Current phase: ${assessment.phase}`);
+    if (assessment.reasons.length > 0) {
+      console.log("Reason:");
+      for (const r of assessment.reasons) console.log(`  - ${r}`);
+    }
+    if (rec.agent) console.log(`Recommended: ${rec.agent}`);
+    if (rec.skill) console.log(`Recommended skill: ${rec.skill}`);
+    console.log(`Next step: ${rec.label}`);
+    if (rec.reason) console.log(`Why: ${rec.reason}`);
+    if (rec.secondary && rec.secondary.length > 0) {
+      console.log("Also:");
+      for (const s of rec.secondary) console.log(`  - ${s.label}`);
+    }
+    const installedSkills = discoverInstalledSkills(dir);
+    if (installedSkills.length > 0 && assessment.recommendedAgents.length > 0) {
+      const recSkills = skillsForAgents(installedSkills, assessment.recommendedAgents);
+      if (recSkills.length > 0) {
+        console.log("Recommended skills:");
+        for (const s of recSkills) console.log(`  - ${s}`);
+      }
     }
-    console.log("  \u2192 Run `kaddo agents update` or review `kaddo agents status`.");
-  }
-  if (exp.externalCapsules.length > 0) {
-    console.log("");
-    console.log("External knowledge:");
-    for (const cap of exp.externalCapsules) {
-      console.log(`  - ${cap.system}${cap.owner ? ` (owner: ${cap.owner})` : ""}`);
+    const td = exp.techDecisions;
+    if (td.candidates > 0 && td.adrs === 0) {
+      console.log("");
+      console.log(`Tech decisions: ${td.candidates} decision candidate(s) not yet materialized as ADRs.`);
+      console.log("  \u2192 Use the adr-writing skill to create ADR drafts from `knowledge/tech/decision-candidates.md`");
+      console.log("    into `knowledge/tech/decisions/` before implementing affected technical Work Items (`kaddo adr`).");
+    }
+    const rqi = exp.roadmapQuality.initiatives;
+    if (rqi.needs_refinement) {
+      console.log("");
+      console.log(`Roadmap quality: ${rqi.grounded}/${rqi.total} initiatives grounded.`);
+      console.log("  \u2192 Use roadmap-agent to ground roadmap initiatives in capability domains, gaps and source signals");
+      console.log("    before `kaddo create --from roadmap`.");
+    } else if (rqi.total > 0 && rqi.grounded === rqi.total && exp.roadmap.materialized_work_items === 0) {
+      console.log("");
+      console.log("Roadmap initiatives are grounded. \u2192 Run `kaddo create --from roadmap` to materialize the first Work Item.");
+    }
+    const ia = exp.installedAssets;
+    const outdatedRecommended = ia.agents.items.filter(
+      (a) => (a.state === "outdated" || a.state === "unknown-version") && assessment.recommendedAgents.includes(a.name)
+    );
+    if (outdatedRecommended.length > 0) {
+      console.log("");
+      for (const a of outdatedRecommended) {
+        console.log(`Recommended agent ${a.name} is ${a.state} (installed ${a.installed ?? "unknown"}, available ${a.available}).`);
+      }
+      console.log("  \u2192 Run `kaddo agents update` or review `kaddo agents status`.");
+    }
+    if (exp.externalCapsules.length > 0) {
+      console.log("");
+      console.log("External knowledge:");
+      for (const cap of exp.externalCapsules) {
+        console.log(`  - ${cap.system}${cap.owner ? ` (owner: ${cap.owner})` : ""}`);
+      }
+      console.log("  \u2192 Review the relevant capsule before changing integration behavior with it.");
     }
-    console.log("  \u2192 Review the relevant capsule before changing integration behavior with it.");
   }
   const graphHints = loadGraphHints(dir);
   if (assessment.phase === "Active Delivery" && graphHints && graphHints.activeWorkItemHints > 0) {

package/package.json

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