lean-spec 0.2.6-dev.20251126022840 → 0.2.6-dev.20251126033915

package/dist/{chunk-RTEGSMVL.js → chunk-VWR4YMIR.js}

@@ -15,7 +15,7 @@ import { Command } from 'commander';
 import { execSync, spawn } from 'child_process';
 import ora from 'ora';
 import stripAnsi from 'strip-ansi';
-import { select } from '@inquirer/prompts';
+import { select, checkbox } from '@inquirer/prompts';
 import dayjs3 from 'dayjs';
 import { marked } from 'marked';
 import { markedTerminal } from 'marked-terminal';
@@ -1892,6 +1892,95 @@ async function copyTemplate(source, target, cwd = process.cwd()) {
   console.log(chalk19.gray(`  Edit: ${targetPath}`));
   console.log(chalk19.gray(`  Use with: lean-spec create <spec-name> --template=${templateName}`));
 }
+var AI_TOOL_CONFIGS = {
+  claude: {
+    file: "CLAUDE.md",
+    description: "Claude Code / Claude Desktop (CLAUDE.md)",
+    default: true,
+    usesSymlink: true
+  },
+  gemini: {
+    file: "GEMINI.md",
+    description: "Gemini CLI (GEMINI.md)",
+    default: false,
+    usesSymlink: true
+  },
+  copilot: {
+    file: "AGENTS.md",
+    description: "GitHub Copilot (AGENTS.md - default)",
+    default: true,
+    usesSymlink: false
+    // Primary file, no symlink needed
+  },
+  cursor: {
+    file: "AGENTS.md",
+    description: "Cursor (uses AGENTS.md)",
+    default: false,
+    usesSymlink: false
+  },
+  windsurf: {
+    file: "AGENTS.md",
+    description: "Windsurf (uses AGENTS.md)",
+    default: false,
+    usesSymlink: false
+  },
+  cline: {
+    file: "AGENTS.md",
+    description: "Cline (uses AGENTS.md)",
+    default: false,
+    usesSymlink: false
+  },
+  warp: {
+    file: "AGENTS.md",
+    description: "Warp Terminal (uses AGENTS.md)",
+    default: false,
+    usesSymlink: false
+  }
+};
+async function createAgentToolSymlinks(cwd, selectedTools) {
+  const results = [];
+  const isWindows = process.platform === "win32";
+  const filesToCreate = /* @__PURE__ */ new Set();
+  for (const tool of selectedTools) {
+    const config = AI_TOOL_CONFIGS[tool];
+    if (config.usesSymlink) {
+      filesToCreate.add(config.file);
+    }
+  }
+  for (const file of filesToCreate) {
+    const targetPath = path15.join(cwd, file);
+    try {
+      try {
+        await fs9.access(targetPath);
+        results.push({ file, skipped: true });
+        continue;
+      } catch {
+      }
+      if (isWindows) {
+        const windowsContent = `# ${file}
+
+> **Note**: This file is a copy of AGENTS.md for tools that expect ${file}.
+> 
+> **Important**: Edit AGENTS.md instead. Then run \`lean-spec init\` to regenerate this file,
+> or manually copy AGENTS.md to ${file}.
+
+See AGENTS.md for the full LeanSpec AI agent instructions.
+`;
+        await fs9.writeFile(targetPath, windowsContent, "utf-8");
+        results.push({ file, created: true, error: "created as copy (Windows)" });
+      } else {
+        await fs9.symlink("AGENTS.md", targetPath);
+        results.push({ file, created: true });
+      }
+    } catch (error) {
+      results.push({
+        file,
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+    }
+  }
+  return results;
+}
 async function detectExistingSystemPrompts(cwd) {
   const commonFiles = [
     "AGENTS.md",
@@ -2084,7 +2173,7 @@ var __dirname = path15.dirname(fileURLToPath(import.meta.url));
 var TEMPLATES_DIR = path15.join(__dirname, "..", "templates");
 var EXAMPLES_DIR = path15.join(TEMPLATES_DIR, "examples");
 function initCommand() {
-  return new Command("init").description("Initialize LeanSpec in current directory").option("-y, --yes", "Skip prompts and use defaults (quick start with standard template)").option("--template <name>", "Use specific template (standard or detailed)").option("--example [name]", "Scaffold an example project for tutorials (interactive if no name provided)").option("--name <dirname>", "Custom directory name for example project").option("--list", "List available example projects").action(async (options) => {
+  return new Command("init").description("Initialize LeanSpec in current directory").option("-y, --yes", "Skip prompts and use defaults (quick start with standard template)").option("--template <name>", "Use specific template (standard or detailed)").option("--example [name]", "Scaffold an example project for tutorials (interactive if no name provided)").option("--name <dirname>", "Custom directory name for example project").option("--list", "List available example projects").option("--agent-tools <tools>", 'AI tools to create symlinks for (comma-separated: claude,gemini,copilot or "all" or "none")').action(async (options) => {
     if (options.list) {
       await listExamples();
       return;
@@ -2093,10 +2182,10 @@ function initCommand() {
       await scaffoldExample(options.example, options.name);
       return;
     }
-    await initProject(options.yes, options.template);
+    await initProject(options.yes, options.template, options.agentTools);
   });
 }
-async function initProject(skipPrompts = false, templateOption) {
+async function initProject(skipPrompts = false, templateOption, agentToolsOption) {
   const cwd = process.cwd();
   try {
     await fs9.access(path15.join(cwd, ".lean-spec", "config.json"));
@@ -2110,8 +2199,21 @@ async function initProject(skipPrompts = false, templateOption) {
   console.log("");
   let setupMode = "quick";
   let templateName = templateOption || "standard";
+  let selectedAgentTools = [];
+  if (agentToolsOption) {
+    if (agentToolsOption === "all") {
+      selectedAgentTools = Object.keys(AI_TOOL_CONFIGS);
+    } else if (agentToolsOption === "none") {
+      selectedAgentTools = [];
+    } else {
+      selectedAgentTools = agentToolsOption.split(",").map((t) => t.trim());
+    }
+  }
   if (skipPrompts) {
     console.log(chalk19.gray("Using defaults: quick start with standard template"));
+    if (!agentToolsOption) {
+      selectedAgentTools = ["claude", "copilot"];
+    }
     console.log("");
   } else if (!templateOption) {
     setupMode = await select({
@@ -2217,6 +2319,19 @@ async function initProject(skipPrompts = false, templateOption) {
     templateConfig.structure.pattern = "flat";
     templateConfig.structure.prefix = "";
   }
+  if (!skipPrompts && !agentToolsOption && setupMode !== "quick") {
+    const toolChoices = Object.entries(AI_TOOL_CONFIGS).map(([key, config]) => ({
+      name: config.description,
+      value: key,
+      checked: config.default
+    }));
+    selectedAgentTools = await checkbox({
+      message: "Which AI tools do you use? (creates symlinks for tool-specific instruction files)",
+      choices: toolChoices
+    });
+  } else if (!agentToolsOption && setupMode === "quick") {
+    selectedAgentTools = ["claude", "copilot"];
+  }
   const templatesDir = path15.join(cwd, ".lean-spec", "templates");
   try {
     await fs9.mkdir(templatesDir, { recursive: true });
@@ -2310,6 +2425,18 @@ async function initProject(skipPrompts = false, templateOption) {
       console.error(chalk19.red("Error copying AGENTS.md:"), error);
       process.exit(1);
     }
+    if (selectedAgentTools.length > 0) {
+      const symlinkResults = await createAgentToolSymlinks(cwd, selectedAgentTools);
+      for (const result of symlinkResults) {
+        if (result.created) {
+          console.log(chalk19.green(`\u2713 Created ${result.file} \u2192 AGENTS.md`));
+        } else if (result.skipped) {
+          console.log(chalk19.yellow(`\u26A0 Skipped ${result.file} (already exists)`));
+        } else if (result.error) {
+          console.log(chalk19.yellow(`\u26A0 Could not create ${result.file}: ${result.error}`));
+        }
+      }
+    }
   }
   const filesDir = path15.join(templateDir, "files");
   try {
@@ -4492,6 +4619,174 @@ var SubSpecValidator = class {
     }
   }
 };
+var SPEC_REF_PATTERNS = [
+  // "spec 045", "Spec 045", "spec-045"
+  /\bspec[- ]?(\d{3})\b/gi,
+  // "045-unified-dashboard" (full spec folder name)
+  /\b(\d{3})-[a-z][a-z0-9-]+\b/gi
+];
+var DEPENDS_ON_PATTERNS = [
+  /depends on[:\s]+.*?\b(\d{3})\b/gi,
+  /blocked by[:\s]+.*?\b(\d{3})\b/gi,
+  /requires[:\s]+.*?spec[:\s]*(\d{3})\b/gi,
+  /prerequisite[:\s]+.*?\b(\d{3})\b/gi,
+  /after[:\s]+.*?spec[:\s]*(\d{3})\b/gi
+];
+var RELATED_PATTERNS = [
+  /related to[:\s]+.*?\b(\d{3})\b/gi,
+  /see (also )?spec[:\s]*(\d{3})\b/gi,
+  /builds on[:\s]+.*?\b(\d{3})\b/gi,
+  /similar to[:\s]+.*?\b(\d{3})\b/gi,
+  /complements[:\s]+.*?\b(\d{3})\b/gi,
+  /\brelated[:\s]+\[?(\d{3})/gi
+];
+var DependencyAlignmentValidator = class {
+  name = "dependency-alignment";
+  description = "Detect content references to specs not linked in frontmatter";
+  strict;
+  existingSpecNumbers;
+  constructor(options = {}) {
+    this.strict = options.strict ?? false;
+    this.existingSpecNumbers = options.existingSpecNumbers ?? null;
+  }
+  /**
+   * Set the existing spec numbers to validate against
+   */
+  setExistingSpecNumbers(numbers) {
+    this.existingSpecNumbers = numbers;
+  }
+  validate(spec, content) {
+    const errors = [];
+    const warnings = [];
+    let parsed;
+    try {
+      parsed = matter2(content, {
+        engines: {
+          yaml: (str) => yaml2.load(str, { schema: yaml2.FAILSAFE_SCHEMA })
+        }
+      });
+    } catch {
+      return { passed: true, errors: [], warnings: [] };
+    }
+    const frontmatter = parsed.data;
+    const bodyContent = parsed.content;
+    const currentDependsOn = this.normalizeDeps(frontmatter.depends_on);
+    const currentRelated = this.normalizeDeps(frontmatter.related);
+    const allCurrentDeps = /* @__PURE__ */ new Set([...currentDependsOn, ...currentRelated]);
+    const selfNumber = this.extractSpecNumber(spec.name);
+    const detectedRefs = this.detectReferences(bodyContent, selfNumber);
+    const missingDependsOn = [];
+    const missingRelated = [];
+    for (const ref of detectedRefs) {
+      if (allCurrentDeps.has(ref.specNumber)) continue;
+      if (this.existingSpecNumbers && !this.existingSpecNumbers.has(ref.specNumber)) continue;
+      if (ref.type === "depends_on") {
+        missingDependsOn.push(ref);
+      } else {
+        missingRelated.push(ref);
+      }
+    }
+    if (missingDependsOn.length > 0) {
+      const specNumbers = [...new Set(missingDependsOn.map((r) => r.specNumber))];
+      const issue = {
+        message: `Content references blocking dependencies not in frontmatter: ${specNumbers.join(", ")}`,
+        suggestion: `Run: lean-spec link ${spec.name} --depends-on ${specNumbers.join(" ")}`
+      };
+      if (this.strict) {
+        errors.push(issue);
+      } else {
+        warnings.push(issue);
+      }
+    }
+    if (missingRelated.length > 0) {
+      const specNumbers = [...new Set(missingRelated.map((r) => r.specNumber))];
+      const issue = {
+        message: `Content references related specs not in frontmatter: ${specNumbers.join(", ")}`,
+        suggestion: `Run: lean-spec link ${spec.name} --related ${specNumbers.join(" ")}`
+      };
+      if (this.strict) {
+        errors.push(issue);
+      } else {
+        warnings.push(issue);
+      }
+    }
+    return {
+      passed: errors.length === 0,
+      errors,
+      warnings
+    };
+  }
+  /**
+   * Normalize dependency field to array of spec numbers
+   */
+  normalizeDeps(deps) {
+    if (!deps) return [];
+    const depArray = Array.isArray(deps) ? deps : [deps];
+    return depArray.map((d) => {
+      const str = String(d);
+      const match = str.match(/(\d{3})/);
+      return match ? match[1] : str;
+    }).filter(Boolean);
+  }
+  /**
+   * Extract spec number from spec name (e.g., "045-unified-dashboard" -> "045")
+   */
+  extractSpecNumber(specName) {
+    const match = specName.match(/^(\d{3})/);
+    return match ? match[1] : null;
+  }
+  /**
+   * Detect spec references in content
+   */
+  detectReferences(content, selfNumber) {
+    const refs = [];
+    const seenNumbers = /* @__PURE__ */ new Set();
+    for (const pattern of DEPENDS_ON_PATTERNS) {
+      const matches = content.matchAll(new RegExp(pattern));
+      for (const match of matches) {
+        const specNumber = match[1];
+        if (specNumber && specNumber !== selfNumber && !seenNumbers.has(specNumber)) {
+          seenNumbers.add(specNumber);
+          refs.push({
+            specNumber,
+            type: "depends_on",
+            context: match[0].substring(0, 50)
+          });
+        }
+      }
+    }
+    for (const pattern of RELATED_PATTERNS) {
+      const matches = content.matchAll(new RegExp(pattern));
+      for (const match of matches) {
+        const specNumber = match[2] || match[1];
+        if (specNumber && specNumber !== selfNumber && !seenNumbers.has(specNumber)) {
+          seenNumbers.add(specNumber);
+          refs.push({
+            specNumber,
+            type: "related",
+            context: match[0].substring(0, 50)
+          });
+        }
+      }
+    }
+    for (const pattern of SPEC_REF_PATTERNS) {
+      const matches = content.matchAll(new RegExp(pattern));
+      for (const match of matches) {
+        const specNumber = match[1];
+        if (specNumber && specNumber !== selfNumber && !seenNumbers.has(specNumber)) {
+          seenNumbers.add(specNumber);
+          refs.push({
+            specNumber,
+            type: "related",
+            // Default to related for ambiguous refs
+            context: match[0].substring(0, 50)
+          });
+        }
+      }
+    }
+    return refs;
+  }
+};
 function groupIssuesByFile(results) {
   const fileMap = /* @__PURE__ */ new Map();
   const addIssue = (filePath, issue, spec) => {
@@ -4679,7 +4974,7 @@ Validating ${specs.length} specs...
 
 // src/commands/validate.ts
 function validateCommand() {
-  return new Command("validate").description("Validate specs for quality issues").argument("[specs...]", "Specific specs to validate (optional)").option("--max-lines <number>", "Custom line limit (default: 400)", parseInt).option("--verbose", "Show passing specs").option("--quiet", "Suppress warnings, only show errors").option("--format <format>", "Output format: default, json, compact", "default").option("--json", "Output as JSON (shorthand for --format json)").option("--rule <rule>", "Filter by specific rule name (e.g., max-lines, frontmatter)").option("--warnings-only", "Treat all issues as warnings, never fail (useful for CI pre-release checks)").action(async (specs, options) => {
+  return new Command("validate").description("Validate specs for quality issues").argument("[specs...]", "Specific specs to validate (optional)").option("--max-lines <number>", "Custom line limit (default: 400)", parseInt).option("--verbose", "Show passing specs").option("--quiet", "Suppress warnings, only show errors").option("--format <format>", "Output format: default, json, compact", "default").option("--json", "Output as JSON (shorthand for --format json)").option("--rule <rule>", "Filter by specific rule name (e.g., max-lines, frontmatter)").option("--warnings-only", "Treat all issues as warnings, never fail (useful for CI pre-release checks)").option("--check-deps", "Check for content/frontmatter dependency alignment").action(async (specs, options) => {
     const passed = await validateSpecs({
       maxLines: options.maxLines,
       specs: specs && specs.length > 0 ? specs : void 0,
@@ -4687,7 +4982,8 @@ function validateCommand() {
       quiet: options.quiet,
       format: options.json ? "json" : options.format,
       rule: options.rule,
-      warningsOnly: options.warningsOnly
+      warningsOnly: options.warningsOnly,
+      checkDeps: options.checkDeps
     });
     process.exit(passed ? 0 : 1);
   });
@@ -4727,6 +5023,17 @@ async function validateSpecs(options = {}) {
     new CorruptionValidator(),
     new SubSpecValidator({ maxLines: options.maxLines })
   ];
+  if (options.checkDeps) {
+    const activeSpecs = await loadAllSpecs({ includeArchived: false });
+    const existingSpecNumbers = /* @__PURE__ */ new Set();
+    for (const s of activeSpecs) {
+      const match = s.name.match(/^(\d{3})/);
+      if (match) {
+        existingSpecNumbers.add(match[1]);
+      }
+    }
+    validators.push(new DependencyAlignmentValidator({ existingSpecNumbers }));
+  }
   const results = [];
   for (const spec of specs) {
     let content;
@@ -7724,6 +8031,26 @@ function formatErrorMessage(prefix, error) {
   const errorMsg = error instanceof Error ? error.message : String(error);
   return `${prefix}: ${errorMsg}`;
 }
+function getStaleSpecs(board, thresholdDays = 7) {
+  const now = /* @__PURE__ */ new Date();
+  const staleSpecs = [];
+  for (const spec of board.columns["in-progress"]) {
+    const lastActivity = spec.updated_at || spec.created;
+    if (!lastActivity) continue;
+    try {
+      const activityDate = new Date(lastActivity);
+      const daysSinceActivity = Math.floor((now.getTime() - activityDate.getTime()) / (1e3 * 60 * 60 * 24));
+      if (daysSinceActivity >= thresholdDays) {
+        staleSpecs.push({
+          name: spec.name,
+          daysStale: daysSinceActivity
+        });
+      }
+    } catch {
+    }
+  }
+  return staleSpecs;
+}
 function specToData(spec) {
   return {
     name: spec.name,
@@ -7735,7 +8062,8 @@ function specToData(spec) {
     priority: spec.frontmatter.priority,
     assignee: spec.frontmatter.assignee,
     description: spec.frontmatter.description,
-    customFields: spec.frontmatter.custom
+    customFields: spec.frontmatter.custom,
+    updated_at: spec.frontmatter.updated_at
   };
 }
 function extractH1(content) {
@@ -7903,13 +8231,24 @@ function boardTool() {
       description: "Get Kanban board view of all specs organized by status. Use this to visualize workflow, see what's in progress, or identify bottlenecks. Returns specs grouped into planned/in-progress/complete/archived columns.",
       inputSchema: {},
       outputSchema: {
-        board: z.any()
+        board: z.any(),
+        warnings: z.array(z.string()).optional()
       }
     },
     async (_input, _extra) => {
       try {
         const board = await getBoardData();
-        const output = { board };
+        const staleSpecs = getStaleSpecs(board);
+        const warnings = [];
+        if (staleSpecs.length > 0) {
+          for (const spec of staleSpecs) {
+            warnings.push(`\u26A0\uFE0F Spec "${spec.name}" has been in-progress for ${spec.daysStale} days. Consider updating status.`);
+          }
+        }
+        const output = {
+          board,
+          ...warnings.length > 0 ? { warnings } : {}
+        };
         return {
           content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
           structuredContent: output
@@ -7989,7 +8328,8 @@ function createTool() {
       outputSchema: {
         success: z.boolean(),
         path: z.string(),
-        message: z.string()
+        message: z.string(),
+        reminder: z.string().optional()
       }
     },
     async (input, _extra) => {
@@ -8010,7 +8350,8 @@ function createTool() {
         const output = {
           success: true,
           path: capturedOutput.includes("Created:") ? capturedOutput.split("Created:")[1].split("\n")[0].trim() : "",
-          message: `Spec '${input.name}' created successfully`
+          message: `Spec '${input.name}' created successfully`,
+          reminder: "\u{1F4A1} Remember to update status to 'in-progress' when you start implementing! Use: update tool with status='in-progress'"
         };
         return {
           content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
@@ -8245,7 +8586,8 @@ function listTool() {
         includeArchived: z.boolean().optional().describe("Include archived specs in results (default: false). Set to true to see completed/archived work.")
       },
       outputSchema: {
-        specs: z.array(z.any())
+        specs: z.array(z.any()),
+        warnings: z.array(z.string()).optional()
       }
     },
     async (input, _extra) => {
@@ -8257,7 +8599,26 @@ function listTool() {
           assignee: input.assignee,
           includeArchived: input.includeArchived
         });
-        const output = { specs };
+        const warnings = [];
+        if (!input.status) {
+          const inProgressSpecs = specs.filter((s) => s.status === "in-progress");
+          const mockBoard = {
+            columns: {
+              planned: [],
+              "in-progress": inProgressSpecs,
+              complete: [],
+              archived: []
+            }
+          };
+          const staleSpecs = getStaleSpecs(mockBoard);
+          for (const spec of staleSpecs) {
+            warnings.push(`\u26A0\uFE0F Spec "${spec.name}" has been in-progress for ${spec.daysStale} days. Consider updating status.`);
+          }
+        }
+        const output = {
+          specs,
+          ...warnings.length > 0 ? { warnings } : {}
+        };
         return {
           content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
           structuredContent: output
@@ -8535,6 +8896,18 @@ function tokensTool() {
     }
   ];
 }
+function getStatusReminder(newStatus) {
+  switch (newStatus) {
+    case "in-progress":
+      return "\u{1F4A1} Spec marked in-progress. Remember to document decisions in the spec as you work, and update to 'complete' when done!";
+    case "complete":
+      return "\u2705 Spec marked complete! Consider: Did you document what you learned? Are there follow-up specs needed?";
+    case "planned":
+      return "\u{1F4CB} Spec marked as planned. Update to 'in-progress' before you start implementing!";
+    default:
+      return void 0;
+  }
+}
 function updateTool() {
   return [
     "update",
@@ -8550,7 +8923,8 @@ function updateTool() {
       },
       outputSchema: {
         success: z.boolean(),
-        message: z.string()
+        message: z.string(),
+        reminder: z.string().optional()
       }
     },
     async (input, _extra) => {
@@ -8566,9 +8940,11 @@ function updateTool() {
         if (input.tags !== void 0) updates.tags = input.tags;
         if (input.assignee !== void 0) updates.assignee = input.assignee;
         await updateSpec(input.specPath, updates);
+        const reminder = getStatusReminder(input.status);
         const output = {
           success: true,
-          message: `Spec updated successfully`
+          message: `Spec updated successfully`,
+          ...reminder ? { reminder } : {}
         };
         return {
           content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
@@ -8594,10 +8970,11 @@ function validateTool() {
     "validate",
     {
       title: "Validate Specs",
-      description: "Validate specifications for quality issues like excessive length, missing sections, or complexity problems. Use this before committing changes or for project health checks.",
+      description: "Validate specifications for quality issues like excessive length, missing sections, or complexity problems. Use this before committing changes or for project health checks. Use checkDeps to detect content/frontmatter dependency misalignment.",
       inputSchema: {
         specs: z.array(z.string()).optional().describe("Specific specs to validate. If omitted, validates all specs in the project."),
-        maxLines: z.number().optional().describe("Custom line limit for complexity checks (default: 400 lines).")
+        maxLines: z.number().optional().describe("Custom line limit for complexity checks (default: 400 lines)."),
+        checkDeps: z.boolean().optional().describe("Check for content/frontmatter dependency alignment. Detects when spec content references other specs but those references are not in frontmatter depends_on/related fields.")
       },
       outputSchema: {
         passed: z.boolean(),
@@ -8618,7 +8995,8 @@ function validateTool() {
         };
         const passed = await validateSpecs({
           maxLines: input.maxLines,
-          specs: input.specs
+          specs: input.specs,
+          checkDeps: input.checkDeps
         });
         const output = {
           passed,
@@ -8968,6 +9346,132 @@ Provide a clear, actionable summary that helps understand project health and nex
     })
   ];
 }
+
+// src/mcp/prompts/sdd-checkpoint.ts
+function sddCheckpointPrompt() {
+  return [
+    "checkpoint",
+    {
+      title: "SDD Compliance Checkpoint",
+      description: "Periodic reminder to verify SDD workflow compliance - check spec status, update progress, ensure specs are in sync"
+    },
+    () => ({
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: `## SDD Checkpoint \u2705
+
+**Before continuing, let's verify SDD compliance:**
+
+### Step 1: Review Current State
+Use the \`board\` tool to see project status and identify:
+- Specs marked "in-progress" - are they still being worked on?
+- Specs that should be "complete" but aren't marked
+- Any work being done without a spec
+
+### Step 2: Check Your Current Task
+For the work you're currently doing:
+- **Is there a spec for it?** If not, create one with \`create\`
+- **Is the status correct?** Update with \`update\` if needed
+- **Have you documented decisions?** Add notes to the spec
+
+### Step 3: Update Progress
+For any specs you've worked on:
+1. Update status if changed (\`planned\` \u2192 \`in-progress\` \u2192 \`complete\`)
+2. Document key decisions or changes in the spec content
+3. Link related specs if you discovered connections
+
+### Action Items
+Based on the board review:
+1. List any specs with stale status
+2. Identify work being done without specs
+3. Suggest status updates needed
+
+**Remember:** 
+- Specs track implementation, not documentation
+- Update status BEFORE starting work, AFTER completing
+- Keep specs in sync with actual progress`
+          }
+        }
+      ]
+    })
+  ];
+}
+
+// src/mcp/prompts/spec-creation-workflow.ts
+function specCreationWorkflowPrompt() {
+  return [
+    "create-spec",
+    {
+      title: "Create Spec with Dependencies",
+      description: "Complete workflow for creating a new spec including proper dependency linking. Prevents the common issue of content referencing specs without frontmatter links."
+    },
+    () => ({
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: `## Create Spec Workflow \u{1F4DD}
+
+Follow these steps to create a well-linked spec:
+
+### Step 1: Pre-Creation Research
+Before creating, use \`search\` to find related specs:
+- Search for similar features or components
+- Identify potential dependencies
+- Note specs to reference
+
+### Step 2: Create the Spec
+Use \`create\` with the spec details:
+\`\`\`
+create {
+  "name": "your-spec-name",
+  "title": "Human Readable Title",
+  "description": "Initial overview content...",
+  "priority": "medium",
+  "tags": ["relevant", "tags"]
+}
+\`\`\`
+
+### Step 3: Link Dependencies (CRITICAL)
+After creating, **immediately** link any referenced specs:
+
+For each spec mentioned in content:
+- "Depends on spec 045" \u2192 \`link { "spec": "your-spec", "dependsOn": ["045"] }\`
+- "Related to spec 072" \u2192 \`link { "spec": "your-spec", "related": ["072"] }\`
+- "See spec 110" \u2192 \`link { "spec": "your-spec", "related": ["110"] }\`
+
+### Step 4: Verify
+Use \`deps\` to verify all links are in place:
+\`\`\`
+deps { "spec": "your-spec" }
+\`\`\`
+
+### Step 5: Validate
+Run dependency alignment check:
+\`\`\`
+validate { "specs": ["your-spec"], "checkDeps": true }
+\`\`\`
+
+### Common Patterns to Link
+
+| Content Pattern | Link Type |
+|----------------|-----------|
+| "depends on", "blocked by", "requires" | dependsOn |
+| "related to", "see also", "similar to" | related |
+| "builds on" | dependsOn (if blocking) or related |
+| "## Related Specs" section | related (link each one) |
+
+**Remember:** Content and frontmatter must stay aligned!`
+          }
+        }
+      ]
+    })
+  ];
+}
 function updateSpecStatusPrompt() {
   return [
     "update-spec-status",
@@ -8999,6 +9503,8 @@ Use the \`update\` tool: \`update <spec> --status ${status}\``
 function registerPrompts(server) {
   server.registerPrompt(...projectProgressOverviewPrompt());
   server.registerPrompt(...planProjectRoadmapPrompt());
+  server.registerPrompt(...sddCheckpointPrompt());
+  server.registerPrompt(...specCreationWorkflowPrompt());
   server.registerPrompt(...updateSpecStatusPrompt());
 }
 
@@ -9034,5 +9540,5 @@ if (import.meta.url === `file://${process.argv[1]}`) {
 }
 
 export { analyzeCommand, archiveCommand, backfillCommand, boardCommand, checkCommand, compactCommand, createCommand, createMcpServer, depsCommand, examplesCommand, filesCommand, ganttCommand, initCommand, linkCommand, listCommand, mcpCommand, migrateCommand, openCommand, searchCommand, splitCommand, statsCommand, templatesCommand, timelineCommand, tokensCommand, uiCommand, unlinkCommand, updateCommand, validateCommand, viewCommand };
-//# sourceMappingURL=chunk-RTEGSMVL.js.map
-//# sourceMappingURL=chunk-RTEGSMVL.js.map
+//# sourceMappingURL=chunk-VWR4YMIR.js.map
+//# sourceMappingURL=chunk-VWR4YMIR.js.map