feat: guided Sprint 0 bootstrapping workflow

src/agent/mcp-server.ts

@@ -16,6 +16,7 @@ import { createSessionTools } from "./tools/sessions.js";
 import { createWebTools } from "./tools/web.js";
 import { createDoctorTools } from "./tools/doctor.js";
 import { createConceptTools } from "../methodology/tools.js";
+import { createBootstrapTools } from "../methodology/bootstrap-tools.js";
 import type { NavGroup } from "../web/templates/layout.js";
 
 export interface McpServerOptions {
@@ -52,6 +53,10 @@ export function createMarvinMcpServer(
       marvinDir: options?.marvinDir,
     }),
     ...createConceptTools(options?.config),
+    ...createBootstrapTools(store, {
+      config: options?.config,
+      manifest: options?.manifest,
+    }),
   ];
 
   return createSdkMcpServer({

src/doctor/health/onboarding.ts

@@ -29,7 +29,6 @@ export function buildOnboardingGuide(ctx: HealthContext): OnboardingGuide {
   const pendingSources = ctx.manifest?.list("pending")?.length ?? 0;
   const hasActions = (counts["action"] ?? 0) > 0;
   const hasEpics = (counts["epic"] ?? 0) > 0;
-  const hasSprints = (counts["sprint"] ?? 0) > 0;
   const hasFeatures = (counts["feature"] ?? 0) > 0;
   const hasUseCases = (counts["use-case"] ?? 0) > 0;
   const hasJira = !!ctx.config.jira?.projectKey?.trim();
@@ -105,13 +104,25 @@ export function buildOnboardingGuide(ctx: HealthContext): OnboardingGuide {
   });
 
   // Step 6: Set up Sprint 0
+  const hasWorkItems = hasActions || hasFeatures || hasUseCases;
+  const hasSprintZero = ctx.store.list({ type: "sprint" }).some((s) => {
+    const tags: string[] = s.frontmatter.tags ?? [];
+    return (
+      tags.includes("sprint-0") ||
+      tags.includes("bootstrapping") ||
+      s.frontmatter.title?.toLowerCase().includes("sprint 0")
+    );
+  });
   steps.push({
     order: order++,
     title: "Set up Sprint 0",
-    description:
-      "As DM, create a Sprint 0 to organize bootstrapping work: infrastructure provisioning, CI/CD setup, backlog refinement, and ceremony scheduling. Sprint 0 is not a regular sprint — it's a variable-duration bootstrapping phase that ensures the team is ready for Sprint 1.",
-    tool: "create_sprint",
-    done: hasSprints,
+    description: hasSprintZero
+      ? "Sprint 0 has been created."
+      : hasWorkItems
+        ? "As DM, run bootstrap_sprint_zero to create a guided Sprint 0 with linked bootstrapping actions for infrastructure, backlog refinement, ceremonies, and integrations. This generates a fully scaffolded sprint with checklist items pre-populated."
+        : "As DM, create a Sprint 0 to organize bootstrapping work: infrastructure provisioning, CI/CD setup, backlog refinement, and ceremony scheduling. Sprint 0 is not a regular sprint — it's a variable-duration bootstrapping phase that ensures the team is ready for Sprint 1.",
+    tool: hasWorkItems && !hasSprintZero ? "bootstrap_sprint_zero" : "create_sprint",
+    done: hasSprintZero,
   });
 
   // Step 7: Configure Jira integration

src/methodology/bootstrap-tools.ts

@@ -0,0 +1,92 @@
+import { z } from "zod/v4";
+import { tool, type SdkMcpToolDefinition } from "@anthropic-ai/claude-agent-sdk";
+import type { DocumentStore } from "../storage/store.js";
+import type { MarvinProjectConfig } from "../core/config.js";
+import type { SourceManifestManager } from "../sources/manifest.js";
+import { runStep, type BootstrapStep, type BootstrapSection } from "./bootstrap.js";
+
+export interface BootstrapToolOptions {
+  config?: MarvinProjectConfig;
+  manifest?: SourceManifestManager;
+}
+
+export function createBootstrapTools(
+  store: DocumentStore,
+  options?: BootstrapToolOptions,
+): SdkMcpToolDefinition<any>[] {
+  return [
+    tool(
+      "bootstrap_sprint_zero",
+      "Guided multi-step workflow that produces a draft Sprint 0 with linked bootstrapping actions. Call with no arguments to start at survey step. Each step returns next_step to chain calls. Only the commit step writes to disk; all other steps are read-only.",
+      {
+        step: z
+          .enum(["survey", "draft", "populate", "review", "commit"])
+          .optional()
+          .describe("Workflow step. Omit on first call to start at survey."),
+        section: z
+          .enum([
+            "infrastructure-provisioning",
+            "backlog-refinement",
+            "ceremony-scheduling",
+            "integration-setup",
+            "aem-addendum",
+          ])
+          .optional()
+          .describe("Restrict populate step to one section."),
+        includeAemAddendum: z
+          .boolean()
+          .optional()
+          .describe(
+            "Override AEM addendum inclusion. Default: auto-detect from methodology config.",
+          ),
+      },
+      async (args) => {
+        if (!options?.config) {
+          return {
+            content: [
+              {
+                type: "text" as const,
+                text: "Bootstrap unavailable: project config not initialized.",
+              },
+            ],
+            isError: true,
+          };
+        }
+
+        const ctx = {
+          store,
+          config: options.config,
+          manifest: options.manifest,
+          includeAemAddendum: args.includeAemAddendum,
+        };
+
+        try {
+          const result = runStep(
+            ctx,
+            args.step as BootstrapStep | undefined,
+            args.section as BootstrapSection | undefined,
+          );
+
+          return {
+            content: [
+              {
+                type: "text" as const,
+                text: JSON.stringify(result, null, 2),
+              },
+            ],
+          };
+        } catch (err) {
+          return {
+            content: [
+              {
+                type: "text" as const,
+                text: `Bootstrap error: ${err instanceof Error ? err.message : String(err)}`,
+              },
+            ],
+            isError: true,
+          };
+        }
+      },
+    ),
+  ];
+}