sdd-tool 0.4.0 → 0.5.1

package/dist/cli/index.js

@@ -128,10 +128,10 @@ var init_base = __esm({
     };
     FileSystemError = class extends SddError {
       path;
-      constructor(code, path20) {
-        super(code, formatMessage(code, path20), ExitCode.FILE_SYSTEM_ERROR);
+      constructor(code, path27) {
+        super(code, formatMessage(code, path27), ExitCode.FILE_SYSTEM_ERROR);
         this.name = "FileSystemError";
-        this.path = path20;
+        this.path = path27;
       }
     };
     ValidationError = class extends SddError {
@@ -2503,28 +2503,9 @@ sdd transition guide
 }
 
 // src/cli/commands/init.ts
-function registerInitCommand(program2) {
-  program2.command("init").description("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCD08\uAE30\uD654\uD569\uB2C8\uB2E4").option("-f, --force", "\uAE30\uC874 .sdd/ \uB514\uB809\uD1A0\uB9AC \uB36E\uC5B4\uC4F0\uAE30").action(async (options) => {
-    try {
-      await runInit(options);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
-  });
-}
-async function runInit(options) {
-  const cwd = process.cwd();
-  const sddPath = path2.join(cwd, ".sdd");
-  if (await directoryExists(sddPath)) {
-    if (!options.force) {
-      error(".sdd/ \uB514\uB809\uD1A0\uB9AC\uAC00 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4. --force \uC635\uC158\uC73C\uB85C \uB36E\uC5B4\uC4F8 \uC218 \uC788\uC2B5\uB2C8\uB2E4.");
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
-    warn("\uAE30\uC874 .sdd/ \uB514\uB809\uD1A0\uB9AC\uB97C \uB36E\uC5B4\uC501\uB2C8\uB2E4.");
-  }
-  info("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCD08\uAE30\uD654\uD569\uB2C8\uB2E4...");
-  const directories = [
+init_types();
+function getInitDirectories() {
+  return [
     ".sdd",
     ".sdd/specs",
     ".sdd/changes",
@@ -2533,48 +2514,10 @@ async function runInit(options) {
     ".claude",
     ".claude/commands"
   ];
-  for (const dir of directories) {
-    const result = await ensureDir(path2.join(cwd, dir));
-    if (!result.success) {
-      error(`\uB514\uB809\uD1A0\uB9AC \uC0DD\uC131 \uC2E4\uD328: ${dir}`);
-      process.exit(ExitCode.FILE_SYSTEM_ERROR);
-    }
-  }
-  await createDefaultFiles(cwd);
-  await copyTemplates(cwd);
-  await createClaudeCommands(cwd);
-  success2("SDD \uD504\uB85C\uC81D\uD2B8\uAC00 \uCD08\uAE30\uD654\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
-  newline();
-  info("\uC0DD\uC131\uB41C \uAD6C\uC870:");
-  listItem(".sdd/");
-  listItem("AGENTS.md", 1);
-  listItem("constitution.md", 1);
-  listItem("specs/", 1);
-  listItem("changes/", 1);
-  listItem("archive/", 1);
-  listItem("templates/", 1);
-  listItem(".claude/");
-  listItem("commands/", 1);
-  newline();
-  info("Claude \uC2AC\uB798\uC2DC \uCEE4\uB9E8\uB4DC:");
-  listItem("/sdd.start - \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC2DC\uC791 (\uD1B5\uD569 \uC9C4\uC785\uC810)");
-  listItem("/sdd.constitution - \uD504\uB85C\uC81D\uD2B8 \uC6D0\uCE59 \uAD00\uB9AC");
-  listItem("/sdd.new - \uC0C8 \uAE30\uB2A5 \uBA85\uC138 \uC791\uC131");
-  listItem("/sdd.plan - \uAD6C\uD604 \uACC4\uD68D \uC791\uC131");
-  listItem("/sdd.tasks - \uC791\uC5C5 \uBD84\uD574");
-  listItem("/sdd.implement - \uAD6C\uD604 \uC9C4\uD589");
-  listItem("/sdd.validate - \uC2A4\uD399 \uAC80\uC99D");
-  listItem("/sdd.status - \uC0C1\uD0DC \uD655\uC778");
-  listItem("/sdd.change - \uBCC0\uACBD \uC81C\uC548");
-  newline();
-  info("\uB2E4\uC74C \uB2E8\uACC4:");
-  listItem("constitution.md\uB97C \uC218\uC815\uD558\uC5EC \uD504\uB85C\uC81D\uD2B8 \uC6D0\uCE59\uC744 \uC815\uC758\uD558\uC138\uC694");
-  listItem("/sdd.new \uB85C \uCCAB \uBC88\uC9F8 \uAE30\uB2A5 \uBA85\uC138\uB97C \uC791\uC131\uD558\uC138\uC694");
 }
-async function createDefaultFiles(cwd) {
-  const projectName = path2.basename(cwd);
+function generateConstitutionContent(projectName) {
   const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const constitution = `---
+  return `---
 version: 1.0.0
 created: ${today}
 ---
@@ -2609,13 +2552,10 @@ created: ${today}
 
 - \uD14C\uC2A4\uD2B8 \uCEE4\uBC84\uB9AC\uC9C0: 80% \uC774\uC0C1(SHOULD)
 `;
-  await writeFile(path2.join(cwd, ".sdd", "constitution.md"), constitution);
-  const agents = generateAgentsMd({ projectName });
-  await writeFile(path2.join(cwd, ".sdd", "AGENTS.md"), agents);
 }
-async function copyTemplates(cwd) {
+function generateSpecTemplate() {
   const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const specTemplate = `---
+  return `---
 status: draft
 created: ${today}
 depends: null
@@ -2643,7 +2583,69 @@ depends: null
 
 \uCD94\uAC00 \uC124\uBA85\uC774\uB098 \uC81C\uC57D \uC870\uAC74
 `;
-  const proposalTemplate = `---
+}
+async function executeInit(projectPath, options) {
+  const sddPath = path2.join(projectPath, ".sdd");
+  const claudePath = path2.join(projectPath, ".claude");
+  if (await directoryExists(sddPath)) {
+    if (!options.force) {
+      return failure(new Error(".sdd/ \uB514\uB809\uD1A0\uB9AC\uAC00 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4. --force \uC635\uC158\uC73C\uB85C \uB36E\uC5B4\uC4F8 \uC218 \uC788\uC2B5\uB2C8\uB2E4."));
+    }
+  }
+  const directories = getInitDirectories();
+  const createdDirs = [];
+  for (const dir of directories) {
+    const result = await ensureDir(path2.join(projectPath, dir));
+    if (!result.success) {
+      return failure(new Error(`\uB514\uB809\uD1A0\uB9AC \uC0DD\uC131 \uC2E4\uD328: ${dir}`));
+    }
+    createdDirs.push(dir);
+  }
+  const createdFiles = [];
+  const projectName = path2.basename(projectPath);
+  const constitutionContent = generateConstitutionContent(projectName);
+  await writeFile(path2.join(sddPath, "constitution.md"), constitutionContent);
+  createdFiles.push(".sdd/constitution.md");
+  const agentsContent = generateAgentsMd({ projectName });
+  await writeFile(path2.join(sddPath, "AGENTS.md"), agentsContent);
+  createdFiles.push(".sdd/AGENTS.md");
+  const templateFiles = await createTemplateFiles(projectPath);
+  createdFiles.push(...templateFiles);
+  const commandFiles = await createCommandFiles(projectPath);
+  createdFiles.push(...commandFiles);
+  return success({
+    sddPath,
+    claudePath,
+    directories: createdDirs,
+    files: createdFiles
+  });
+}
+async function createTemplateFiles(projectPath) {
+  const templatesPath = path2.join(projectPath, ".sdd", "templates");
+  const files = [];
+  await writeFile(path2.join(templatesPath, "spec.md"), generateSpecTemplate());
+  files.push(".sdd/templates/spec.md");
+  await writeFile(path2.join(templatesPath, "proposal.md"), generateProposalTemplate());
+  files.push(".sdd/templates/proposal.md");
+  await writeFile(path2.join(templatesPath, "delta.md"), generateDeltaTemplate());
+  files.push(".sdd/templates/delta.md");
+  await writeFile(path2.join(templatesPath, "tasks.md"), generateTasksTemplate());
+  files.push(".sdd/templates/tasks.md");
+  return files;
+}
+async function createCommandFiles(projectPath) {
+  const commandsPath = path2.join(projectPath, ".claude", "commands");
+  const files = [];
+  const commands = generateClaudeCommands();
+  for (const cmd of commands) {
+    await writeFile(path2.join(commandsPath, `${cmd.name}.md`), cmd.content);
+    files.push(`.claude/commands/${cmd.name}.md`);
+  }
+  return files;
+}
+function generateProposalTemplate() {
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
 id: CHG-{{ID}}
 status: draft
 created: ${today}
@@ -2706,7 +2708,10 @@ created: ${today}
 - \uC601\uD5A5\uB3C4: \uB0AE\uC74C/\uC911\uAC04/\uB192\uC74C
 - \uBCF5\uC7A1\uB3C4: \uB0AE\uC74C/\uC911\uAC04/\uB192\uC74C
 `;
-  const deltaTemplate = `---
+}
+function generateDeltaTemplate() {
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
 proposal: CHG-{{ID}}
 created: ${today}
 ---
@@ -2737,7 +2742,10 @@ created: ${today}
 
 (\uC0AD\uC81C\uB418\uB294 \uC2A4\uD399 \uCC38\uC870)
 `;
-  const tasksTemplate = `---
+}
+function generateTasksTemplate() {
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  return `---
 spec: {{SPEC_ID}}
 created: ${today}
 ---
@@ -2788,19 +2796,57 @@ graph LR
 | [\u2192T] | \uD14C\uC2A4\uD2B8 \uD544\uC694 |
 | [US] | \uBD88\uD655\uC2E4/\uAC80\uD1A0 \uD544\uC694 |
 `;
-  await writeFile(path2.join(cwd, ".sdd", "templates", "spec.md"), specTemplate);
-  await writeFile(path2.join(cwd, ".sdd", "templates", "proposal.md"), proposalTemplate);
-  await writeFile(path2.join(cwd, ".sdd", "templates", "delta.md"), deltaTemplate);
-  await writeFile(path2.join(cwd, ".sdd", "templates", "tasks.md"), tasksTemplate);
 }
-async function createClaudeCommands(cwd) {
-  const commands = generateClaudeCommands();
-  for (const cmd of commands) {
-    await writeFile(
-      path2.join(cwd, ".claude", "commands", `${cmd.name}.md`),
-      cmd.content
-    );
+function registerInitCommand(program2) {
+  program2.command("init").description("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCD08\uAE30\uD654\uD569\uB2C8\uB2E4").option("-f, --force", "\uAE30\uC874 .sdd/ \uB514\uB809\uD1A0\uB9AC \uB36E\uC5B4\uC4F0\uAE30").action(async (options) => {
+    try {
+      await runInit(options);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+}
+async function runInit(options) {
+  const cwd = process.cwd();
+  if (await directoryExists(path2.join(cwd, ".sdd"))) {
+    if (options.force) {
+      warn("\uAE30\uC874 .sdd/ \uB514\uB809\uD1A0\uB9AC\uB97C \uB36E\uC5B4\uC501\uB2C8\uB2E4.");
+    }
+  }
+  info("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCD08\uAE30\uD654\uD569\uB2C8\uB2E4...");
+  const result = await executeInit(cwd, options);
+  if (!result.success) {
+    error(result.error.message);
+    process.exit(ExitCode.GENERAL_ERROR);
   }
+  success2("SDD \uD504\uB85C\uC81D\uD2B8\uAC00 \uCD08\uAE30\uD654\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
+  newline();
+  info("\uC0DD\uC131\uB41C \uAD6C\uC870:");
+  listItem(".sdd/");
+  listItem("AGENTS.md", 1);
+  listItem("constitution.md", 1);
+  listItem("specs/", 1);
+  listItem("changes/", 1);
+  listItem("archive/", 1);
+  listItem("templates/", 1);
+  listItem(".claude/");
+  listItem("commands/", 1);
+  newline();
+  info("Claude \uC2AC\uB798\uC2DC \uCEE4\uB9E8\uB4DC:");
+  listItem("/sdd.start - \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC2DC\uC791 (\uD1B5\uD569 \uC9C4\uC785\uC810)");
+  listItem("/sdd.constitution - \uD504\uB85C\uC81D\uD2B8 \uC6D0\uCE59 \uAD00\uB9AC");
+  listItem("/sdd.new - \uC0C8 \uAE30\uB2A5 \uBA85\uC138 \uC791\uC131");
+  listItem("/sdd.plan - \uAD6C\uD604 \uACC4\uD68D \uC791\uC131");
+  listItem("/sdd.tasks - \uC791\uC5C5 \uBD84\uD574");
+  listItem("/sdd.implement - \uAD6C\uD604 \uC9C4\uD589");
+  listItem("/sdd.validate - \uC2A4\uD399 \uAC80\uC99D");
+  listItem("/sdd.status - \uC0C1\uD0DC \uD655\uC778");
+  listItem("/sdd.change - \uBCC0\uACBD \uC81C\uC548");
+  newline();
+  info("\uB2E4\uC74C \uB2E8\uACC4:");
+  listItem("constitution.md\uB97C \uC218\uC815\uD558\uC5EC \uD504\uB85C\uC81D\uD2B8 \uC6D0\uCE59\uC744 \uC815\uC758\uD558\uC138\uC694");
+  listItem("/sdd.new \uB85C \uCCAB \uBC88\uC9F8 \uAE30\uB2A5 \uBA85\uC138\uB97C \uC791\uC131\uD558\uC138\uC694");
 }
 
 // src/cli/commands/validate.ts
@@ -3631,9 +3677,9 @@ async function validateSpecs(targetPath, options = {}) {
 async function findSpecFiles(dirPath) {
   const files = [];
   async function scanDir(dir) {
-    const { promises: fs12 } = await import("fs");
+    const { promises: fs15 } = await import("fs");
     try {
-      const entries = await fs12.readdir(dir, { withFileTypes: true });
+      const entries = await fs15.readdir(dir, { withFileTypes: true });
       for (const entry of entries) {
         const fullPath = path3.join(dir, entry.name);
         if (entry.isDirectory()) {
@@ -3661,26 +3707,15 @@ async function findSpecFiles(dirPath) {
 // src/cli/commands/validate.ts
 init_errors();
 init_fs();
-function registerValidateCommand(program2) {
-  program2.command("validate").description("\uC2A4\uD399 \uD30C\uC77C \uD615\uC2DD\uC744 \uAC80\uC99D\uD569\uB2C8\uB2E4").argument("[path]", "\uAC80\uC99D\uD560 \uD30C\uC77C \uB610\uB294 \uB514\uB809\uD1A0\uB9AC", "").option("-s, --strict", "\uACBD\uACE0\uB3C4 \uC5D0\uB7EC\uB85C \uCC98\uB9AC").option("-q, --quiet", "\uC694\uC57D\uB9CC \uCD9C\uB825").option("-l, --check-links", "\uCC38\uC870 \uB9C1\uD06C \uC720\uD6A8\uC131 \uAC80\uC0AC").option("-c, --constitution", "Constitution \uC704\uBC18 \uAC80\uC0AC (\uAE30\uBCF8\uAC12)").option("--no-constitution", "Constitution \uAC80\uC0AC \uAC74\uB108\uB6F0\uAE30").action(async (targetPath, options) => {
-    try {
-      await runValidate(targetPath, options);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
-  });
-}
-async function runValidate(targetPath, options) {
+init_types();
+async function createValidateContext(targetPath, options, sddRoot) {
   let resolvedPath;
   let specsRoot;
-  const sddRoot = await findSddRoot();
   if (targetPath) {
     resolvedPath = path4.resolve(targetPath);
   } else {
     if (!sddRoot) {
-      error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
-      process.exit(ExitCode.GENERAL_ERROR);
+      return failure(new Error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694."));
     }
     resolvedPath = path4.join(sddRoot, ".sdd", "specs");
   }
@@ -3693,39 +3728,75 @@ async function runValidate(targetPath, options) {
     const constitutionPath = path4.join(sddRoot, ".sdd", "constitution.md");
     hasConstitution = await fileExists(constitutionPath);
   }
+  return success({
+    resolvedPath,
+    specsRoot,
+    checkConstitution,
+    hasConstitution,
+    sddRoot: sddRoot || void 0
+  });
+}
+async function executeValidate(options, context) {
+  const result = await validateSpecs(context.resolvedPath, {
+    strict: options.strict,
+    checkLinks: options.checkLinks,
+    specsRoot: context.specsRoot,
+    checkConstitution: context.checkConstitution && context.hasConstitution,
+    sddRoot: context.sddRoot
+  });
+  if (!result.success) {
+    return failure(result.error);
+  }
+  return success(result.data);
+}
+function formatValidateSummary(result, useColors = true) {
+  const { passed, failed, warnings } = result;
+  const passedText = useColors ? chalk2.green(`${passed} passed`) : `${passed} passed`;
+  const failedText = failed > 0 ? useColors ? chalk2.red(`${failed} failed`) : `${failed} failed` : `${failed} failed`;
+  const warningsText = warnings > 0 ? useColors ? chalk2.yellow(`${warnings} warnings`) : `${warnings} warnings` : "";
+  return [passedText, failedText, warningsText].filter(Boolean).join(", ");
+}
+function registerValidateCommand(program2) {
+  program2.command("validate").description("\uC2A4\uD399 \uD30C\uC77C \uD615\uC2DD\uC744 \uAC80\uC99D\uD569\uB2C8\uB2E4").argument("[path]", "\uAC80\uC99D\uD560 \uD30C\uC77C \uB610\uB294 \uB514\uB809\uD1A0\uB9AC", "").option("-s, --strict", "\uACBD\uACE0\uB3C4 \uC5D0\uB7EC\uB85C \uCC98\uB9AC").option("-q, --quiet", "\uC694\uC57D\uB9CC \uCD9C\uB825").option("-l, --check-links", "\uCC38\uC870 \uB9C1\uD06C \uC720\uD6A8\uC131 \uAC80\uC0AC").option("-c, --constitution", "Constitution \uC704\uBC18 \uAC80\uC0AC (\uAE30\uBCF8\uAC12)").option("--no-constitution", "Constitution \uAC80\uC0AC \uAC74\uB108\uB6F0\uAE30").action(async (targetPath, options) => {
+    try {
+      await runValidate(targetPath, options);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+}
+async function runValidate(targetPath, options) {
+  const sddRoot = await findSddRoot();
+  const contextResult = await createValidateContext(targetPath, options, sddRoot);
+  if (!contextResult.success) {
+    error(contextResult.error.message);
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  const context = contextResult.data;
   if (!options.quiet) {
-    info(`\uAC80\uC99D \uC911: ${resolvedPath}`);
+    info(`\uAC80\uC99D \uC911: ${context.resolvedPath}`);
     if (options.checkLinks) {
       info("(\uCC38\uC870 \uB9C1\uD06C \uAC80\uC99D \uD3EC\uD568)");
     }
-    if (checkConstitution && hasConstitution) {
+    if (context.checkConstitution && context.hasConstitution) {
       info("(Constitution \uC704\uBC18 \uAC80\uC0AC \uD3EC\uD568)");
     }
     newline();
   }
-  const result = await validateSpecs(resolvedPath, {
-    strict: options.strict,
-    checkLinks: options.checkLinks,
-    specsRoot,
-    checkConstitution: checkConstitution && hasConstitution,
-    sddRoot: sddRoot || void 0
-  });
+  const result = await executeValidate(options, context);
   if (!result.success) {
     error(result.error.message);
     process.exit(ExitCode.FILE_SYSTEM_ERROR);
   }
-  const { passed, failed, warnings, files } = result.data;
+  const { failed, files } = result.data;
   if (!options.quiet) {
     for (const file of files) {
-      printFileResult(file, resolvedPath);
+      printFileResult(file, context.resolvedPath);
     }
     newline();
   }
-  const passedText = chalk2.green(`${passed} passed`);
-  const failedText = failed > 0 ? chalk2.red(`${failed} failed`) : `${failed} failed`;
-  const warningsText = warnings > 0 ? chalk2.yellow(`${warnings} warnings`) : "";
-  const summary = [passedText, failedText, warningsText].filter(Boolean).join(", ");
-  console.log(`Result: ${summary}`);
+  console.log(`Result: ${formatValidateSummary(result.data)}`);
   if (failed > 0) {
     process.exit(ExitCode.VALIDATION_FAILED);
   }
@@ -4917,57 +4988,200 @@ async function listPendingChanges(sddPath) {
 // src/cli/commands/change.ts
 init_fs();
 init_errors();
-function registerChangeCommand(program2) {
-  const change = program2.command("change [id]").description("\uBCC0\uACBD \uC81C\uC548\uC744 \uC0DD\uC131\uD558\uAC70\uB098 \uAD00\uB9AC\uD569\uB2C8\uB2E4").option("-l, --list", "\uC9C4\uD589 \uC911\uC778 \uBCC0\uACBD \uBAA9\uB85D").option("-t, --title <title>", "\uBCC0\uACBD \uC81C\uC548 \uC81C\uBAA9").option("-s, --spec <spec>", "\uB300\uC0C1 \uC2A4\uD399 \uACBD\uB85C").action(async (id, options) => {
-    try {
-      await runChange(id, options);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
-  });
-  change.command("apply <id>").description("\uBCC0\uACBD \uC81C\uC548\uC744 \uC2A4\uD399\uC5D0 \uC801\uC6A9\uD569\uB2C8\uB2E4").action(async (id) => {
-    try {
-      await runApply(id);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
+init_types();
+async function getChangeListItems(sddPath) {
+  const result = await listPendingChanges(sddPath);
+  if (!result.success) {
+    return failure(result.error);
+  }
+  return success(result.data.map((change) => ({
+    id: change.id,
+    title: change.title || null,
+    status: change.status
+  })));
+}
+async function getChangeInfo(changePath) {
+  const proposalPath = path6.join(changePath, "proposal.md");
+  if (!await fileExists(proposalPath)) {
+    return failure(new Error("proposal.md\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const contentResult = await readFile(proposalPath);
+  if (!contentResult.success) {
+    return failure(new Error("proposal.md\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const parseResult = parseProposal(contentResult.data);
+  if (!parseResult.success) {
+    return failure(new Error(`proposal.md \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`));
+  }
+  return success({
+    id: parseResult.data.metadata.id,
+    title: parseResult.data.title,
+    status: parseResult.data.metadata.status,
+    created: parseResult.data.metadata.created,
+    affectedSpecs: parseResult.data.affectedSpecs
   });
-  change.command("archive <id>").description("\uC644\uB8CC\uB41C \uBCC0\uACBD\uC744 \uC544\uCE74\uC774\uBE0C\uD569\uB2C8\uB2E4").action(async (id) => {
-    try {
-      await runArchive(id);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
+}
+async function createChange(sddPath, options) {
+  const changesPath = path6.join(sddPath, "changes");
+  await ensureDir(changesPath);
+  const existingIds = [];
+  try {
+    const dirs = await fs3.readdir(changesPath);
+    existingIds.push(...dirs.filter((d) => d.startsWith("CHG-")));
+  } catch {
+  }
+  const newId = generateChangeId(existingIds);
+  const title2 = options.title || "\uC0C8 \uBCC0\uACBD \uC81C\uC548";
+  const affectedSpecs = options.spec ? [options.spec] : [];
+  const changePath = path6.join(changesPath, newId);
+  await ensureDir(changePath);
+  const proposal = generateProposal({
+    id: newId,
+    title: title2,
+    affectedSpecs
   });
-  change.command("diff <id>").description("\uBCC0\uACBD \uC81C\uC548\uC758 diff\uB97C \uD45C\uC2DC\uD569\uB2C8\uB2E4").action(async (id) => {
-    try {
-      await runDiff(id);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
+  const proposalPath = path6.join(changePath, "proposal.md");
+  await writeFile(proposalPath, proposal);
+  const delta = generateDelta({
+    proposalId: newId,
+    title: title2
   });
-  change.command("validate <id>").description("\uBCC0\uACBD \uC81C\uC548\uC758 \uC720\uD6A8\uC131\uC744 \uAC80\uC99D\uD569\uB2C8\uB2E4").action(async (id) => {
-    try {
-      await runValidateChange(id);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
+  const deltaPath = path6.join(changePath, "delta.md");
+  await writeFile(deltaPath, delta);
+  return success({
+    id: newId,
+    proposalPath,
+    deltaPath
   });
 }
-async function runChange(id, options) {
-  const projectRoot = await findSddRoot();
-  if (!projectRoot) {
-    error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
-    process.exit(ExitCode.GENERAL_ERROR);
+async function applyChange(changePath) {
+  const proposalPath = path6.join(changePath, "proposal.md");
+  if (!await fileExists(proposalPath)) {
+    return failure(new Error("proposal.md\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
   }
-  const sddPath = path6.join(projectRoot, ".sdd");
-  if (options.list) {
-    const result = await listPendingChanges(sddPath);
+  const contentResult = await readFile(proposalPath);
+  if (!contentResult.success) {
+    return failure(new Error("proposal.md\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const updateResult = updateProposalStatus(contentResult.data, "applied");
+  if (!updateResult.success) {
+    return failure(new Error("proposal.md\uB97C \uC5C5\uB370\uC774\uD2B8\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  await writeFile(proposalPath, updateResult.data);
+  return success(void 0);
+}
+async function getDeltaInfo(changePath) {
+  const deltaPath = path6.join(changePath, "delta.md");
+  if (!await fileExists(deltaPath)) {
+    return failure(new Error("delta.md\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const deltaResult = await readFile(deltaPath);
+  if (!deltaResult.success) {
+    return failure(new Error("delta.md\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const parseResult = parseDelta(deltaResult.data);
+  if (!parseResult.success) {
+    return failure(new Error(`Delta \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`));
+  }
+  return success({
+    added: parseResult.data.added,
+    modified: parseResult.data.modified,
+    removed: parseResult.data.removed
+  });
+}
+async function validateChange(changePath) {
+  const result = {
+    proposalValid: false,
+    deltaValid: false,
+    hasDelta: false
+  };
+  const proposalPath = path6.join(changePath, "proposal.md");
+  if (await fileExists(proposalPath)) {
+    const proposalResult = await readFile(proposalPath);
+    if (proposalResult.success) {
+      const parsed = parseProposal(proposalResult.data);
+      if (parsed.success) {
+        result.proposalValid = true;
+        result.proposalTitle = parsed.data.title;
+      } else {
+        result.proposalError = parsed.error.message;
+      }
+    }
+  } else {
+    result.proposalError = "proposal.md\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.";
+  }
+  const deltaPath = path6.join(changePath, "delta.md");
+  if (await fileExists(deltaPath)) {
+    result.hasDelta = true;
+    const deltaResult = await readFile(deltaPath);
+    if (deltaResult.success) {
+      const validation = validateDelta(deltaResult.data);
+      if (validation.valid) {
+        result.deltaValid = true;
+        const types = [];
+        if (validation.hasAdded) types.push("ADDED");
+        if (validation.hasModified) types.push("MODIFIED");
+        if (validation.hasRemoved) types.push("REMOVED");
+        result.deltaTypes = types;
+        result.deltaWarnings = validation.warnings;
+      } else {
+        result.deltaErrors = validation.errors;
+      }
+    }
+  }
+  return success(result);
+}
+function registerChangeCommand(program2) {
+  const change = program2.command("change [id]").description("\uBCC0\uACBD \uC81C\uC548\uC744 \uC0DD\uC131\uD558\uAC70\uB098 \uAD00\uB9AC\uD569\uB2C8\uB2E4").option("-l, --list", "\uC9C4\uD589 \uC911\uC778 \uBCC0\uACBD \uBAA9\uB85D").option("-t, --title <title>", "\uBCC0\uACBD \uC81C\uC548 \uC81C\uBAA9").option("-s, --spec <spec>", "\uB300\uC0C1 \uC2A4\uD399 \uACBD\uB85C").action(async (id, options) => {
+    try {
+      await runChange(id, options);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+  change.command("apply <id>").description("\uBCC0\uACBD \uC81C\uC548\uC744 \uC2A4\uD399\uC5D0 \uC801\uC6A9\uD569\uB2C8\uB2E4").action(async (id) => {
+    try {
+      await runApply(id);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+  change.command("archive <id>").description("\uC644\uB8CC\uB41C \uBCC0\uACBD\uC744 \uC544\uCE74\uC774\uBE0C\uD569\uB2C8\uB2E4").action(async (id) => {
+    try {
+      await runArchive(id);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+  change.command("diff <id>").description("\uBCC0\uACBD \uC81C\uC548\uC758 diff\uB97C \uD45C\uC2DC\uD569\uB2C8\uB2E4").action(async (id) => {
+    try {
+      await runDiff(id);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+  change.command("validate <id>").description("\uBCC0\uACBD \uC81C\uC548\uC758 \uC720\uD6A8\uC131\uC744 \uAC80\uC99D\uD569\uB2C8\uB2E4").action(async (id) => {
+    try {
+      await runValidateChange(id);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+}
+async function runChange(id, options) {
+  const projectRoot = await findSddRoot();
+  if (!projectRoot) {
+    error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  const sddPath = path6.join(projectRoot, ".sdd");
+  if (options.list) {
+    const result = await getChangeListItems(sddPath);
     if (!result.success) {
       error(result.error.message);
       process.exit(ExitCode.GENERAL_ERROR);
@@ -4985,53 +5199,31 @@ async function runChange(id, options) {
     return;
   }
   if (id) {
-    const changePath2 = path6.join(sddPath, "changes", id);
-    if (!await directoryExists(changePath2)) {
+    const changePath = path6.join(sddPath, "changes", id);
+    if (!await directoryExists(changePath)) {
       error(`\uBCC0\uACBD\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${id}`);
       process.exit(ExitCode.GENERAL_ERROR);
     }
-    const proposalPath = path6.join(changePath2, "proposal.md");
-    try {
-      const content = await fs3.readFile(proposalPath, "utf-8");
-      const parseResult = parseProposal(content);
-      if (parseResult.success) {
-        info(`\uBCC0\uACBD \uC81C\uC548: ${parseResult.data.title}`);
-        info(`\uC0C1\uD0DC: ${parseResult.data.metadata.status}`);
-        info(`\uC0DD\uC131: ${parseResult.data.metadata.created}`);
-        if (parseResult.data.affectedSpecs.length > 0) {
-          info("\uC601\uD5A5 \uC2A4\uD399:");
-          parseResult.data.affectedSpecs.forEach((spec) => listItem(spec, 1));
-        }
+    const infoResult = await getChangeInfo(changePath);
+    if (infoResult.success) {
+      info(`\uBCC0\uACBD \uC81C\uC548: ${infoResult.data.title}`);
+      info(`\uC0C1\uD0DC: ${infoResult.data.status}`);
+      info(`\uC0DD\uC131: ${infoResult.data.created}`);
+      if (infoResult.data.affectedSpecs.length > 0) {
+        info("\uC601\uD5A5 \uC2A4\uD399:");
+        infoResult.data.affectedSpecs.forEach((spec) => listItem(spec, 1));
       }
-    } catch {
-      error("proposal.md\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    } else {
+      error(infoResult.error.message);
     }
     return;
   }
-  const changesPath = path6.join(sddPath, "changes");
-  await ensureDir(changesPath);
-  const existingIds = [];
-  try {
-    const dirs = await fs3.readdir(changesPath);
-    existingIds.push(...dirs.filter((d) => d.startsWith("CHG-")));
-  } catch {
+  const createResult = await createChange(sddPath, options);
+  if (!createResult.success) {
+    error(createResult.error.message);
+    process.exit(ExitCode.GENERAL_ERROR);
   }
-  const newId = generateChangeId(existingIds);
-  const title2 = options.title || "\uC0C8 \uBCC0\uACBD \uC81C\uC548";
-  const affectedSpecs = options.spec ? [options.spec] : [];
-  const changePath = path6.join(changesPath, newId);
-  await ensureDir(changePath);
-  const proposal = generateProposal({
-    id: newId,
-    title: title2,
-    affectedSpecs
-  });
-  await writeFile(path6.join(changePath, "proposal.md"), proposal);
-  const delta = generateDelta({
-    proposalId: newId,
-    title: title2
-  });
-  await writeFile(path6.join(changePath, "delta.md"), delta);
+  const newId = createResult.data.id;
   success2(`\uBCC0\uACBD \uC81C\uC548\uC774 \uC0DD\uC131\uB418\uC5C8\uC2B5\uB2C8\uB2E4: ${newId}`);
   newline();
   info("\uC0DD\uC131\uB41C \uD30C\uC77C:");
@@ -5055,15 +5247,9 @@ async function runApply(id) {
     error(`\uBCC0\uACBD\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${id}`);
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const proposalPath = path6.join(changePath, "proposal.md");
-  try {
-    const content = await fs3.readFile(proposalPath, "utf-8");
-    const updateResult = updateProposalStatus(content, "applied");
-    if (updateResult.success) {
-      await fs3.writeFile(proposalPath, updateResult.data);
-    }
-  } catch {
-    error("proposal.md\uB97C \uC5C5\uB370\uC774\uD2B8\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  const result = await applyChange(changePath);
+  if (!result.success) {
+    error(result.error.message);
     process.exit(ExitCode.GENERAL_ERROR);
   }
   success2(`\uBCC0\uACBD\uC774 \uC801\uC6A9 \uC0C1\uD0DC\uB85C \uBCC0\uACBD\uB418\uC5C8\uC2B5\uB2C8\uB2E4: ${id}`);
@@ -5099,22 +5285,12 @@ async function runDiff(id) {
     error(`\uBCC0\uACBD\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${id}`);
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const deltaPath = path6.join(changePath, "delta.md");
-  if (!await fileExists(deltaPath)) {
-    error("delta.md\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    process.exit(ExitCode.GENERAL_ERROR);
-  }
-  const deltaResult = await readFile(deltaPath);
+  const deltaResult = await getDeltaInfo(changePath);
   if (!deltaResult.success) {
-    error("delta.md\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    error(deltaResult.error.message);
     process.exit(ExitCode.FILE_SYSTEM_ERROR);
   }
-  const parseResult = parseDelta(deltaResult.data);
-  if (!parseResult.success) {
-    error(`Delta \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
-  }
-  const delta = parseResult.data;
+  const delta = deltaResult.data;
   info(`\uBCC0\uACBD Diff: ${id}`);
   newline();
   if (delta.added.length > 0 && delta.added[0].content !== "(\uCD94\uAC00\uB418\uB294 \uC2A4\uD399 \uB0B4\uC6A9)") {
@@ -5162,44 +5338,35 @@ async function runValidateChange(id) {
     error(`\uBCC0\uACBD\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${id}`);
     process.exit(ExitCode.GENERAL_ERROR);
   }
+  const validationResult = await validateChange(changePath);
+  if (!validationResult.success) {
+    error(validationResult.error.message);
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  const result = validationResult.data;
   let hasErrors = false;
-  const proposalPath = path6.join(changePath, "proposal.md");
-  if (await fileExists(proposalPath)) {
-    const proposalResult = await readFile(proposalPath);
-    if (proposalResult.success) {
-      const parsed = parseProposal(proposalResult.data);
-      if (parsed.success) {
-        success2(`\u2713 proposal.md \uC720\uD6A8 (${parsed.data.title})`);
-      } else {
-        error(`\u2717 proposal.md \uC624\uB958: ${parsed.error.message}`);
-        hasErrors = true;
-      }
-    }
+  if (result.proposalValid) {
+    success2(`\u2713 proposal.md \uC720\uD6A8 (${result.proposalTitle})`);
   } else {
-    error("\u2717 proposal.md\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    error(`\u2717 proposal.md \uC624\uB958: ${result.proposalError}`);
     hasErrors = true;
   }
-  const deltaPath = path6.join(changePath, "delta.md");
-  if (await fileExists(deltaPath)) {
-    const deltaResult = await readFile(deltaPath);
-    if (deltaResult.success) {
-      const validation = validateDelta(deltaResult.data);
-      if (validation.valid) {
-        const types = [];
-        if (validation.hasAdded) types.push("ADDED");
-        if (validation.hasModified) types.push("MODIFIED");
-        if (validation.hasRemoved) types.push("REMOVED");
-        success2(`\u2713 delta.md \uC720\uD6A8 (${types.join(", ")})`);
-        for (const warning of validation.warnings) {
+  if (result.hasDelta) {
+    if (result.deltaValid) {
+      success2(`\u2713 delta.md \uC720\uD6A8 (${result.deltaTypes?.join(", ")})`);
+      if (result.deltaWarnings) {
+        for (const warning of result.deltaWarnings) {
           warn(`  \u26A0 ${warning}`);
         }
-      } else {
-        error(`\u2717 delta.md \uC624\uB958:`);
-        for (const error2 of validation.errors) {
+      }
+    } else {
+      error(`\u2717 delta.md \uC624\uB958:`);
+      if (result.deltaErrors) {
+        for (const error2 of result.deltaErrors) {
           error(`  - ${error2}`);
         }
-        hasErrors = true;
       }
+      hasErrors = true;
     }
   } else {
     warn("\u26A0 delta.md\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
@@ -5207,7 +5374,7 @@ async function runValidateChange(id) {
   newline();
   if (hasErrors) {
     error(`\uAC80\uC99D \uC2E4\uD328: ${id}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
+    process.exit(ExitCode.VALIDATION_FAILED);
   } else {
     success2(`\uAC80\uC99D \uD1B5\uACFC: ${id}`);
   }
@@ -5635,19 +5802,19 @@ function detectCircularDependencies(graph) {
   const cycles = [];
   const visited = /* @__PURE__ */ new Set();
   const recStack = /* @__PURE__ */ new Set();
-  function dfs(nodeId, path20) {
+  function dfs(nodeId, path27) {
     visited.add(nodeId);
     recStack.add(nodeId);
     const node = graph.nodes.get(nodeId);
     if (!node) return false;
     for (const depId of node.dependsOn) {
       if (!visited.has(depId)) {
-        if (dfs(depId, [...path20, nodeId])) {
+        if (dfs(depId, [...path27, nodeId])) {
           return true;
         }
       } else if (recStack.has(depId)) {
-        const cycleStart = path20.indexOf(depId);
-        const cycle = cycleStart >= 0 ? [...path20.slice(cycleStart), nodeId, depId] : [nodeId, depId];
+        const cycleStart = path27.indexOf(depId);
+        const cycle = cycleStart >= 0 ? [...path27.slice(cycleStart), nodeId, depId] : [nodeId, depId];
         cycles.push({
           cycle,
           description: `\uC21C\uD658 \uC758\uC874\uC131: ${cycle.join(" \u2192 ")}`
@@ -6635,6 +6802,108 @@ function formatCodeImpactResult(result) {
 // src/cli/commands/impact.ts
 init_fs();
 init_errors();
+init_types();
+function resolveProposalPath(proposalPath, sddPath) {
+  if (path10.isAbsolute(proposalPath)) {
+    return proposalPath;
+  }
+  const changesPath = path10.join(sddPath, "changes", proposalPath);
+  if (proposalPath.endsWith(".md")) {
+    return changesPath;
+  }
+  return path10.join(changesPath, "proposal.md");
+}
+async function executeImpactAnalysis(sddPath, feature) {
+  const result = await analyzeImpact(sddPath, feature);
+  if (!result.success) {
+    return failure(result.error);
+  }
+  return success(result.data);
+}
+async function executeGraphAnalysis(specsPath, feature, asJson = false) {
+  const graphResult = await buildDependencyGraph(specsPath);
+  if (!graphResult.success) {
+    return failure(graphResult.error);
+  }
+  const mermaid = generateMermaidGraph(graphResult.data, feature);
+  if (asJson) {
+    return success({
+      mermaid,
+      nodes: Array.from(graphResult.data.nodes.values()),
+      edges: graphResult.data.edges
+    });
+  }
+  return success({ mermaid });
+}
+async function executeCodeImpactAnalysis(projectRoot, sddPath, feature) {
+  const result = await analyzeCodeImpact(projectRoot, sddPath, feature);
+  if (!result.success) {
+    return failure(result.error);
+  }
+  return success(result.data);
+}
+async function executeImpactReport(sddPath) {
+  const result = await generateImpactReport(sddPath);
+  if (!result.success) {
+    return failure(result.error);
+  }
+  return success(result.data);
+}
+async function executeChangeImpact(sddPath, changeId) {
+  const result = await analyzeChangeImpact(sddPath, changeId);
+  if (!result.success) {
+    return failure(result.error);
+  }
+  return success(result.data);
+}
+function formatChangeImpactOutput(data) {
+  const lines = [];
+  lines.push(`\u{1F4CA} \uBCC0\uACBD \uC601\uD5A5 \uBD84\uC11D: ${data.changeId}`);
+  if (data.title) {
+    lines.push(`\uC81C\uBAA9: ${data.title}`);
+  }
+  lines.push(`\uC0C1\uD0DC: ${data.status}`);
+  lines.push("");
+  if (data.affectedSpecs.length > 0) {
+    lines.push("\u26A0\uFE0F  \uC9C1\uC811 \uC601\uD5A5 \uBC1B\uB294 \uC2A4\uD399:");
+    for (const spec of data.affectedSpecs) {
+      lines.push(`  - ${spec.id} - ${spec.reason}`);
+    }
+    lines.push("");
+  }
+  if (data.transitiveAffected.length > 0) {
+    lines.push("\u{1F504} \uAC04\uC811 \uC601\uD5A5 \uBC1B\uB294 \uC2A4\uD399:");
+    for (const spec of data.transitiveAffected) {
+      lines.push(`  - ${spec.id} (${spec.reason})`);
+    }
+    lines.push("");
+  }
+  const riskIcon = data.riskLevel === "high" ? "\u{1F534}" : data.riskLevel === "medium" ? "\u{1F7E1}" : "\u{1F7E2}";
+  lines.push(`\uCD1D \uC601\uD5A5 \uBC94\uC704: ${data.totalImpact}\uAC1C \uC2A4\uD399 ${riskIcon}`);
+  lines.push("");
+  if (data.recommendations.length > 0) {
+    lines.push("\u{1F4A1} \uAD8C\uC7A5\uC0AC\uD56D:");
+    for (const rec of data.recommendations) {
+      lines.push(`  - ${rec}`);
+    }
+  }
+  return lines.join("\n");
+}
+async function executeSimulation(specsPath, feature, proposalPath) {
+  const deltaResult = await parseDeltaFromProposal(proposalPath);
+  if (!deltaResult.success) {
+    return failure(deltaResult.error);
+  }
+  const deltas = deltaResult.data;
+  if (deltas.length === 0) {
+    return failure(new Error("\uBCC0\uACBD \uC81C\uC548\uC5D0\uC11C \uB378\uD0C0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const simResult = await runSimulation(specsPath, feature, deltas);
+  if (!simResult.success) {
+    return failure(simResult.error);
+  }
+  return success({ deltas, result: simResult.data });
+}
 function registerImpactCommand(program2) {
   const impact = program2.command("impact [feature]").description("\uC2A4\uD399 \uBCC0\uACBD\uC758 \uC601\uD5A5\uB3C4\uB97C \uBD84\uC11D\uD569\uB2C8\uB2E4").option("-g, --graph", "\uC758\uC874\uC131 \uADF8\uB798\uD504 \uCD9C\uB825 (Mermaid)").option("-r, --reverse", "\uC5ED\uBC29\uD5A5 \uC601\uD5A5\uB3C4 \uBD84\uC11D").option("-c, --code", "\uCF54\uB4DC \uC601\uD5A5\uB3C4 \uBD84\uC11D").option("--json", "JSON \uD615\uC2DD \uCD9C\uB825").action(async (feature, options) => {
     try {
@@ -6676,25 +6945,25 @@ async function runImpact(feature, options) {
     process.exit(ExitCode.GENERAL_ERROR);
   }
   const sddPath = path10.join(projectRoot, ".sdd");
+  const specsPath = path10.join(sddPath, "specs");
   if (options.graph) {
-    const graphResult = await buildDependencyGraph(path10.join(sddPath, "specs"));
+    const graphResult = await executeGraphAnalysis(specsPath, feature, options.json);
     if (!graphResult.success) {
       error(graphResult.error.message);
       process.exit(ExitCode.GENERAL_ERROR);
     }
-    const mermaid = generateMermaidGraph(graphResult.data, feature);
     if (options.json) {
       console.log(JSON.stringify({
         format: "mermaid",
-        content: mermaid,
-        nodes: Array.from(graphResult.data.nodes.values()),
+        content: graphResult.data.mermaid,
+        nodes: graphResult.data.nodes,
         edges: graphResult.data.edges
       }, null, 2));
     } else {
       info("\uC758\uC874\uC131 \uADF8\uB798\uD504 (Mermaid):");
       newline();
       console.log("```mermaid");
-      console.log(mermaid);
+      console.log(graphResult.data.mermaid);
       console.log("```");
     }
     return;
@@ -6708,7 +6977,7 @@ async function runImpact(feature, options) {
     }
     info(`\u{1F4BB} \uCF54\uB4DC \uC601\uD5A5\uB3C4 \uBD84\uC11D: ${feature}`);
     newline();
-    const codeResult = await analyzeCodeImpact(projectRoot, sddPath, feature);
+    const codeResult = await executeCodeImpactAnalysis(projectRoot, sddPath, feature);
     if (!codeResult.success) {
       error(codeResult.error.message);
       process.exit(ExitCode.GENERAL_ERROR);
@@ -6726,7 +6995,7 @@ async function runImpact(feature, options) {
     info("\uC608\uC2DC: sdd impact auth");
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const result = await analyzeImpact(sddPath, feature);
+  const result = await executeImpactAnalysis(sddPath, feature);
   if (!result.success) {
     error(result.error.message);
     process.exit(ExitCode.GENERAL_ERROR);
@@ -6744,7 +7013,7 @@ async function runImpactReport(options) {
     process.exit(ExitCode.GENERAL_ERROR);
   }
   const sddPath = path10.join(projectRoot, ".sdd");
-  const result = await generateImpactReport(sddPath);
+  const result = await executeImpactReport(sddPath);
   if (!result.success) {
     error(result.error.message);
     process.exit(ExitCode.GENERAL_ERROR);
@@ -6762,7 +7031,7 @@ async function runChangeImpact(changeId, options) {
     process.exit(ExitCode.GENERAL_ERROR);
   }
   const sddPath = path10.join(projectRoot, ".sdd");
-  const result = await analyzeChangeImpact(sddPath, changeId);
+  const result = await executeChangeImpact(sddPath, changeId);
   if (!result.success) {
     error(result.error.message);
     process.exit(ExitCode.GENERAL_ERROR);
@@ -6770,36 +7039,7 @@ async function runChangeImpact(changeId, options) {
   if (options.json) {
     console.log(JSON.stringify(result.data, null, 2));
   } else {
-    const data = result.data;
-    info(`\u{1F4CA} \uBCC0\uACBD \uC601\uD5A5 \uBD84\uC11D: ${data.changeId}`);
-    if (data.title) {
-      info(`\uC81C\uBAA9: ${data.title}`);
-    }
-    info(`\uC0C1\uD0DC: ${data.status}`);
-    newline();
-    if (data.affectedSpecs.length > 0) {
-      info("\u26A0\uFE0F  \uC9C1\uC811 \uC601\uD5A5 \uBC1B\uB294 \uC2A4\uD399:");
-      for (const spec of data.affectedSpecs) {
-        listItem(`${spec.id} - ${spec.reason}`, 1);
-      }
-      newline();
-    }
-    if (data.transitiveAffected.length > 0) {
-      info("\u{1F504} \uAC04\uC811 \uC601\uD5A5 \uBC1B\uB294 \uC2A4\uD399:");
-      for (const spec of data.transitiveAffected) {
-        listItem(`${spec.id} (${spec.reason})`, 1);
-      }
-      newline();
-    }
-    const riskIcon = data.riskLevel === "high" ? "\u{1F534}" : data.riskLevel === "medium" ? "\u{1F7E1}" : "\u{1F7E2}";
-    info(`\uCD1D \uC601\uD5A5 \uBC94\uC704: ${data.totalImpact}\uAC1C \uC2A4\uD399 ${riskIcon}`);
-    newline();
-    if (data.recommendations.length > 0) {
-      info("\u{1F4A1} \uAD8C\uC7A5\uC0AC\uD56D:");
-      for (const rec of data.recommendations) {
-        listItem(rec, 1);
-      }
-    }
+    console.log(formatChangeImpactOutput(result.data));
   }
 }
 async function runSimulate(feature, proposalPath, options) {
@@ -6810,65 +7050,208 @@ async function runSimulate(feature, proposalPath, options) {
   }
   const sddPath = path10.join(projectRoot, ".sdd");
   const specsPath = path10.join(sddPath, "specs");
-  let fullProposalPath = proposalPath;
-  if (!path10.isAbsolute(proposalPath)) {
-    const changesPath = path10.join(sddPath, "changes", proposalPath);
-    if (proposalPath.endsWith(".md")) {
-      fullProposalPath = changesPath;
-    } else {
-      fullProposalPath = path10.join(changesPath, "proposal.md");
-    }
-  }
+  const fullProposalPath = resolveProposalPath(proposalPath, sddPath);
   info(`\u{1F4CA} What-if \uC2DC\uBBAC\uB808\uC774\uC158`);
   info(`\uB300\uC0C1 \uC2A4\uD399: ${feature}`);
   info(`\uBCC0\uACBD \uC81C\uC548: ${fullProposalPath}`);
   newline();
-  const deltaResult = await parseDeltaFromProposal(fullProposalPath);
-  if (!deltaResult.success) {
-    error(deltaResult.error.message);
+  const result = await executeSimulation(specsPath, feature, fullProposalPath);
+  if (!result.success) {
+    if (result.error.message.includes("\uB378\uD0C0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4")) {
+      warn(result.error.message);
+      info("ADDED, MODIFIED, REMOVED \uC139\uC158\uC744 \uD655\uC778\uD558\uC138\uC694.");
+      return;
+    }
+    error(result.error.message);
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const deltas = deltaResult.data;
-  if (deltas.length === 0) {
-    warn("\uBCC0\uACBD \uC81C\uC548\uC5D0\uC11C \uB378\uD0C0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    info("ADDED, MODIFIED, REMOVED \uC139\uC158\uC744 \uD655\uC778\uD558\uC138\uC694.");
-    return;
-  }
+  const { deltas, result: simResult } = result.data;
   info(`\uAC10\uC9C0\uB41C \uBCC0\uACBD: ${deltas.length}\uAC74`);
   for (const delta of deltas) {
     const icon = delta.type === "ADDED" ? "\u2795" : delta.type === "REMOVED" ? "\u2796" : "\u270F\uFE0F";
     listItem(`${icon} ${delta.type}: ${delta.specId}`, 1);
   }
   newline();
-  const simResult = await runSimulation(specsPath, feature, deltas);
-  if (!simResult.success) {
-    error(simResult.error.message);
-    process.exit(ExitCode.GENERAL_ERROR);
-  }
   if (options.json) {
-    console.log(JSON.stringify(simResult.data, null, 2));
+    console.log(JSON.stringify(simResult, null, 2));
   } else {
-    console.log(formatSimulationResult(simResult.data, feature));
+    console.log(formatSimulationResult(simResult, feature));
   }
 }
 
 // src/cli/commands/new.ts
 init_new();
 import path12 from "path";
-import { promises as fs7 } from "fs";
 
 // src/utils/index.ts
 init_fs();
 
 // src/cli/commands/new.ts
 init_fs();
-function registerNewCommand(program2) {
-  const newCmd = program2.command("new").description("\uC0C8\uB85C\uC6B4 \uAE30\uB2A5 \uC0DD\uC131").argument("[name]", "\uAE30\uB2A5 \uC774\uB984").option("--title <title>", "\uAE30\uB2A5 \uC81C\uBAA9").option("--description <desc>", "\uAE30\uB2A5 \uC124\uBA85").option("--no-branch", "\uBE0C\uB79C\uCE58 \uC0DD\uC131 \uC548 \uD568").option("--numbered", "\uC790\uB3D9 \uBC88\uD638 \uBD80\uC5EC (feature/001-name \uD615\uC2DD)").option("--plan", "\uACC4\uD68D \uD30C\uC77C\uB3C4 \uD568\uAED8 \uC0DD\uC131").option("--tasks", "\uC791\uC5C5 \uBD84\uD574 \uD30C\uC77C\uB3C4 \uD568\uAED8 \uC0DD\uC131").option("--all", "\uBAA8\uB4E0 \uD30C\uC77C \uC0DD\uC131 (spec, plan, tasks)").option("--checklist", "\uCCB4\uD06C\uB9AC\uC2A4\uD2B8 \uD30C\uC77C \uC0DD\uC131").action(async (name, options) => {
-    await handleNew(name, options);
-  });
-  newCmd.command("plan").description("\uAE30\uB2A5 \uAD6C\uD604 \uACC4\uD68D \uC0DD\uC131").argument("<feature>", "\uAE30\uB2A5 ID").option("--title <title>", "\uACC4\uD68D \uC81C\uBAA9").action(async (feature, opts) => {
-    await handlePlan(feature, opts);
-  });
+init_types();
+async function getConstitutionVersion(sddPath) {
+  const constitutionPath = path12.join(sddPath, "constitution.md");
+  if (!await fileExists(constitutionPath)) {
+    return void 0;
+  }
+  const constResult = await readFile(constitutionPath);
+  if (!constResult.success) {
+    return void 0;
+  }
+  const parseResult = parseConstitution(constResult.data);
+  if (!parseResult.success) {
+    return void 0;
+  }
+  return parseResult.data.metadata.version;
+}
+async function createFeature(sddPath, name, options) {
+  let featureId;
+  let branchName;
+  if (options.numbered) {
+    const numberResult = await getNextFeatureNumber(sddPath, name);
+    if (!numberResult.success) {
+      return failure(new Error(`\uBC88\uD638 \uC0DD\uC131 \uC2E4\uD328: ${numberResult.error.message}`));
+    }
+    featureId = numberResult.data.fullId;
+    branchName = numberResult.data.branchName;
+  } else {
+    featureId = generateFeatureId(name);
+  }
+  const title2 = options.title || name;
+  const description = options.description || `${title2} \uAE30\uB2A5 \uBA85\uC138`;
+  const featurePath = path12.join(sddPath, "specs", featureId);
+  const dirResult = await ensureDir(featurePath);
+  if (!dirResult.success) {
+    return failure(new Error(`\uB514\uB809\uD1A0\uB9AC \uC0DD\uC131 \uC2E4\uD328: ${featurePath}`));
+  }
+  const constitutionVersion = await getConstitutionVersion(sddPath);
+  const filesCreated = [];
+  const specContent = generateSpec({
+    id: featureId,
+    title: title2,
+    description,
+    constitutionVersion
+  });
+  await writeFile(path12.join(featurePath, "spec.md"), specContent);
+  filesCreated.push("spec.md");
+  if (options.plan || options.all) {
+    const planContent = generatePlan({
+      featureId,
+      featureTitle: title2,
+      overview: description
+    });
+    await writeFile(path12.join(featurePath, "plan.md"), planContent);
+    filesCreated.push("plan.md");
+  }
+  if (options.tasks || options.all) {
+    const tasksContent = generateTasks({
+      featureId,
+      featureTitle: title2,
+      tasks: [
+        { title: "\uAE30\uBC18 \uAD6C\uC870 \uC124\uC815", priority: "high" },
+        { title: "\uD575\uC2EC \uAE30\uB2A5 \uAD6C\uD604", priority: "high" },
+        { title: "\uD14C\uC2A4\uD2B8 \uC791\uC131", priority: "medium" },
+        { title: "\uBB38\uC11C \uC5C5\uB370\uC774\uD2B8", priority: "low" }
+      ]
+    });
+    await writeFile(path12.join(featurePath, "tasks.md"), tasksContent);
+    filesCreated.push("tasks.md");
+  }
+  if (options.checklist || options.all) {
+    const checklistContent = generateFullChecklistMarkdown();
+    await writeFile(path12.join(featurePath, "checklist.md"), checklistContent);
+    filesCreated.push("checklist.md");
+  }
+  return success({
+    featureId,
+    featurePath,
+    branchName,
+    filesCreated
+  });
+}
+async function createPlan(featurePath, featureId, title2) {
+  if (!await fileExists(featurePath)) {
+    return failure(new Error(`\uAE30\uB2A5 '${featureId}'\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`));
+  }
+  let featureTitle = title2 || featureId;
+  const specPath = path12.join(featurePath, "spec.md");
+  if (await fileExists(specPath)) {
+    const specResult = await readFile(specPath);
+    if (specResult.success) {
+      const titleMatch = specResult.data.match(/title:\s*"?([^"\n]+)"?/);
+      if (titleMatch) {
+        featureTitle = titleMatch[1];
+      }
+    }
+  }
+  const planContent = generatePlan({
+    featureId,
+    featureTitle,
+    overview: `${featureTitle} \uAD6C\uD604 \uACC4\uD68D`
+  });
+  const planPath = path12.join(featurePath, "plan.md");
+  await writeFile(planPath, planContent);
+  return success(planPath);
+}
+async function createTasks(featurePath, featureId) {
+  if (!await fileExists(featurePath)) {
+    return failure(new Error(`\uAE30\uB2A5 '${featureId}'\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`));
+  }
+  let featureTitle = featureId;
+  const specPath = path12.join(featurePath, "spec.md");
+  if (await fileExists(specPath)) {
+    const specResult = await readFile(specPath);
+    if (specResult.success) {
+      const titleMatch = specResult.data.match(/title:\s*"?([^"\n]+)"?/);
+      if (titleMatch) {
+        featureTitle = titleMatch[1];
+      }
+    }
+  }
+  const tasksContent = generateTasks({
+    featureId,
+    featureTitle,
+    tasks: [
+      { title: "\uAE30\uBC18 \uAD6C\uC870 \uC124\uC815", priority: "high" },
+      { title: "\uD575\uC2EC \uAE30\uB2A5 \uAD6C\uD604", priority: "high" },
+      { title: "\uD14C\uC2A4\uD2B8 \uC791\uC131", priority: "medium" },
+      { title: "\uBB38\uC11C \uC5C5\uB370\uC774\uD2B8", priority: "low" }
+    ]
+  });
+  const tasksPath = path12.join(featurePath, "tasks.md");
+  await writeFile(tasksPath, tasksContent);
+  return success(tasksPath);
+}
+async function createChecklist2(sddPath) {
+  if (!await fileExists(sddPath)) {
+    return failure(new Error(".sdd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const checklistContent = generateFullChecklistMarkdown();
+  const outputPath = path12.join(sddPath, "checklist.md");
+  await writeFile(outputPath, checklistContent);
+  return success(outputPath);
+}
+async function getCounterStatus(sddPath) {
+  const peekResult = await peekNextFeatureNumber(sddPath);
+  if (!peekResult.success) {
+    return failure(new Error(`\uCE74\uC6B4\uD130 \uC870\uD68C \uC2E4\uD328: ${peekResult.error.message}`));
+  }
+  const historyResult = await getFeatureHistory(sddPath);
+  if (!historyResult.success) {
+    return failure(new Error(`\uC774\uB825 \uC870\uD68C \uC2E4\uD328: ${historyResult.error.message}`));
+  }
+  return success({
+    nextNumber: peekResult.data,
+    totalFeatures: historyResult.data.length
+  });
+}
+function registerNewCommand(program2) {
+  const newCmd = program2.command("new").description("\uC0C8\uB85C\uC6B4 \uAE30\uB2A5 \uC0DD\uC131").argument("[name]", "\uAE30\uB2A5 \uC774\uB984").option("--title <title>", "\uAE30\uB2A5 \uC81C\uBAA9").option("--description <desc>", "\uAE30\uB2A5 \uC124\uBA85").option("--no-branch", "\uBE0C\uB79C\uCE58 \uC0DD\uC131 \uC548 \uD568").option("--numbered", "\uC790\uB3D9 \uBC88\uD638 \uBD80\uC5EC (feature/001-name \uD615\uC2DD)").option("--plan", "\uACC4\uD68D \uD30C\uC77C\uB3C4 \uD568\uAED8 \uC0DD\uC131").option("--tasks", "\uC791\uC5C5 \uBD84\uD574 \uD30C\uC77C\uB3C4 \uD568\uAED8 \uC0DD\uC131").option("--all", "\uBAA8\uB4E0 \uD30C\uC77C \uC0DD\uC131 (spec, plan, tasks)").option("--checklist", "\uCCB4\uD06C\uB9AC\uC2A4\uD2B8 \uD30C\uC77C \uC0DD\uC131").action(async (name, options) => {
+    await handleNew(name, options);
+  });
+  newCmd.command("plan").description("\uAE30\uB2A5 \uAD6C\uD604 \uACC4\uD68D \uC0DD\uC131").argument("<feature>", "\uAE30\uB2A5 ID").option("--title <title>", "\uACC4\uD68D \uC81C\uBAA9").action(async (feature, opts) => {
+    await handlePlan(feature, opts);
+  });
   newCmd.command("tasks").description("\uC791\uC5C5 \uBD84\uD574 \uC0DD\uC131").argument("<feature>", "\uAE30\uB2A5 ID").action(async (feature) => {
     await handleTasks(feature);
   });
@@ -6886,193 +7269,88 @@ async function handleNew(name, options) {
   }
   const cwd = process.cwd();
   const sddPath = path12.join(cwd, ".sdd");
-  let featureId;
-  let branchName;
-  if (options.numbered) {
-    const numberResult = await getNextFeatureNumber(sddPath, name);
-    if (!numberResult.success) {
-      logger_exports.error(`\uBC88\uD638 \uC0DD\uC131 \uC2E4\uD328: ${numberResult.error.message}`);
-      process.exit(1);
-    }
-    featureId = numberResult.data.fullId;
-    branchName = numberResult.data.branchName;
-    logger_exports.info(`\uC790\uB3D9 \uBC88\uD638 \uBD80\uC5EC: #${numberResult.data.number.toString().padStart(3, "0")}`);
-  } else {
-    featureId = generateFeatureId(name);
+  if (!await fileExists(sddPath)) {
+    logger_exports.error(".sdd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 sdd init\uC744 \uC2E4\uD589\uD574\uC8FC\uC138\uC694.");
+    process.exit(1);
   }
-  const title2 = options.title || name;
-  const description = options.description || `${title2} \uAE30\uB2A5 \uBA85\uC138`;
-  const featurePath = path12.join(sddPath, "specs", featureId);
-  try {
-    if (!await fileExists(sddPath)) {
-      logger_exports.error(".sdd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 sdd init\uC744 \uC2E4\uD589\uD574\uC8FC\uC138\uC694.");
-      process.exit(1);
-    }
-    await ensureDir(featurePath);
-    let constitutionVersion;
-    const constitutionPath = path12.join(sddPath, "constitution.md");
-    if (await fileExists(constitutionPath)) {
-      const constResult = await readFile(constitutionPath);
-      if (constResult.success) {
-        const parseResult = parseConstitution(constResult.data);
-        if (parseResult.success) {
-          constitutionVersion = parseResult.data.metadata.version;
-        }
-      }
+  const result = await createFeature(sddPath, name, options);
+  if (!result.success) {
+    logger_exports.error(`\uAE30\uB2A5 \uC0DD\uC131 \uC2E4\uD328: ${result.error.message}`);
+    process.exit(1);
+  }
+  const { featureId, featurePath, branchName, filesCreated } = result.data;
+  if (options.numbered && branchName) {
+    const numberMatch = branchName.match(/feature\/(\d+)-/);
+    if (numberMatch) {
+      logger_exports.info(`\uC790\uB3D9 \uBC88\uD638 \uBD80\uC5EC: #${numberMatch[1]}`);
     }
-    const specContent = generateSpec({
-      id: featureId,
-      title: title2,
-      description,
-      constitutionVersion
-    });
-    await fs7.writeFile(path12.join(featurePath, "spec.md"), specContent, "utf-8");
-    logger_exports.info(`\u2705 \uBA85\uC138 \uC0DD\uC131: ${featurePath}/spec.md`);
-    if (options.branch !== false) {
-      if (await isGitRepository(cwd)) {
-        const branchToCreate = branchName || featureId;
-        const result = await createBranch(branchToCreate, { checkout: true, cwd });
-        if (result.success) {
-          logger_exports.info(`\u2705 \uBE0C\uB79C\uCE58 \uC0DD\uC131: ${result.data}`);
-        } else {
-          logger_exports.warn(`\u26A0\uFE0F \uBE0C\uB79C\uCE58 \uC0DD\uC131 \uC2E4\uD328: ${result.error.message}`);
-        }
+  }
+  for (const file of filesCreated) {
+    logger_exports.info(`\u2705 ${file} \uC0DD\uC131: ${featurePath}/${file}`);
+  }
+  if (options.branch !== false) {
+    if (await isGitRepository(cwd)) {
+      const branchToCreate = branchName || featureId;
+      const branchResult = await createBranch(branchToCreate, { checkout: true, cwd });
+      if (branchResult.success) {
+        logger_exports.info(`\u2705 \uBE0C\uB79C\uCE58 \uC0DD\uC131: ${branchResult.data}`);
       } else {
-        logger_exports.warn("\u26A0\uFE0F Git \uC800\uC7A5\uC18C\uAC00 \uC544\uB2D9\uB2C8\uB2E4. \uBE0C\uB79C\uCE58 \uC0DD\uC131\uC744 \uAC74\uB108\uB701\uB2C8\uB2E4.");
+        logger_exports.warn(`\u26A0\uFE0F \uBE0C\uB79C\uCE58 \uC0DD\uC131 \uC2E4\uD328: ${branchResult.error.message}`);
       }
+    } else {
+      logger_exports.warn("\u26A0\uFE0F Git \uC800\uC7A5\uC18C\uAC00 \uC544\uB2D9\uB2C8\uB2E4. \uBE0C\uB79C\uCE58 \uC0DD\uC131\uC744 \uAC74\uB108\uB701\uB2C8\uB2E4.");
     }
-    if (options.plan || options.all) {
-      const planContent = generatePlan({
-        featureId,
-        featureTitle: title2,
-        overview: description
-      });
-      await fs7.writeFile(path12.join(featurePath, "plan.md"), planContent, "utf-8");
-      logger_exports.info(`\u2705 \uACC4\uD68D \uC0DD\uC131: ${featurePath}/plan.md`);
-    }
-    if (options.tasks || options.all) {
-      const tasksContent = generateTasks({
-        featureId,
-        featureTitle: title2,
-        tasks: [
-          { title: "\uAE30\uBC18 \uAD6C\uC870 \uC124\uC815", priority: "high" },
-          { title: "\uD575\uC2EC \uAE30\uB2A5 \uAD6C\uD604", priority: "high" },
-          { title: "\uD14C\uC2A4\uD2B8 \uC791\uC131", priority: "medium" },
-          { title: "\uBB38\uC11C \uC5C5\uB370\uC774\uD2B8", priority: "low" }
-        ]
-      });
-      await fs7.writeFile(path12.join(featurePath, "tasks.md"), tasksContent, "utf-8");
-      logger_exports.info(`\u2705 \uC791\uC5C5 \uBD84\uD574 \uC0DD\uC131: ${featurePath}/tasks.md`);
-    }
-    if (options.checklist || options.all) {
-      const checklistContent = generateFullChecklistMarkdown();
-      await fs7.writeFile(path12.join(featurePath, "checklist.md"), checklistContent, "utf-8");
-      logger_exports.info(`\u2705 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8 \uC0DD\uC131: ${featurePath}/checklist.md`);
-    }
-    logger_exports.info("");
-    logger_exports.info(`\u{1F389} \uAE30\uB2A5 '${featureId}' \uC0DD\uC131 \uC644\uB8CC!`);
-    logger_exports.info("");
-    logger_exports.info("\uB2E4\uC74C \uB2E8\uACC4:");
-    logger_exports.info(`  1. ${featurePath}/spec.md \uD3B8\uC9D1`);
-    if (!(options.plan || options.all)) {
-      logger_exports.info("  2. sdd new plan " + featureId + " - \uACC4\uD68D \uC791\uC131");
-    }
-    if (!(options.tasks || options.all)) {
-      logger_exports.info("  3. sdd new tasks " + featureId + " - \uC791\uC5C5 \uBD84\uD574");
-    }
-    logger_exports.info("  4. sdd validate - \uBA85\uC138 \uAC80\uC99D");
-  } catch (error2) {
-    logger_exports.error(`\uAE30\uB2A5 \uC0DD\uC131 \uC2E4\uD328: ${error2}`);
-    process.exit(1);
   }
+  logger_exports.info("");
+  logger_exports.info(`\u{1F389} \uAE30\uB2A5 '${featureId}' \uC0DD\uC131 \uC644\uB8CC!`);
+  logger_exports.info("");
+  logger_exports.info("\uB2E4\uC74C \uB2E8\uACC4:");
+  logger_exports.info(`  1. ${featurePath}/spec.md \uD3B8\uC9D1`);
+  if (!(options.plan || options.all)) {
+    logger_exports.info("  2. sdd new plan " + featureId + " - \uACC4\uD68D \uC791\uC131");
+  }
+  if (!(options.tasks || options.all)) {
+    logger_exports.info("  3. sdd new tasks " + featureId + " - \uC791\uC5C5 \uBD84\uD574");
+  }
+  logger_exports.info("  4. sdd validate - \uBA85\uC138 \uAC80\uC99D");
 }
 async function handlePlan(feature, options) {
   const cwd = process.cwd();
   const featurePath = path12.join(cwd, ".sdd", "specs", feature);
-  try {
-    if (!await fileExists(featurePath)) {
-      logger_exports.error(`\uAE30\uB2A5 '${feature}'\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`);
-      process.exit(1);
-    }
-    let title2 = options.title || feature;
-    const specPath = path12.join(featurePath, "spec.md");
-    if (await fileExists(specPath)) {
-      const specContent = await fs7.readFile(specPath, "utf-8");
-      const titleMatch = specContent.match(/title:\s*"?([^"\n]+)"?/);
-      if (titleMatch) {
-        title2 = titleMatch[1];
-      }
-    }
-    const planContent = generatePlan({
-      featureId: feature,
-      featureTitle: title2,
-      overview: `${title2} \uAD6C\uD604 \uACC4\uD68D`
-    });
-    await fs7.writeFile(path12.join(featurePath, "plan.md"), planContent, "utf-8");
-    logger_exports.info(`\u2705 \uACC4\uD68D \uC0DD\uC131: ${featurePath}/plan.md`);
-    logger_exports.info("");
-    logger_exports.info("\uB2E4\uC74C \uB2E8\uACC4:");
-    logger_exports.info(`  1. ${featurePath}/plan.md \uD3B8\uC9D1`);
-    logger_exports.info("  2. sdd new tasks " + feature + " - \uC791\uC5C5 \uBD84\uD574");
-  } catch (error2) {
-    logger_exports.error(`\uACC4\uD68D \uC0DD\uC131 \uC2E4\uD328: ${error2}`);
+  const result = await createPlan(featurePath, feature, options.title);
+  if (!result.success) {
+    logger_exports.error(result.error.message);
     process.exit(1);
   }
+  logger_exports.info(`\u2705 \uACC4\uD68D \uC0DD\uC131: ${result.data}`);
+  logger_exports.info("");
+  logger_exports.info("\uB2E4\uC74C \uB2E8\uACC4:");
+  logger_exports.info(`  1. ${featurePath}/plan.md \uD3B8\uC9D1`);
+  logger_exports.info("  2. sdd new tasks " + feature + " - \uC791\uC5C5 \uBD84\uD574");
 }
 async function handleTasks(feature) {
   const cwd = process.cwd();
   const featurePath = path12.join(cwd, ".sdd", "specs", feature);
-  try {
-    if (!await fileExists(featurePath)) {
-      logger_exports.error(`\uAE30\uB2A5 '${feature}'\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`);
-      process.exit(1);
-    }
-    let title2 = feature;
-    const specPath = path12.join(featurePath, "spec.md");
-    if (await fileExists(specPath)) {
-      const specContent = await fs7.readFile(specPath, "utf-8");
-      const titleMatch = specContent.match(/title:\s*"?([^"\n]+)"?/);
-      if (titleMatch) {
-        title2 = titleMatch[1];
-      }
-    }
-    const tasksContent = generateTasks({
-      featureId: feature,
-      featureTitle: title2,
-      tasks: [
-        { title: "\uAE30\uBC18 \uAD6C\uC870 \uC124\uC815", priority: "high" },
-        { title: "\uD575\uC2EC \uAE30\uB2A5 \uAD6C\uD604", priority: "high" },
-        { title: "\uD14C\uC2A4\uD2B8 \uC791\uC131", priority: "medium" },
-        { title: "\uBB38\uC11C \uC5C5\uB370\uC774\uD2B8", priority: "low" }
-      ]
-    });
-    await fs7.writeFile(path12.join(featurePath, "tasks.md"), tasksContent, "utf-8");
-    logger_exports.info(`\u2705 \uC791\uC5C5 \uBD84\uD574 \uC0DD\uC131: ${featurePath}/tasks.md`);
-    logger_exports.info("");
-    logger_exports.info("\uB2E4\uC74C \uB2E8\uACC4:");
-    logger_exports.info(`  1. ${featurePath}/tasks.md \uD3B8\uC9D1`);
-    logger_exports.info("  2. \uAC01 \uC791\uC5C5 \uC21C\uCC28\uC801\uC73C\uB85C \uAD6C\uD604");
-  } catch (error2) {
-    logger_exports.error(`\uC791\uC5C5 \uBD84\uD574 \uC0DD\uC131 \uC2E4\uD328: ${error2}`);
+  const result = await createTasks(featurePath, feature);
+  if (!result.success) {
+    logger_exports.error(result.error.message);
     process.exit(1);
   }
+  logger_exports.info(`\u2705 \uC791\uC5C5 \uBD84\uD574 \uC0DD\uC131: ${result.data}`);
+  logger_exports.info("");
+  logger_exports.info("\uB2E4\uC74C \uB2E8\uACC4:");
+  logger_exports.info(`  1. ${featurePath}/tasks.md \uD3B8\uC9D1`);
+  logger_exports.info("  2. \uAC01 \uC791\uC5C5 \uC21C\uCC28\uC801\uC73C\uB85C \uAD6C\uD604");
 }
 async function handleChecklist() {
   const cwd = process.cwd();
   const sddPath = path12.join(cwd, ".sdd");
-  try {
-    if (!await fileExists(sddPath)) {
-      logger_exports.error(".sdd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 sdd init\uC744 \uC2E4\uD589\uD574\uC8FC\uC138\uC694.");
-      process.exit(1);
-    }
-    const checklistContent = generateFullChecklistMarkdown();
-    const outputPath = path12.join(sddPath, "checklist.md");
-    await fs7.writeFile(outputPath, checklistContent, "utf-8");
-    logger_exports.info(`\u2705 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8 \uC0DD\uC131: ${outputPath}`);
-  } catch (error2) {
-    logger_exports.error(`\uCCB4\uD06C\uB9AC\uC2A4\uD2B8 \uC0DD\uC131 \uC2E4\uD328: ${error2}`);
+  const result = await createChecklist2(sddPath);
+  if (!result.success) {
+    logger_exports.error(result.error.message);
     process.exit(1);
   }
+  logger_exports.info(`\u2705 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8 \uC0DD\uC131: ${result.data}`);
 }
 async function handleCounter(options) {
   const cwd = process.cwd();
@@ -7131,39 +7409,65 @@ async function handleCounter(options) {
     }
     return;
   }
-  const peekResult = await peekNextFeatureNumber(sddPath);
-  const historyResult = await getFeatureHistory(sddPath);
-  if (peekResult.success && historyResult.success) {
+  const statusResult = await getCounterStatus(sddPath);
+  if (statusResult.success) {
     logger_exports.info("=== \uAE30\uB2A5 \uBC88\uD638 \uCE74\uC6B4\uD130 \uC0C1\uD0DC ===");
     logger_exports.info("");
-    logger_exports.info(`\uB2E4\uC74C \uBC88\uD638: #${String(peekResult.data).padStart(3, "0")}`);
-    logger_exports.info(`\uC0DD\uC131\uB41C \uAE30\uB2A5 \uC218: ${historyResult.data.length}\uAC1C`);
+    logger_exports.info(`\uB2E4\uC74C \uBC88\uD638: #${String(statusResult.data.nextNumber).padStart(3, "0")}`);
+    logger_exports.info(`\uC0DD\uC131\uB41C \uAE30\uB2A5 \uC218: ${statusResult.data.totalFeatures}\uAC1C`);
     logger_exports.info("");
     logger_exports.info("\uC635\uC158:");
     logger_exports.info("  --peek     \uB2E4\uC74C \uBC88\uD638 \uD655\uC778");
     logger_exports.info("  --history  \uC0DD\uC131 \uC774\uB825 \uC870\uD68C");
     logger_exports.info("  --set <n>  \uB2E4\uC74C \uBC88\uD638 \uC124\uC815");
   } else {
-    logger_exports.error("\uCE74\uC6B4\uD130 \uC0C1\uD0DC \uC870\uD68C \uC2E4\uD328");
+    logger_exports.error(statusResult.error.message);
     process.exit(1);
   }
 }
 
 // src/cli/commands/status.ts
 import path13 from "path";
-import { promises as fs8 } from "fs";
+import { promises as fs7 } from "fs";
 init_fs();
 init_spec_generator();
 init_task_generator();
 init_branch();
-function registerStatusCommand(program2) {
-  program2.command("status").description("SDD \uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC \uC870\uD68C").option("--json", "JSON \uD615\uC2DD\uC73C\uB85C \uCD9C\uB825").option("--verbose", "\uC0C1\uC138 \uC815\uBCF4 \uCD9C\uB825").action(async (options) => {
-    await handleStatus(options);
-  });
+async function getFeatureInfo(id, featurePath) {
+  const info2 = {
+    id,
+    title: id,
+    status: "unknown",
+    hasSpec: false,
+    hasPlan: false,
+    hasTasks: false
+  };
+  const specPath = path13.join(featurePath, "spec.md");
+  if (await fileExists(specPath)) {
+    info2.hasSpec = true;
+    const content = await fs7.readFile(specPath, "utf-8");
+    const metadata = parseSpecMetadata(content);
+    if (metadata) {
+      info2.title = metadata.title;
+      info2.status = metadata.status;
+    }
+  }
+  info2.hasPlan = await fileExists(path13.join(featurePath, "plan.md"));
+  const tasksPath = path13.join(featurePath, "tasks.md");
+  if (await fileExists(tasksPath)) {
+    info2.hasTasks = true;
+    const content = await fs7.readFile(tasksPath, "utf-8");
+    const tasks = parseTasks(content);
+    const completed = tasks.filter((t) => t.status === "completed").length;
+    info2.taskProgress = {
+      completed,
+      total: tasks.length
+    };
+  }
+  return info2;
 }
-async function handleStatus(options) {
-  const cwd = process.cwd();
-  const sddPath = path13.join(cwd, ".sdd");
+async function getProjectStatus(projectPath) {
+  const sddPath = path13.join(projectPath, ".sdd");
   const status = {
     initialized: false,
     hasConstitution: false,
@@ -7175,13 +7479,7 @@ async function handleStatus(options) {
   };
   status.initialized = await fileExists(sddPath);
   if (!status.initialized) {
-    if (options.json) {
-      console.log(JSON.stringify(status, null, 2));
-    } else {
-      logger_exports.warn("SDD \uD504\uB85C\uC81D\uD2B8\uAC00 \uCD08\uAE30\uD654\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
-      logger_exports.info("sdd init \uBA85\uB839\uC5B4\uB85C \uCD08\uAE30\uD654\uD558\uC138\uC694.");
-    }
-    return;
+    return status;
   }
   status.hasConstitution = await fileExists(path13.join(sddPath, "constitution.md"));
   status.hasAgents = await fileExists(path13.join(sddPath, "AGENTS.md"));
@@ -7191,7 +7489,7 @@ async function handleStatus(options) {
     if (specsResult.success) {
       for (const entry of specsResult.data) {
         const featurePath = path13.join(specsPath, entry);
-        const stat = await fs8.stat(featurePath);
+        const stat = await fs7.stat(featurePath);
         if (stat.isDirectory()) {
           const featureInfo = await getFeatureInfo(entry, featurePath);
           status.features.push(featureInfo);
@@ -7207,53 +7505,57 @@ async function handleStatus(options) {
   if (archiveResult.success) {
     status.archivedChanges = archiveResult.data.length;
   }
-  const currentBranchResult = await getCurrentBranch(cwd);
+  const currentBranchResult = await getCurrentBranch(projectPath);
   if (currentBranchResult.success) {
     status.currentBranch = currentBranchResult.data;
   }
-  const featureBranchesResult = await listFeatureBranches(cwd);
+  const featureBranchesResult = await listFeatureBranches(projectPath);
   if (featureBranchesResult.success) {
     status.featureBranches = featureBranchesResult.data;
   }
+  return status;
+}
+function getStatusIcon(status) {
+  switch (status) {
+    case "draft":
+      return "\u{1F4DD}";
+    case "specified":
+      return "\u{1F4C4}";
+    case "planned":
+      return "\u{1F4CB}";
+    case "tasked":
+      return "\u270F\uFE0F";
+    case "implementing":
+      return "\u{1F528}";
+    case "completed":
+      return "\u2705";
+    default:
+      return "\u2753";
+  }
+}
+function registerStatusCommand(program2) {
+  program2.command("status").description("SDD \uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC \uC870\uD68C").option("--json", "JSON \uD615\uC2DD\uC73C\uB85C \uCD9C\uB825").option("--verbose", "\uC0C1\uC138 \uC815\uBCF4 \uCD9C\uB825").action(async (options) => {
+    await handleStatus(options);
+  });
+}
+async function handleStatus(options) {
+  const cwd = process.cwd();
+  const status = await getProjectStatus(cwd);
+  if (!status.initialized) {
+    if (options.json) {
+      console.log(JSON.stringify(status, null, 2));
+    } else {
+      logger_exports.warn("SDD \uD504\uB85C\uC81D\uD2B8\uAC00 \uCD08\uAE30\uD654\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
+      logger_exports.info("sdd init \uBA85\uB839\uC5B4\uB85C \uCD08\uAE30\uD654\uD558\uC138\uC694.");
+    }
+    return;
+  }
   if (options.json) {
     console.log(JSON.stringify(status, null, 2));
   } else {
     printStatus(status, options.verbose);
   }
 }
-async function getFeatureInfo(id, featurePath) {
-  const info2 = {
-    id,
-    title: id,
-    status: "unknown",
-    hasSpec: false,
-    hasPlan: false,
-    hasTasks: false
-  };
-  const specPath = path13.join(featurePath, "spec.md");
-  if (await fileExists(specPath)) {
-    info2.hasSpec = true;
-    const content = await fs8.readFile(specPath, "utf-8");
-    const metadata = parseSpecMetadata(content);
-    if (metadata) {
-      info2.title = metadata.title;
-      info2.status = metadata.status;
-    }
-  }
-  info2.hasPlan = await fileExists(path13.join(featurePath, "plan.md"));
-  const tasksPath = path13.join(featurePath, "tasks.md");
-  if (await fileExists(tasksPath)) {
-    info2.hasTasks = true;
-    const content = await fs8.readFile(tasksPath, "utf-8");
-    const tasks = parseTasks(content);
-    const completed = tasks.filter((t) => t.status === "completed").length;
-    info2.taskProgress = {
-      completed,
-      total: tasks.length
-    };
-  }
-  return info2;
-}
 function printStatus(status, verbose) {
   console.log("");
   console.log("\u{1F4CA} SDD \uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC");
@@ -7333,7 +7635,13 @@ function printStatus(status, verbose) {
   }
   console.log("");
 }
-function getStatusIcon(status) {
+
+// src/cli/commands/list.ts
+import path14 from "path";
+import { promises as fs8 } from "fs";
+init_fs();
+init_spec_generator();
+function getListStatusIcon(status) {
   switch (status) {
     case "draft":
       return "\u{1F4DD}";
@@ -7351,50 +7659,23 @@ function getStatusIcon(status) {
       return "\u2753";
   }
 }
-
-// src/cli/commands/list.ts
-import path14 from "path";
-import { promises as fs9 } from "fs";
-init_fs();
-init_spec_generator();
-function registerListCommand(program2) {
-  const listCmd = program2.command("list").alias("ls").description("\uD56D\uBAA9 \uBAA9\uB85D \uC870\uD68C");
-  listCmd.command("features").alias("f").description("\uAE30\uB2A5 \uBAA9\uB85D \uC870\uD68C").option("--status <status>", "\uC0C1\uD0DC\uBCC4 \uD544\uD130 (draft, specified, planned, etc.)").action(async (options) => {
-    await listFeatures(options);
-  });
-  listCmd.command("changes").alias("c").description("\uBCC0\uACBD \uC81C\uC548 \uBAA9\uB85D \uC870\uD68C").option("--pending", "\uB300\uAE30 \uC911\uC778 \uBCC0\uACBD\uB9CC \uD45C\uC2DC").option("--archived", "\uC544\uCE74\uC774\uBE0C\uB41C \uBCC0\uACBD\uB9CC \uD45C\uC2DC").action(async (options) => {
-    await listChanges(options);
-  });
-  listCmd.command("specs").alias("s").description("\uC2A4\uD399 \uD30C\uC77C \uBAA9\uB85D \uC870\uD68C").action(async () => {
-    await listSpecs();
-  });
-  listCmd.command("templates").alias("t").description("\uD15C\uD50C\uB9BF \uBAA9\uB85D \uC870\uD68C").action(async () => {
-    await listTemplates();
-  });
-  listCmd.action(async () => {
-    await listSummary();
-  });
-}
-async function listFeatures(options) {
-  const cwd = process.cwd();
-  const specsPath = path14.join(cwd, ".sdd", "specs");
+async function getFeatureList(projectPath, options = {}) {
+  const specsPath = path14.join(projectPath, ".sdd", "specs");
   if (!await fileExists(specsPath)) {
-    logger_exports.warn("\uC2A4\uD399 \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. sdd init\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
-    return;
+    return [];
   }
   const result = await readDir(specsPath);
   if (!result.success) {
-    logger_exports.error("\uC2A4\uD399 \uB514\uB809\uD1A0\uB9AC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    return;
+    return [];
   }
   const features = [];
   for (const entry of result.data) {
     const featurePath = path14.join(specsPath, entry);
-    const stat = await fs9.stat(featurePath);
+    const stat = await fs8.stat(featurePath);
     if (stat.isDirectory()) {
       const specPath = path14.join(featurePath, "spec.md");
       if (await fileExists(specPath)) {
-        const content = await fs9.readFile(specPath, "utf-8");
+        const content = await fs8.readFile(specPath, "utf-8");
         const metadata = parseSpecMetadata(content);
         if (metadata) {
           if (!options.status || metadata.status === options.status) {
@@ -7408,6 +7689,119 @@ async function listFeatures(options) {
       }
     }
   }
+  return features;
+}
+async function getChangeList(projectPath, options = {}) {
+  const sddPath = path14.join(projectPath, ".sdd");
+  const result = {
+    pending: [],
+    archived: []
+  };
+  if (!await fileExists(sddPath)) {
+    return result;
+  }
+  if (!options.archived) {
+    const pendingResult = await listPendingChanges(sddPath);
+    if (pendingResult.success) {
+      result.pending = pendingResult.data.map((c) => String(c));
+    }
+  }
+  if (!options.pending) {
+    const archiveResult = await listArchives(sddPath);
+    if (archiveResult.success) {
+      result.archived = archiveResult.data.map((a) => a.id);
+    }
+  }
+  return result;
+}
+async function getSpecFileTree(specsPath) {
+  if (!await fileExists(specsPath)) {
+    return [];
+  }
+  return walkSpecsTree(specsPath);
+}
+async function walkSpecsTree(basePath) {
+  const result = await readDir(basePath);
+  if (!result.success) return [];
+  const items = [];
+  for (const entry of result.data) {
+    const fullPath = path14.join(basePath, entry);
+    const stat = await fs8.stat(fullPath);
+    if (stat.isDirectory()) {
+      const children = await walkSpecsTree(fullPath);
+      items.push({
+        path: fullPath,
+        name: entry,
+        isDirectory: true,
+        children
+      });
+    } else if (entry.endsWith(".md")) {
+      items.push({
+        path: fullPath,
+        name: entry,
+        isDirectory: false
+      });
+    }
+  }
+  return items;
+}
+async function getTemplateList(projectPath) {
+  const templatesPath = path14.join(projectPath, ".sdd", "templates");
+  if (!await fileExists(templatesPath)) {
+    return [];
+  }
+  const result = await readDir(templatesPath);
+  if (!result.success) {
+    return [];
+  }
+  return result.data.filter((f) => f.endsWith(".md"));
+}
+async function getProjectSummary(projectPath) {
+  const sddPath = path14.join(projectPath, ".sdd");
+  if (!await fileExists(sddPath)) {
+    return null;
+  }
+  const specsPath = path14.join(sddPath, "specs");
+  let featureCount = 0;
+  if (await fileExists(specsPath)) {
+    const result = await readDir(specsPath);
+    if (result.success) {
+      for (const entry of result.data) {
+        const stat = await fs8.stat(path14.join(specsPath, entry));
+        if (stat.isDirectory()) featureCount++;
+      }
+    }
+  }
+  const pendingResult = await listPendingChanges(sddPath);
+  const pendingChangeCount = pendingResult.success ? pendingResult.data.length : 0;
+  const archiveResult = await listArchives(sddPath);
+  const archivedChangeCount = archiveResult.success ? archiveResult.data.length : 0;
+  return {
+    featureCount,
+    pendingChangeCount,
+    archivedChangeCount
+  };
+}
+function registerListCommand(program2) {
+  const listCmd = program2.command("list").alias("ls").description("\uD56D\uBAA9 \uBAA9\uB85D \uC870\uD68C");
+  listCmd.command("features").alias("f").description("\uAE30\uB2A5 \uBAA9\uB85D \uC870\uD68C").option("--status <status>", "\uC0C1\uD0DC\uBCC4 \uD544\uD130 (draft, specified, planned, etc.)").action(async (options) => {
+    await listFeatures(options);
+  });
+  listCmd.command("changes").alias("c").description("\uBCC0\uACBD \uC81C\uC548 \uBAA9\uB85D \uC870\uD68C").option("--pending", "\uB300\uAE30 \uC911\uC778 \uBCC0\uACBD\uB9CC \uD45C\uC2DC").option("--archived", "\uC544\uCE74\uC774\uBE0C\uB41C \uBCC0\uACBD\uB9CC \uD45C\uC2DC").action(async (options) => {
+    await listChanges(options);
+  });
+  listCmd.command("specs").alias("s").description("\uC2A4\uD399 \uD30C\uC77C \uBAA9\uB85D \uC870\uD68C").action(async () => {
+    await listSpecs();
+  });
+  listCmd.command("templates").alias("t").description("\uD15C\uD50C\uB9BF \uBAA9\uB85D \uC870\uD68C").action(async () => {
+    await listTemplates();
+  });
+  listCmd.action(async () => {
+    await listSummary();
+  });
+}
+async function listFeatures(options) {
+  const features = await getFeatureList(process.cwd(), options);
   if (features.length === 0) {
     logger_exports.info("\uAE30\uB2A5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
     return;
@@ -7416,25 +7810,19 @@ async function listFeatures(options) {
   console.log("\u{1F4CB} \uAE30\uB2A5 \uBAA9\uB85D");
   console.log("\u2500".repeat(50));
   for (const f of features) {
-    const statusIcon = getStatusIcon2(f.status);
+    const statusIcon = getListStatusIcon(f.status);
     console.log(`${statusIcon} ${f.title} (${f.id}) - ${f.status}`);
   }
   console.log("");
 }
 async function listChanges(options) {
-  const cwd = process.cwd();
-  const sddPath = path14.join(cwd, ".sdd");
-  if (!await fileExists(sddPath)) {
-    logger_exports.warn(".sdd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. sdd init\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
-    return;
-  }
+  const result = await getChangeList(process.cwd(), options);
   console.log("");
   if (!options.archived) {
-    const pendingResult = await listPendingChanges(sddPath);
-    if (pendingResult.success && pendingResult.data.length > 0) {
+    if (result.pending.length > 0) {
       console.log("\u{1F4DD} \uB300\uAE30 \uC911\uC778 \uBCC0\uACBD");
       console.log("\u2500".repeat(30));
-      for (const change of pendingResult.data) {
+      for (const change of result.pending) {
         console.log(`  - ${change}`);
       }
       console.log("");
@@ -7443,11 +7831,10 @@ async function listChanges(options) {
     }
   }
   if (!options.pending) {
-    const archiveResult = await listArchives(sddPath);
-    if (archiveResult.success && archiveResult.data.length > 0) {
+    if (result.archived.length > 0) {
       console.log("\u{1F4E6} \uC544\uCE74\uC774\uBE0C\uB41C \uBCC0\uACBD");
       console.log("\u2500".repeat(30));
-      for (const archive of archiveResult.data) {
+      for (const archive of result.archived) {
         console.log(`  - ${archive}`);
       }
       console.log("");
@@ -7457,80 +7844,56 @@ async function listChanges(options) {
   }
 }
 async function listSpecs() {
-  const cwd = process.cwd();
-  const specsPath = path14.join(cwd, ".sdd", "specs");
-  if (!await fileExists(specsPath)) {
+  const specsPath = path14.join(process.cwd(), ".sdd", "specs");
+  const tree = await getSpecFileTree(specsPath);
+  if (tree.length === 0) {
     logger_exports.warn("\uC2A4\uD399 \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
     return;
   }
   console.log("");
   console.log("\u{1F4C4} \uC2A4\uD399 \uD30C\uC77C \uBAA9\uB85D");
   console.log("\u2500".repeat(50));
-  await walkSpecs(specsPath, "");
+  printSpecTree(tree, "");
   console.log("");
 }
-async function walkSpecs(basePath, prefix) {
-  const result = await readDir(basePath);
-  if (!result.success) return;
-  for (const entry of result.data) {
-    const fullPath = path14.join(basePath, entry);
-    const stat = await fs9.stat(fullPath);
-    if (stat.isDirectory()) {
-      console.log(`${prefix}\u{1F4C1} ${entry}/`);
-      await walkSpecs(fullPath, prefix + "   ");
-    } else if (entry.endsWith(".md")) {
-      console.log(`${prefix}\u{1F4C4} ${entry}`);
+function printSpecTree(items, prefix) {
+  for (const item of items) {
+    if (item.isDirectory) {
+      console.log(`${prefix}\u{1F4C1} ${item.name}/`);
+      if (item.children) {
+        printSpecTree(item.children, prefix + "   ");
+      }
+    } else {
+      console.log(`${prefix}\u{1F4C4} ${item.name}`);
     }
   }
 }
 async function listTemplates() {
-  const cwd = process.cwd();
-  const templatesPath = path14.join(cwd, ".sdd", "templates");
-  if (!await fileExists(templatesPath)) {
+  const templates = await getTemplateList(process.cwd());
+  if (templates.length === 0) {
     logger_exports.warn("\uD15C\uD50C\uB9BF \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
     return;
   }
-  const result = await readDir(templatesPath);
-  if (!result.success) {
-    logger_exports.error("\uD15C\uD50C\uB9BF \uB514\uB809\uD1A0\uB9AC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    return;
-  }
   console.log("");
   console.log("\u{1F4D1} \uD15C\uD50C\uB9BF \uBAA9\uB85D");
   console.log("\u2500".repeat(30));
-  for (const template of result.data.filter((f) => f.endsWith(".md"))) {
+  for (const template of templates) {
     console.log(`  - ${template}`);
   }
   console.log("");
 }
 async function listSummary() {
-  const cwd = process.cwd();
-  const sddPath = path14.join(cwd, ".sdd");
-  if (!await fileExists(sddPath)) {
+  const summary = await getProjectSummary(process.cwd());
+  if (!summary) {
     logger_exports.warn(".sdd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. sdd init\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
     return;
   }
   console.log("");
   console.log("\u{1F4CA} SDD \uD504\uB85C\uC81D\uD2B8 \uC694\uC57D");
   console.log("\u2550".repeat(40));
-  const specsPath = path14.join(sddPath, "specs");
-  let featureCount = 0;
-  if (await fileExists(specsPath)) {
-    const result = await readDir(specsPath);
-    if (result.success) {
-      for (const entry of result.data) {
-        const stat = await fs9.stat(path14.join(specsPath, entry));
-        if (stat.isDirectory()) featureCount++;
-      }
-    }
-  }
-  console.log(`\u{1F4CB} \uAE30\uB2A5: ${featureCount}\uAC1C`);
-  const pendingResult = await listPendingChanges(sddPath);
-  const pendingCount = pendingResult.success ? pendingResult.data.length : 0;
-  console.log(`\u{1F4DD} \uB300\uAE30 \uC911\uC778 \uBCC0\uACBD: ${pendingCount}\uAC1C`);
-  const archiveResult = await listArchives(sddPath);
-  const archiveCount = archiveResult.success ? archiveResult.data.length : 0;
-  console.log(`\u{1F4E6} \uC544\uCE74\uC774\uBE0C\uB41C \uBCC0\uACBD: ${archiveCount}\uAC1C`);
+  console.log(`\u{1F4CB} \uAE30\uB2A5: ${summary.featureCount}\uAC1C`);
+  console.log(`\u{1F4DD} \uB300\uAE30 \uC911\uC778 \uBCC0\uACBD: ${summary.pendingChangeCount}\uAC1C`);
+  console.log(`\u{1F4E6} \uC544\uCE74\uC774\uBE0C\uB41C \uBCC0\uACBD: ${summary.archivedChangeCount}\uAC1C`);
   console.log("");
   console.log("\uC0C1\uC138 \uC815\uBCF4:");
   console.log("  sdd list features - \uAE30\uB2A5 \uBAA9\uB85D");
@@ -7539,29 +7902,134 @@ async function listSummary() {
   console.log("  sdd status        - \uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC");
   console.log("");
 }
-function getStatusIcon2(status) {
-  switch (status) {
-    case "draft":
-      return "\u{1F4DD}";
-    case "specified":
-      return "\u{1F4C4}";
-    case "planned":
-      return "\u{1F4CB}";
-    case "tasked":
-      return "\u270F\uFE0F";
-    case "implementing":
-      return "\u{1F528}";
-    case "completed":
-      return "\u2705";
-    default:
-      return "\u2753";
-  }
-}
 
 // src/cli/commands/constitution.ts
 init_fs();
 init_errors();
 import path15 from "path";
+init_types();
+function determineBumpType(options) {
+  if (options.major) return "major";
+  if (options.minor) return "minor";
+  if (options.patch) return "patch";
+  return null;
+}
+async function readConstitution(projectPath) {
+  const constitutionPath = path15.join(projectPath, ".sdd", "constitution.md");
+  if (!await fileExists(constitutionPath)) {
+    return failure(new Error("Constitution\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC73C\uB85C \uD504\uB85C\uC81D\uD2B8\uB97C \uCD08\uAE30\uD654\uD558\uC138\uC694."));
+  }
+  const contentResult = await readFile(constitutionPath);
+  if (!contentResult.success) {
+    return failure(new Error("Constitution \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const parseResult = parseConstitution(contentResult.data);
+  if (!parseResult.success) {
+    return failure(new Error(`Constitution \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`));
+  }
+  return success({
+    content: contentResult.data,
+    parsed: parseResult.data
+  });
+}
+function constitutionToJson(constitution) {
+  return {
+    projectName: constitution.projectName,
+    version: constitution.metadata.version,
+    created: constitution.metadata.created,
+    updated: constitution.metadata.updated,
+    principles: constitution.principles,
+    forbidden: constitution.forbidden,
+    techStack: constitution.techStack,
+    qualityStandards: constitution.qualityStandards
+  };
+}
+async function executeBump(projectPath, bumpType, message) {
+  const constitutionPath = path15.join(projectPath, ".sdd", "constitution.md");
+  const changelogPath = path15.join(projectPath, ".sdd", "CHANGELOG.md");
+  const readResult = await readConstitution(projectPath);
+  if (!readResult.success) {
+    return failure(readResult.error);
+  }
+  const { content, parsed } = readResult.data;
+  const currentVersion = parsed.metadata.version;
+  const newVersion = bumpVersion(currentVersion, bumpType);
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  let updatedContent = content;
+  updatedContent = updatedContent.replace(
+    /^version:\s*.+$/m,
+    `version: ${newVersion}`
+  );
+  if (/^updated:/m.test(updatedContent)) {
+    updatedContent = updatedContent.replace(
+      /^updated:\s*.+$/m,
+      `updated: ${today}`
+    );
+  } else {
+    updatedContent = updatedContent.replace(
+      /^(version:\s*.+)$/m,
+      `$1
+updated: ${today}`
+    );
+  }
+  await writeFile(constitutionPath, updatedContent);
+  const changeType = bumpType === "major" ? "changed" : bumpType === "minor" ? "added" : "fixed";
+  const changeDescription = message || `Constitution ${bumpType} \uC5C5\uB370\uC774\uD2B8`;
+  const newEntry = createChangelogEntry(
+    currentVersion,
+    bumpType,
+    [{ type: changeType, description: changeDescription }],
+    message
+  );
+  let existingEntries = [];
+  if (await fileExists(changelogPath)) {
+    const changelogContent = await readFile(changelogPath);
+    if (changelogContent.success) {
+      const parsed2 = parseChangelog(changelogContent.data);
+      if (parsed2.success) {
+        existingEntries = parsed2.data;
+      }
+    }
+  }
+  const allEntries = [newEntry, ...existingEntries];
+  const newChangelog = generateChangelog(allEntries);
+  await writeFile(changelogPath, newChangelog);
+  return success({
+    previousVersion: currentVersion,
+    newVersion,
+    changelogPath
+  });
+}
+async function executeValidateConstitution(projectPath) {
+  const readResult = await readConstitution(projectPath);
+  if (!readResult.success) {
+    return failure(readResult.error);
+  }
+  const validationResult = validateConstitution(readResult.data.parsed);
+  if (!validationResult.success) {
+    return failure(new Error(`Constitution \uAC80\uC99D \uC2E4\uD328: ${validationResult.error.message}`));
+  }
+  return success(readResult.data.parsed);
+}
+async function getHistory(projectPath, count = 10) {
+  const changelogPath = path15.join(projectPath, ".sdd", "CHANGELOG.md");
+  if (!await fileExists(changelogPath)) {
+    return success({ entries: [], totalCount: 0 });
+  }
+  const contentResult = await readFile(changelogPath);
+  if (!contentResult.success) {
+    return failure(new Error("CHANGELOG \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+  }
+  const parseResult = parseChangelog(contentResult.data);
+  if (!parseResult.success) {
+    return failure(new Error(`CHANGELOG \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`));
+  }
+  const entries = parseResult.data.slice(0, count);
+  return success({
+    entries,
+    totalCount: parseResult.data.length
+  });
+}
 function registerConstitutionCommand(program2) {
   const constitution = program2.command("constitution").description("Constitution(\uD504\uB85C\uC81D\uD2B8 \uC6D0\uCE59) \uAD00\uB9AC");
   constitution.command("show").description("\uD604\uC7AC Constitution \uB0B4\uC6A9 \uD45C\uC2DC").option("--json", "JSON \uD615\uC2DD\uC73C\uB85C \uCD9C\uB825").action(async (options) => {
@@ -7610,33 +8078,14 @@ function registerConstitutionCommand(program2) {
 }
 async function runShow(options) {
   const cwd = process.cwd();
-  const constitutionPath = path15.join(cwd, ".sdd", "constitution.md");
-  if (!await fileExists(constitutionPath)) {
-    error("Constitution\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC73C\uB85C \uD504\uB85C\uC81D\uD2B8\uB97C \uCD08\uAE30\uD654\uD558\uC138\uC694.");
-    process.exit(ExitCode.FILE_NOT_FOUND);
-  }
-  const contentResult = await readFile(constitutionPath);
-  if (!contentResult.success) {
-    error("Constitution \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  const result = await readConstitution(cwd);
+  if (!result.success) {
+    error(result.error.message);
     process.exit(ExitCode.FILE_SYSTEM_ERROR);
   }
-  const parseResult = parseConstitution(contentResult.data);
-  if (!parseResult.success) {
-    error(`Constitution \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
-  }
-  const constitution = parseResult.data;
+  const constitution = result.data.parsed;
   if (options.json) {
-    console.log(JSON.stringify({
-      projectName: constitution.projectName,
-      version: constitution.metadata.version,
-      created: constitution.metadata.created,
-      updated: constitution.metadata.updated,
-      principles: constitution.principles,
-      forbidden: constitution.forbidden,
-      techStack: constitution.techStack,
-      qualityStandards: constitution.qualityStandards
-    }, null, 2));
+    console.log(JSON.stringify(constitutionToJson(constitution), null, 2));
     return;
   }
   info(`Constitution: ${constitution.projectName}`);
@@ -7678,116 +8127,37 @@ async function runShow(options) {
 }
 async function runVersion() {
   const cwd = process.cwd();
-  const constitutionPath = path15.join(cwd, ".sdd", "constitution.md");
-  if (!await fileExists(constitutionPath)) {
-    error("Constitution\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    process.exit(ExitCode.FILE_NOT_FOUND);
-  }
-  const contentResult = await readFile(constitutionPath);
-  if (!contentResult.success) {
-    error("Constitution \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  const result = await readConstitution(cwd);
+  if (!result.success) {
+    error(result.error.message);
     process.exit(ExitCode.FILE_SYSTEM_ERROR);
   }
-  const parseResult = parseConstitution(contentResult.data);
-  if (!parseResult.success) {
-    error(`Constitution \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
-  }
-  console.log(parseResult.data.metadata.version);
+  console.log(result.data.parsed.metadata.version);
 }
 async function runBump(options) {
   const cwd = process.cwd();
-  const constitutionPath = path15.join(cwd, ".sdd", "constitution.md");
-  const changelogPath = path15.join(cwd, ".sdd", "CHANGELOG.md");
-  if (!await fileExists(constitutionPath)) {
-    error("Constitution\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    process.exit(ExitCode.FILE_NOT_FOUND);
-  }
-  let bumpType;
-  if (options.major) {
-    bumpType = "major";
-  } else if (options.minor) {
-    bumpType = "minor";
-  } else if (options.patch) {
-    bumpType = "patch";
-  } else {
+  const bumpType = determineBumpType(options);
+  if (!bumpType) {
     error("\uBC84\uC804 \uC720\uD615\uC744 \uC9C0\uC815\uD558\uC138\uC694: --major, --minor, \uB610\uB294 --patch");
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const contentResult = await readFile(constitutionPath);
-  if (!contentResult.success) {
-    error("Constitution \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  const result = await executeBump(cwd, bumpType, options.message);
+  if (!result.success) {
+    error(result.error.message);
     process.exit(ExitCode.FILE_SYSTEM_ERROR);
   }
-  const parseResult = parseConstitution(contentResult.data);
-  if (!parseResult.success) {
-    error(`Constitution \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
-  }
-  const currentVersion = parseResult.data.metadata.version;
-  const newVersion = bumpVersion(currentVersion, bumpType);
-  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  let updatedContent = contentResult.data;
-  updatedContent = updatedContent.replace(
-    /^version:\s*.+$/m,
-    `version: ${newVersion}`
-  );
-  if (/^updated:/m.test(updatedContent)) {
-    updatedContent = updatedContent.replace(
-      /^updated:\s*.+$/m,
-      `updated: ${today}`
-    );
-  } else {
-    updatedContent = updatedContent.replace(
-      /^(version:\s*.+)$/m,
-      `$1
-updated: ${today}`
-    );
-  }
-  await writeFile(constitutionPath, updatedContent);
-  const changeType = bumpType === "major" ? "changed" : bumpType === "minor" ? "added" : "fixed";
-  const changeDescription = options.message || `Constitution ${bumpType} \uC5C5\uB370\uC774\uD2B8`;
-  const newEntry = createChangelogEntry(
-    currentVersion,
-    bumpType,
-    [{ type: changeType, description: changeDescription }],
-    options.message
-  );
-  let existingEntries = [];
-  if (await fileExists(changelogPath)) {
-    const changelogContent = await readFile(changelogPath);
-    if (changelogContent.success) {
-      const parsed = parseChangelog(changelogContent.data);
-      if (parsed.success) {
-        existingEntries = parsed.data;
-      }
-    }
-  }
-  const allEntries = [newEntry, ...existingEntries];
-  const newChangelog = generateChangelog(allEntries);
-  await writeFile(changelogPath, newChangelog);
-  success2(`Constitution \uBC84\uC804 \uC5C5\uB370\uC774\uD2B8: ${currentVersion} \u2192 ${newVersion}`);
-  info(`CHANGELOG \uC5C5\uB370\uC774\uD2B8: ${changelogPath}`);
+  success2(`Constitution \uBC84\uC804 \uC5C5\uB370\uC774\uD2B8: ${result.data.previousVersion} \u2192 ${result.data.newVersion}`);
+  info(`CHANGELOG \uC5C5\uB370\uC774\uD2B8: ${result.data.changelogPath}`);
 }
 async function runHistory(options) {
   const cwd = process.cwd();
-  const changelogPath = path15.join(cwd, ".sdd", "CHANGELOG.md");
-  if (!await fileExists(changelogPath)) {
-    warn("CHANGELOG\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd constitution bump`\uB85C \uBC84\uC804\uC744 \uC5C5\uB370\uC774\uD2B8\uD558\uBA74 \uC0DD\uC131\uB429\uB2C8\uB2E4.");
-    return;
-  }
-  const contentResult = await readFile(changelogPath);
-  if (!contentResult.success) {
-    error("CHANGELOG \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  const count = parseInt(options.count, 10) || 10;
+  const result = await getHistory(cwd, count);
+  if (!result.success) {
+    error(result.error.message);
     process.exit(ExitCode.FILE_SYSTEM_ERROR);
   }
-  const parseResult = parseChangelog(contentResult.data);
-  if (!parseResult.success) {
-    error(`CHANGELOG \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
-  }
-  const count = parseInt(options.count, 10) || 10;
-  const entries = parseResult.data.slice(0, count);
+  const { entries } = result.data;
   if (entries.length === 0) {
     info("\uBCC0\uACBD \uC774\uB825\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
     return;
@@ -7807,36 +8177,22 @@ async function runHistory(options) {
 }
 async function runValidate2() {
   const cwd = process.cwd();
-  const constitutionPath = path15.join(cwd, ".sdd", "constitution.md");
-  if (!await fileExists(constitutionPath)) {
-    error("Constitution\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    process.exit(ExitCode.FILE_NOT_FOUND);
-  }
-  const contentResult = await readFile(constitutionPath);
-  if (!contentResult.success) {
-    error("Constitution \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    process.exit(ExitCode.FILE_SYSTEM_ERROR);
-  }
-  const parseResult = parseConstitution(contentResult.data);
-  if (!parseResult.success) {
-    error(`Constitution \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
-  }
-  const validationResult = validateConstitution(parseResult.data);
-  if (!validationResult.success) {
-    error(`Constitution \uAC80\uC99D \uC2E4\uD328: ${validationResult.error.message}`);
-    process.exit(ExitCode.VALIDATION_ERROR);
+  const result = await executeValidateConstitution(cwd);
+  if (!result.success) {
+    error(result.error.message);
+    process.exit(ExitCode.VALIDATION_FAILED);
   }
+  const constitution = result.data;
   success2("Constitution \uAC80\uC99D \uD1B5\uACFC");
-  info(`\uD504\uB85C\uC81D\uD2B8: ${parseResult.data.projectName}`);
-  info(`\uBC84\uC804: ${parseResult.data.metadata.version}`);
-  info(`\uC6D0\uCE59 \uC218: ${parseResult.data.principles.length}`);
-  info(`\uAE08\uC9C0 \uC0AC\uD56D \uC218: ${parseResult.data.forbidden.length}`);
+  info(`\uD504\uB85C\uC81D\uD2B8: ${constitution.projectName}`);
+  info(`\uBC84\uC804: ${constitution.metadata.version}`);
+  info(`\uC6D0\uCE59 \uC218: ${constitution.principles.length}`);
+  info(`\uAE08\uC9C0 \uC0AC\uD56D \uC218: ${constitution.forbidden.length}`);
 }
 
 // src/cli/commands/start.ts
 import path16 from "path";
-import { promises as fs10 } from "fs";
+import { promises as fs9 } from "fs";
 init_errors();
 init_fs();
 function registerStartCommand(program2) {
@@ -7850,7 +8206,7 @@ function registerStartCommand(program2) {
   });
 }
 async function runStart(options) {
-  const projectStatus = await getProjectStatus();
+  const projectStatus = await getProjectStatus2();
   if (!projectStatus.initialized) {
     info("SDD \uD504\uB85C\uC81D\uD2B8\uAC00 \uCD08\uAE30\uD654\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
     newline();
@@ -7874,7 +8230,7 @@ async function runStart(options) {
   newline();
   displayWorkflowMenu(projectStatus);
 }
-async function getProjectStatus() {
+async function getProjectStatus2() {
   const projectRoot = await findSddRoot();
   if (!projectRoot) {
     return {
@@ -7903,7 +8259,7 @@ async function getProjectStatus() {
   const specs = [];
   if (await directoryExists(specsPath)) {
     try {
-      const dirs = await fs10.readdir(specsPath);
+      const dirs = await fs9.readdir(specsPath);
       for (const dir of dirs) {
         const specPath = path16.join(specsPath, dir, "spec.md");
         if (await fileExists(specPath)) {
@@ -8139,12 +8495,354 @@ function displayConstitutionGuide() {
 }
 
 // src/cli/commands/migrate.ts
-import path17 from "path";
+import path18 from "path";
 import { promises as fs11 } from "fs";
 init_errors();
 init_fs();
 init_new();
 init_schemas();
+
+// src/core/migrate/detector.ts
+init_types();
+init_errors();
+init_fs();
+import path17 from "path";
+import fs10 from "fs/promises";
+async function detectExternalTools(projectRoot) {
+  try {
+    const results = [];
+    const openspecResult = await detectOpenSpec(projectRoot);
+    if (openspecResult) {
+      results.push(openspecResult);
+    }
+    const speckitResult = await detectSpecKit(projectRoot);
+    if (speckitResult) {
+      results.push(speckitResult);
+    }
+    const sddResult = await detectSdd(projectRoot);
+    if (sddResult) {
+      results.push(sddResult);
+    }
+    return success(results);
+  } catch (error2) {
+    return failure(new ChangeError(error2 instanceof Error ? error2.message : String(error2)));
+  }
+}
+async function detectOpenSpec(projectRoot) {
+  const openspecPath = path17.join(projectRoot, "openspec");
+  if (!await directoryExists(openspecPath)) {
+    return null;
+  }
+  const specsPath = path17.join(openspecPath, "specs");
+  const changesPath = path17.join(openspecPath, "changes");
+  const agentsPath = path17.join(openspecPath, "AGENTS.md");
+  const hasAgents = await fileExists(agentsPath);
+  const hasSpecs = await directoryExists(specsPath);
+  const hasChanges = await directoryExists(changesPath);
+  if (!hasSpecs && !hasChanges && !hasAgents) {
+    return null;
+  }
+  const specs = [];
+  if (hasSpecs) {
+    const specDirs = await fs10.readdir(specsPath, { withFileTypes: true });
+    for (const entry of specDirs) {
+      if (entry.isDirectory()) {
+        const specPath = path17.join(specsPath, entry.name);
+        const specFile = path17.join(specPath, "spec.md");
+        if (await fileExists(specFile)) {
+          const content = await fs10.readFile(specFile, "utf-8");
+          const title2 = extractTitle2(content);
+          const status = extractFrontmatterField(content, "status");
+          specs.push({
+            id: entry.name,
+            title: title2,
+            path: specPath,
+            status
+          });
+        }
+      }
+    }
+  }
+  return {
+    tool: "openspec",
+    path: openspecPath,
+    specCount: specs.length,
+    specs,
+    confidence: hasAgents ? "high" : hasSpecs && hasChanges ? "medium" : "low"
+  };
+}
+async function detectSpecKit(projectRoot) {
+  const specifyPath = path17.join(projectRoot, ".specify");
+  if (!await directoryExists(specifyPath)) {
+    return null;
+  }
+  const specsPath = path17.join(specifyPath, "specs");
+  const memoryPath = path17.join(projectRoot, "memory");
+  const constitutionPath = path17.join(memoryPath, "constitution.md");
+  const hasSpecs = await directoryExists(specsPath);
+  const hasConstitution = await fileExists(constitutionPath);
+  if (!hasSpecs) {
+    return null;
+  }
+  const specs = [];
+  const specDirs = await fs10.readdir(specsPath, { withFileTypes: true });
+  for (const entry of specDirs) {
+    if (entry.isDirectory()) {
+      const specPath = path17.join(specsPath, entry.name);
+      const specFile = path17.join(specPath, "spec.md");
+      const planFile = path17.join(specPath, "plan.md");
+      const tasksFile = path17.join(specPath, "tasks.md");
+      const hasSpec = await fileExists(specFile);
+      const hasPlan = await fileExists(planFile);
+      const hasTasks = await fileExists(tasksFile);
+      if (hasSpec || hasPlan) {
+        let title2;
+        let status;
+        if (hasSpec) {
+          const content = await fs10.readFile(specFile, "utf-8");
+          title2 = extractTitle2(content);
+          status = extractFrontmatterField(content, "status");
+        }
+        specs.push({
+          id: entry.name,
+          title: title2,
+          path: specPath,
+          status: hasTasks ? "in-progress" : status
+        });
+      }
+    }
+  }
+  return {
+    tool: "speckit",
+    path: specifyPath,
+    specCount: specs.length,
+    specs,
+    confidence: hasConstitution ? "high" : "medium"
+  };
+}
+async function detectSdd(projectRoot) {
+  const sddPath = path17.join(projectRoot, ".sdd");
+  if (!await directoryExists(sddPath)) {
+    return null;
+  }
+  const specsPath = path17.join(sddPath, "specs");
+  const configPath = path17.join(sddPath, "config.yaml");
+  if (!await directoryExists(specsPath)) {
+    return null;
+  }
+  const specs = [];
+  const specDirs = await fs10.readdir(specsPath, { withFileTypes: true });
+  for (const entry of specDirs) {
+    if (entry.isDirectory()) {
+      const specPath = path17.join(specsPath, entry.name);
+      const specFile = path17.join(specPath, "spec.md");
+      if (await fileExists(specFile)) {
+        const content = await fs10.readFile(specFile, "utf-8");
+        const title2 = extractTitle2(content);
+        const status = extractFrontmatterField(content, "status");
+        specs.push({
+          id: entry.name,
+          title: title2,
+          path: specPath,
+          status
+        });
+      }
+    }
+  }
+  return {
+    tool: "sdd",
+    path: sddPath,
+    specCount: specs.length,
+    specs,
+    confidence: await fileExists(configPath) ? "high" : "medium"
+  };
+}
+async function migrateFromOpenSpec(sourcePath, targetPath, options = {}) {
+  try {
+    const specsPath = path17.join(sourcePath, "specs");
+    const targetSpecsPath = path17.join(targetPath, "specs");
+    let specsCreated = 0;
+    let specsSkipped = 0;
+    const errors = [];
+    if (!await directoryExists(specsPath)) {
+      return failure(new ChangeError("OpenSpec specs \uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    }
+    const specDirs = await fs10.readdir(specsPath, { withFileTypes: true });
+    for (const entry of specDirs) {
+      if (!entry.isDirectory()) continue;
+      const sourceSpecPath = path17.join(specsPath, entry.name);
+      const targetSpecPath = path17.join(targetSpecsPath, entry.name);
+      if (await directoryExists(targetSpecPath)) {
+        if (!options.overwrite) {
+          specsSkipped++;
+          continue;
+        }
+      }
+      try {
+        if (!options.dryRun) {
+          await fs10.mkdir(targetSpecPath, { recursive: true });
+          const files = await fs10.readdir(sourceSpecPath);
+          for (const file of files) {
+            const sourceFile = path17.join(sourceSpecPath, file);
+            const targetFile = path17.join(targetSpecPath, file);
+            const stat = await fs10.stat(sourceFile);
+            if (stat.isFile()) {
+              let content = await fs10.readFile(sourceFile, "utf-8");
+              if (file === "spec.md") {
+                content = convertOpenSpecToSdd(content, entry.name);
+              }
+              await fs10.writeFile(targetFile, content);
+            }
+          }
+        }
+        specsCreated++;
+      } catch (error2) {
+        errors.push(`${entry.name}: ${error2 instanceof Error ? error2.message : String(error2)}`);
+      }
+    }
+    return success({
+      source: "openspec",
+      targetPath,
+      specsCreated,
+      specsSkipped,
+      errors
+    });
+  } catch (error2) {
+    return failure(new ChangeError(error2 instanceof Error ? error2.message : String(error2)));
+  }
+}
+async function migrateFromSpecKit(sourcePath, targetPath, options = {}) {
+  try {
+    const specsPath = path17.join(sourcePath, "specs");
+    const targetSpecsPath = path17.join(targetPath, "specs");
+    let specsCreated = 0;
+    let specsSkipped = 0;
+    const errors = [];
+    if (!await directoryExists(specsPath)) {
+      return failure(new ChangeError("Spec Kit specs \uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    }
+    const specDirs = await fs10.readdir(specsPath, { withFileTypes: true });
+    for (const entry of specDirs) {
+      if (!entry.isDirectory()) continue;
+      const sourceSpecPath = path17.join(specsPath, entry.name);
+      const targetSpecPath = path17.join(targetSpecsPath, entry.name);
+      if (await directoryExists(targetSpecPath)) {
+        if (!options.overwrite) {
+          specsSkipped++;
+          continue;
+        }
+      }
+      try {
+        if (!options.dryRun) {
+          await fs10.mkdir(targetSpecPath, { recursive: true });
+          const files = await fs10.readdir(sourceSpecPath);
+          for (const file of files) {
+            const sourceFile = path17.join(sourceSpecPath, file);
+            const targetFile = path17.join(targetSpecPath, file);
+            const stat = await fs10.stat(sourceFile);
+            if (stat.isFile()) {
+              let content = await fs10.readFile(sourceFile, "utf-8");
+              if (file === "spec.md") {
+                content = convertSpecKitToSdd(content, entry.name);
+              }
+              await fs10.writeFile(targetFile, content);
+            }
+          }
+        }
+        specsCreated++;
+      } catch (error2) {
+        errors.push(`${entry.name}: ${error2 instanceof Error ? error2.message : String(error2)}`);
+      }
+    }
+    return success({
+      source: "speckit",
+      targetPath,
+      specsCreated,
+      specsSkipped,
+      errors
+    });
+  } catch (error2) {
+    return failure(new ChangeError(error2 instanceof Error ? error2.message : String(error2)));
+  }
+}
+function convertOpenSpecToSdd(content, specId) {
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!frontmatterMatch) {
+    const title2 = extractTitle2(content) || specId;
+    return `---
+id: ${specId}
+title: ${title2}
+phase: migrated
+status: draft
+source: openspec
+migrated_at: ${(/* @__PURE__ */ new Date()).toISOString()}
+---
+
+${content}`;
+  }
+  let newFrontmatter = frontmatterMatch[1];
+  if (!newFrontmatter.includes("phase:")) {
+    newFrontmatter += "\nphase: migrated";
+  }
+  if (!newFrontmatter.includes("source:")) {
+    newFrontmatter += "\nsource: openspec";
+  }
+  if (!newFrontmatter.includes("migrated_at:")) {
+    newFrontmatter += `
+migrated_at: ${(/* @__PURE__ */ new Date()).toISOString()}`;
+  }
+  return content.replace(/^---\n[\s\S]*?\n---/, `---
+${newFrontmatter}
+---`);
+}
+function convertSpecKitToSdd(content, specId) {
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!frontmatterMatch) {
+    const title2 = extractTitle2(content) || specId;
+    return `---
+id: ${specId}
+title: ${title2}
+phase: migrated
+status: draft
+source: speckit
+migrated_at: ${(/* @__PURE__ */ new Date()).toISOString()}
+---
+
+${content}`;
+  }
+  let newFrontmatter = frontmatterMatch[1];
+  if (!newFrontmatter.includes("phase:")) {
+    newFrontmatter += "\nphase: migrated";
+  }
+  if (!newFrontmatter.includes("source:")) {
+    newFrontmatter += "\nsource: speckit";
+  }
+  if (!newFrontmatter.includes("migrated_at:")) {
+    newFrontmatter += `
+migrated_at: ${(/* @__PURE__ */ new Date()).toISOString()}`;
+  }
+  return content.replace(/^---\n[\s\S]*?\n---/, `---
+${newFrontmatter}
+---`);
+}
+function extractTitle2(content) {
+  const fmMatch = content.match(/^---\n[\s\S]*?title:\s*['"]?([^'"\n]+)['"]?\n[\s\S]*?\n---/);
+  if (fmMatch) {
+    return fmMatch[1].trim();
+  }
+  const h1Match = content.match(/^#\s+(.+)$/m);
+  if (h1Match) {
+    return h1Match[1].trim();
+  }
+  return void 0;
+}
+function extractFrontmatterField(content, field) {
+  const regex = new RegExp(`^---\\n[\\s\\S]*?${field}:\\s*['"]?([^'"\\n]+)['"]?\\n[\\s\\S]*?\\n---`);
+  const match = content.match(regex);
+  return match ? match[1].trim() : void 0;
+}
+
+// src/cli/commands/migrate.ts
 function registerMigrateCommand(program2) {
   const migrate = program2.command("migrate").description("\uAE30\uC874 \uBB38\uC11C\uB97C SDD \uD615\uC2DD\uC73C\uB85C \uB9C8\uC774\uADF8\uB808\uC774\uC158\uD569\uB2C8\uB2E4");
   migrate.command("docs <source>").description("\uB9C8\uD06C\uB2E4\uC6B4 \uBB38\uC11C\uB97C spec.md \uD615\uC2DD\uC73C\uB85C \uBCC0\uD658\uD569\uB2C8\uB2E4").option("-o, --output <dir>", "\uCD9C\uB825 \uB514\uB809\uD1A0\uB9AC").option("--dry-run", "\uC2E4\uC81C \uD30C\uC77C \uC0DD\uC131 \uC5C6\uC774 \uBBF8\uB9AC\uBCF4\uAE30").action(async (source, options) => {
@@ -8171,6 +8869,30 @@ function registerMigrateCommand(program2) {
       process.exit(ExitCode.GENERAL_ERROR);
     }
   });
+  migrate.command("detect").description("\uD504\uB85C\uC81D\uD2B8\uC5D0\uC11C \uC678\uBD80 SDD \uB3C4\uAD6C\uB97C \uAC10\uC9C0\uD569\uB2C8\uB2E4").option("-p, --path <path>", "\uAC80\uC0C9 \uACBD\uB85C").action(async (options) => {
+    try {
+      await runDetect(options);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+  migrate.command("openspec [source]").description("OpenSpec \uD504\uB85C\uC81D\uD2B8\uC5D0\uC11C \uB9C8\uC774\uADF8\uB808\uC774\uC158\uD569\uB2C8\uB2E4").option("--dry-run", "\uC2E4\uC81C \uD30C\uC77C \uC0DD\uC131 \uC5C6\uC774 \uBBF8\uB9AC\uBCF4\uAE30").option("--overwrite", "\uAE30\uC874 \uC2A4\uD399 \uB36E\uC5B4\uC4F0\uAE30").action(async (source, options) => {
+    try {
+      await runMigrateOpenSpec(source, options);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+  migrate.command("speckit [source]").description("Spec Kit \uD504\uB85C\uC81D\uD2B8\uC5D0\uC11C \uB9C8\uC774\uADF8\uB808\uC774\uC158\uD569\uB2C8\uB2E4").option("--dry-run", "\uC2E4\uC81C \uD30C\uC77C \uC0DD\uC131 \uC5C6\uC774 \uBBF8\uB9AC\uBCF4\uAE30").option("--overwrite", "\uAE30\uC874 \uC2A4\uD399 \uB36E\uC5B4\uC4F0\uAE30").action(async (source, options) => {
+    try {
+      await runMigrateSpecKit(source, options);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
 }
 async function runMigrateDocs(source, options) {
   const projectRoot = await findSddRoot();
@@ -8178,7 +8900,7 @@ async function runMigrateDocs(source, options) {
     error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. --output \uC635\uC158\uC744 \uC0AC\uC6A9\uD558\uAC70\uB098 sdd init\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const sourcePath = path17.resolve(source);
+  const sourcePath = path18.resolve(source);
   let files = [];
   try {
     const stat = await fs11.stat(sourcePath);
@@ -8197,7 +8919,7 @@ async function runMigrateDocs(source, options) {
   }
   info(`${files.length}\uAC1C \uD30C\uC77C \uBC1C\uACAC`);
   newline();
-  const outputDir = options.output ? path17.resolve(options.output) : path17.join(projectRoot, ".sdd", "specs");
+  const outputDir = options.output ? path18.resolve(options.output) : path18.join(projectRoot, ".sdd", "specs");
   const summary = {
     total: files.length,
     succeeded: 0,
@@ -8209,10 +8931,10 @@ async function runMigrateDocs(source, options) {
     summary.results.push(result);
     if (result.success) {
       summary.succeeded++;
-      info(`\u2705 ${path17.basename(file)} \u2192 ${result.target}`);
+      info(`\u2705 ${path18.basename(file)} \u2192 ${result.target}`);
     } else {
       summary.failed++;
-      error(`\u274C ${path17.basename(file)}: ${result.error}`);
+      error(`\u274C ${path18.basename(file)}: ${result.error}`);
     }
   }
   newline();
@@ -8226,23 +8948,23 @@ async function migrateDocument(filePath, outputDir, dryRun) {
   try {
     const content = await fs11.readFile(filePath, "utf-8");
     const analysis = analyzeDocument(content);
-    const featureId = generateFeatureId(analysis.title || path17.basename(filePath, ".md"));
+    const featureId = generateFeatureId(analysis.title || path18.basename(filePath, ".md"));
     const specContent = generateSpec({
       id: featureId,
-      title: analysis.title || path17.basename(filePath, ".md"),
+      title: analysis.title || path18.basename(filePath, ".md"),
       description: analysis.description || "",
       requirements: analysis.requirements,
       scenarios: analysis.scenarios
     });
-    const targetDir = path17.join(outputDir, featureId);
-    const targetPath = path17.join(targetDir, "spec.md");
+    const targetDir = path18.join(outputDir, featureId);
+    const targetPath = path18.join(targetDir, "spec.md");
     if (!dryRun) {
       await ensureDir(targetDir);
       await writeFile(targetPath, specContent);
     }
     return {
       source: filePath,
-      target: path17.relative(process.cwd(), targetPath),
+      target: path18.relative(process.cwd(), targetPath),
       success: true
     };
   } catch (error2) {
@@ -8287,14 +9009,14 @@ function analyzeDocument(content) {
   };
 }
 async function runAnalyze(file) {
-  const filePath = path17.resolve(file);
+  const filePath = path18.resolve(file);
   if (!await fileExists(filePath)) {
     error(`\uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${file}`);
     process.exit(ExitCode.FILE_SYSTEM_ERROR);
   }
   const content = await fs11.readFile(filePath, "utf-8");
   const analysis = analyzeDocument(content);
-  info(`\u{1F4CA} \uBB38\uC11C \uBD84\uC11D: ${path17.basename(file)}`);
+  info(`\u{1F4CA} \uBB38\uC11C \uBD84\uC11D: ${path18.basename(file)}`);
   newline();
   info(`\uC81C\uBAA9: ${analysis.title || "(\uC5C6\uC74C)"}`);
   info(`\uC124\uBA85: ${analysis.description || "(\uC5C6\uC74C)"}`);
@@ -8337,7 +9059,7 @@ async function runAnalyze(file) {
   }
 }
 async function runScan(dir, options) {
-  const dirPath = path17.resolve(dir);
+  const dirPath = path18.resolve(dir);
   if (!await directoryExists(dirPath)) {
     error(`\uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${dir}`);
     process.exit(ExitCode.FILE_SYSTEM_ERROR);
@@ -8368,7 +9090,7 @@ async function runScan(dir, options) {
   const partial = [];
   const notReady = [];
   for (const { file, analysis } of results) {
-    const relativePath = path17.relative(process.cwd(), file);
+    const relativePath = path18.relative(process.cwd(), file);
     if (analysis.hasRfc2119 && analysis.hasScenarios) {
       ready.push(relativePath);
     } else if (analysis.hasRfc2119 || analysis.hasScenarios || analysis.requirements.length > 0) {
@@ -8417,13 +9139,13 @@ async function collectFilesWithExtensions(dirPath, extensions) {
   async function scan(dir) {
     const entries = await fs11.readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = path17.join(dir, entry.name);
+      const fullPath = path18.join(dir, entry.name);
       if (entry.isDirectory()) {
         if (!["node_modules", ".git", ".sdd", "dist", "build"].includes(entry.name)) {
           await scan(fullPath);
         }
       } else if (entry.isFile()) {
-        const ext = path17.extname(entry.name).toLowerCase();
+        const ext = path18.extname(entry.name).toLowerCase();
         if (extensions.some((e) => e.toLowerCase() === ext)) {
           if (!["agents.md", "readme.md", "changelog.md", "license.md"].includes(entry.name.toLowerCase())) {
             files.push(fullPath);
@@ -8435,21 +9157,212 @@ async function collectFilesWithExtensions(dirPath, extensions) {
   await scan(dirPath);
   return files;
 }
-
-// src/cli/commands/cicd.ts
-import path18 from "path";
-init_errors();
-init_fs();
-function registerCicdCommand(program2) {
-  const cicd = program2.command("cicd").description("CI/CD \uD30C\uC774\uD504\uB77C\uC778 \uD1B5\uD569 \uC124\uC815");
-  cicd.command("setup [platform]").description("CI \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uD30C\uC77C\uC744 \uC0DD\uC131\uD569\uB2C8\uB2E4").option("--strict", "\uC5C4\uACA9 \uBAA8\uB4DC (\uACBD\uACE0\uB3C4 \uC5D0\uB7EC\uB85C \uCC98\uB9AC)").action(async (platform, options) => {
-    try {
-      await runSetup(platform || "github", options);
-    } catch (error2) {
-      error(error2 instanceof Error ? error2.message : String(error2));
-      process.exit(ExitCode.GENERAL_ERROR);
+async function runDetect(options) {
+  const projectRoot = options.path ? path18.resolve(options.path) : process.cwd();
+  info("\u{1F50D} \uC678\uBD80 SDD \uB3C4\uAD6C \uAC10\uC9C0 \uC911...");
+  info(`   \uACBD\uB85C: ${projectRoot}`);
+  newline();
+  const result = await detectExternalTools(projectRoot);
+  if (!result.success) {
+    error(result.error.message);
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  const tools = result.data;
+  if (tools.length === 0) {
+    info("\uAC10\uC9C0\uB41C \uC678\uBD80 SDD \uB3C4\uAD6C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    return;
+  }
+  for (const tool of tools) {
+    const icon = getToolIcon(tool.tool);
+    const confidence = getConfidenceLabel(tool.confidence);
+    info(`${icon} ${getToolName(tool.tool)}`);
+    info(`   \uACBD\uB85C: ${tool.path}`);
+    info(`   \uC2E0\uB8B0\uB3C4: ${confidence}`);
+    info(`   \uC2A4\uD399 \uC218: ${tool.specCount}\uAC1C`);
+    if (tool.specs.length > 0) {
+      newline();
+      info("   \uBC1C\uACAC\uB41C \uC2A4\uD399:");
+      for (const spec of tool.specs.slice(0, 5)) {
+        const status = spec.status ? ` [${spec.status}]` : "";
+        listItem(`${spec.id}: ${spec.title || "(\uC81C\uBAA9 \uC5C6\uC74C)"}${status}`, 2);
+      }
+      if (tool.specs.length > 5) {
+        info(`      ... \uC678 ${tool.specs.length - 5}\uAC1C`);
+      }
     }
-  });
+    newline();
+  }
+  const openspec = tools.find((t) => t.tool === "openspec");
+  const speckit = tools.find((t) => t.tool === "speckit");
+  if (openspec || speckit) {
+    info("\u{1F4A1} \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uBA85\uB839\uC5B4:");
+    if (openspec) {
+      listItem(`sdd migrate openspec "${openspec.path}"`, 1);
+    }
+    if (speckit) {
+      listItem(`sdd migrate speckit "${speckit.path}"`, 1);
+    }
+  }
+}
+async function runMigrateOpenSpec(source, options) {
+  const projectRoot = await findSddRoot();
+  if (!projectRoot) {
+    error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  let sourcePath;
+  if (source) {
+    sourcePath = path18.resolve(source);
+  } else {
+    const detectResult = await detectExternalTools(projectRoot);
+    if (!detectResult.success) {
+      error(detectResult.error.message);
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+    const openspec = detectResult.data.find((t) => t.tool === "openspec");
+    if (!openspec) {
+      error("OpenSpec \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uACBD\uB85C\uB97C \uC9C1\uC811 \uC9C0\uC815\uD558\uC138\uC694.");
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+    sourcePath = openspec.path;
+  }
+  const sddPath = path18.join(projectRoot, ".sdd");
+  info("\u{1F504} OpenSpec\uC5D0\uC11C \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uC911...");
+  info(`   \uC18C\uC2A4: ${sourcePath}`);
+  info(`   \uB300\uC0C1: ${sddPath}`);
+  if (options.dryRun) {
+    warn("   (dry-run \uBAA8\uB4DC)");
+  }
+  newline();
+  const result = await migrateFromOpenSpec(sourcePath, sddPath, {
+    dryRun: options.dryRun,
+    overwrite: options.overwrite
+  });
+  if (!result.success) {
+    error(result.error.message);
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  const data = result.data;
+  success2("\u2705 \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uC644\uB8CC");
+  info(`   \uC0DD\uC131: ${data.specsCreated}\uAC1C`);
+  info(`   \uC2A4\uD0B5: ${data.specsSkipped}\uAC1C`);
+  if (data.errors.length > 0) {
+    newline();
+    warn("\u26A0\uFE0F  \uC77C\uBD80 \uC624\uB958 \uBC1C\uC0DD:");
+    for (const error2 of data.errors) {
+      error(`   - ${error2}`);
+    }
+  }
+  if (options.dryRun) {
+    newline();
+    info("\uC2E4\uC81C \uB9C8\uC774\uADF8\uB808\uC774\uC158\uC744 \uC218\uD589\uD558\uB824\uBA74 --dry-run \uC635\uC158\uC744 \uC81C\uAC70\uD558\uC138\uC694.");
+  }
+}
+async function runMigrateSpecKit(source, options) {
+  const projectRoot = await findSddRoot();
+  if (!projectRoot) {
+    error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  let sourcePath;
+  if (source) {
+    sourcePath = path18.resolve(source);
+  } else {
+    const detectResult = await detectExternalTools(projectRoot);
+    if (!detectResult.success) {
+      error(detectResult.error.message);
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+    const speckit = detectResult.data.find((t) => t.tool === "speckit");
+    if (!speckit) {
+      error("Spec Kit \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uACBD\uB85C\uB97C \uC9C1\uC811 \uC9C0\uC815\uD558\uC138\uC694.");
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+    sourcePath = speckit.path;
+  }
+  const sddPath = path18.join(projectRoot, ".sdd");
+  info("\u{1F504} Spec Kit\uC5D0\uC11C \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uC911...");
+  info(`   \uC18C\uC2A4: ${sourcePath}`);
+  info(`   \uB300\uC0C1: ${sddPath}`);
+  if (options.dryRun) {
+    warn("   (dry-run \uBAA8\uB4DC)");
+  }
+  newline();
+  const result = await migrateFromSpecKit(sourcePath, sddPath, {
+    dryRun: options.dryRun,
+    overwrite: options.overwrite
+  });
+  if (!result.success) {
+    error(result.error.message);
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  const data = result.data;
+  success2("\u2705 \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uC644\uB8CC");
+  info(`   \uC0DD\uC131: ${data.specsCreated}\uAC1C`);
+  info(`   \uC2A4\uD0B5: ${data.specsSkipped}\uAC1C`);
+  if (data.errors.length > 0) {
+    newline();
+    warn("\u26A0\uFE0F  \uC77C\uBD80 \uC624\uB958 \uBC1C\uC0DD:");
+    for (const error2 of data.errors) {
+      error(`   - ${error2}`);
+    }
+  }
+  if (options.dryRun) {
+    newline();
+    info("\uC2E4\uC81C \uB9C8\uC774\uADF8\uB808\uC774\uC158\uC744 \uC218\uD589\uD558\uB824\uBA74 --dry-run \uC635\uC158\uC744 \uC81C\uAC70\uD558\uC138\uC694.");
+  }
+}
+function getToolIcon(tool) {
+  switch (tool) {
+    case "openspec":
+      return "\u{1F4E6}";
+    case "speckit":
+      return "\u{1F527}";
+    case "sdd":
+      return "\u{1F4CB}";
+    default:
+      return "\u2753";
+  }
+}
+function getToolName(tool) {
+  switch (tool) {
+    case "openspec":
+      return "OpenSpec";
+    case "speckit":
+      return "Spec Kit";
+    case "sdd":
+      return "SDD";
+    default:
+      return tool;
+  }
+}
+function getConfidenceLabel(confidence) {
+  switch (confidence) {
+    case "high":
+      return "\uB192\uC74C \u2713";
+    case "medium":
+      return "\uC911\uAC04";
+    case "low":
+      return "\uB0AE\uC74C";
+    default:
+      return confidence;
+  }
+}
+
+// src/cli/commands/cicd.ts
+import path19 from "path";
+init_errors();
+init_fs();
+function registerCicdCommand(program2) {
+  const cicd = program2.command("cicd").description("CI/CD \uD30C\uC774\uD504\uB77C\uC778 \uD1B5\uD569 \uC124\uC815");
+  cicd.command("setup [platform]").description("CI \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uD30C\uC77C\uC744 \uC0DD\uC131\uD569\uB2C8\uB2E4").option("--strict", "\uC5C4\uACA9 \uBAA8\uB4DC (\uACBD\uACE0\uB3C4 \uC5D0\uB7EC\uB85C \uCC98\uB9AC)").action(async (platform, options) => {
+    try {
+      await runSetup(platform || "github", options);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
   cicd.command("hooks [type]").description("Git hooks\uB97C \uC124\uC815\uD569\uB2C8\uB2E4").option("--install", "husky \uC124\uCE58 \uD3EC\uD568").action(async (type, options) => {
     try {
       await runHooksSetup(type, options);
@@ -8489,16 +9402,16 @@ async function runSetup(platform, options) {
   listItem("PR/MR \uC0DD\uC131 \uC2DC \uC790\uB3D9\uC73C\uB85C \uC2A4\uD399 \uAC80\uC99D\uC774 \uC2E4\uD589\uB429\uB2C8\uB2E4");
 }
 async function setupGitHubActions(projectRoot, strict) {
-  const workflowDir = path18.join(projectRoot, ".github", "workflows");
+  const workflowDir = path19.join(projectRoot, ".github", "workflows");
   await ensureDir(workflowDir);
   const workflowContent = generateGitHubWorkflow(strict);
-  const workflowPath = path18.join(workflowDir, "sdd-validate.yml");
+  const workflowPath = path19.join(workflowDir, "sdd-validate.yml");
   await writeFile(workflowPath, workflowContent);
   info(`\u2705 GitHub Actions \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC0DD\uC131: .github/workflows/sdd-validate.yml`);
 }
 async function setupGitLabCI(projectRoot, strict) {
   const ciContent = generateGitLabCI(strict);
-  const ciPath = path18.join(projectRoot, ".gitlab-ci-sdd.yml");
+  const ciPath = path19.join(projectRoot, ".gitlab-ci-sdd.yml");
   await writeFile(ciPath, ciContent);
   info(`\u2705 GitLab CI \uAD6C\uC131 \uC0DD\uC131: .gitlab-ci-sdd.yml`);
   info("   (\uAE30\uC874 .gitlab-ci.yml\uC5D0 include\uD558\uAC70\uB098 \uBCD1\uD569\uD558\uC138\uC694)");
@@ -8594,7 +9507,7 @@ async function runHooksSetup(type, options) {
     error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const hooksDir = path18.join(projectRoot, ".husky");
+  const hooksDir = path19.join(projectRoot, ".husky");
   if (options.install) {
     info("husky \uC124\uCE58 \uBC29\uBC95:");
     newline();
@@ -8608,7 +9521,7 @@ async function runHooksSetup(type, options) {
   const hooks = type ? [type] : ["pre-commit", "pre-push"];
   for (const hook of hooks) {
     const hookContent = generateHookScript(hook);
-    const hookPath = path18.join(hooksDir, hook);
+    const hookPath = path19.join(hooksDir, hook);
     await writeFile(hookPath, hookContent);
     info(`\u2705 ${hook} \uD6C5 \uC0DD\uC131: .husky/${hook}`);
   }
@@ -8690,7 +9603,7 @@ async function runCiCheck(options) {
   let hasErrors = false;
   let hasWarnings = false;
   info("1. Constitution \uAC80\uC99D...");
-  const constitutionPath = path18.join(projectRoot, ".sdd", "constitution.md");
+  const constitutionPath = path19.join(projectRoot, ".sdd", "constitution.md");
   if (await fileExists(constitutionPath)) {
     info("   \u2705 constitution.md \uC874\uC7AC");
   } else {
@@ -8698,7 +9611,7 @@ async function runCiCheck(options) {
     hasWarnings = true;
   }
   info("2. \uC2A4\uD399 \uB514\uB809\uD1A0\uB9AC \uD655\uC778...");
-  const specsPath = path18.join(projectRoot, ".sdd", "specs");
+  const specsPath = path19.join(projectRoot, ".sdd", "specs");
   if (await directoryExists(specsPath)) {
     info("   \u2705 specs/ \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC");
   } else {
@@ -8708,7 +9621,7 @@ async function runCiCheck(options) {
   info("3. \uAE30\uBCF8 \uAD6C\uC870 \uD655\uC778...");
   const requiredDirs = ["changes", "archive", "templates"];
   for (const dir of requiredDirs) {
-    const dirPath = path18.join(projectRoot, ".sdd", dir);
+    const dirPath = path19.join(projectRoot, ".sdd", dir);
     if (await directoryExists(dirPath)) {
       info(`   \u2705 ${dir}/ \uC874\uC7AC`);
     } else {
@@ -8736,9 +9649,130 @@ async function runCiCheck(options) {
 }
 
 // src/cli/commands/transition.ts
-import path19 from "path";
+import path20 from "path";
+import { promises as fs12 } from "fs";
 init_errors();
 init_fs();
+init_types();
+async function getExistingChangeIds(sddPath) {
+  const changesPath = path20.join(sddPath, "changes");
+  try {
+    const dirs = await fs12.readdir(changesPath);
+    return dirs.filter((d) => d.startsWith("CHG-"));
+  } catch {
+    return [];
+  }
+}
+async function extractProposalTitle(proposalPath) {
+  if (!await fileExists(proposalPath)) {
+    return "";
+  }
+  const content = await readFile(proposalPath);
+  if (!content.success) {
+    return "";
+  }
+  const titleMatch = content.data.match(/^#\s+(.+)$/m);
+  return titleMatch ? titleMatch[1] : "";
+}
+async function transitionNewToChange(sddPath, specId, options) {
+  const specsPath = path20.join(sddPath, "specs");
+  const specPath = path20.join(specsPath, specId, "spec.md");
+  if (!await fileExists(specPath)) {
+    return failure(new Error(`\uC2A4\uD399\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${specId}`));
+  }
+  const existingIds = await getExistingChangeIds(sddPath);
+  const changeId = generateChangeId(existingIds);
+  const changesPath = path20.join(sddPath, "changes");
+  const changePath = path20.join(changesPath, changeId);
+  await ensureDir(changePath);
+  const title2 = options.title || `${specId} \uAE30\uB2A5 \uD655\uC7A5`;
+  const reason = options.reason || "new \uC6CC\uD06C\uD50C\uB85C\uC6B0\uC5D0\uC11C \uC804\uD658\uB428";
+  const proposalContent = generateTransitionProposal(specId, title2, reason, "new-to-change");
+  await writeFile(path20.join(changePath, "proposal.md"), proposalContent);
+  const deltaContent = generateDeltaTemplate2(specId);
+  await writeFile(path20.join(changePath, "delta.md"), deltaContent);
+  const tasksContent = generateTasksTemplate2();
+  await writeFile(path20.join(changePath, "tasks.md"), tasksContent);
+  return success({
+    changeId,
+    changePath,
+    filesCreated: ["proposal.md", "delta.md", "tasks.md"]
+  });
+}
+async function transitionChangeToNew(sddPath, changeId, options) {
+  const changePath = path20.join(sddPath, "changes", changeId);
+  if (!await directoryExists(changePath)) {
+    return failure(new Error(`\uBCC0\uACBD \uC81C\uC548\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${changeId}`));
+  }
+  const proposalPath = path20.join(changePath, "proposal.md");
+  const extractedTitle = await extractProposalTitle(proposalPath);
+  const featureName = options.name || extractedTitle.toLowerCase().replace(/\s+/g, "-") || `feature-from-${changeId}`;
+  const specsPath = path20.join(sddPath, "specs");
+  const newSpecPath = path20.join(specsPath, featureName);
+  if (await directoryExists(newSpecPath)) {
+    return failure(new Error(`\uC2A4\uD399\uC774 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4: ${featureName}`));
+  }
+  await ensureDir(newSpecPath);
+  const reason = options.reason || "change \uC6CC\uD06C\uD50C\uB85C\uC6B0\uC5D0\uC11C \uC804\uD658\uB428";
+  const specContent = generateTransitionSpec(featureName, extractedTitle || featureName, reason, changeId);
+  await writeFile(path20.join(newSpecPath, "spec.md"), specContent);
+  const planContent = generatePlanTemplate(featureName);
+  await writeFile(path20.join(newSpecPath, "plan.md"), planContent);
+  const tasksContent = generateTasksTemplate2();
+  await writeFile(path20.join(newSpecPath, "tasks.md"), tasksContent);
+  const statusPath = path20.join(changePath, ".status");
+  await writeFile(statusPath, JSON.stringify({
+    status: "transitioned",
+    transitionedTo: featureName,
+    transitionedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    reason
+  }, null, 2));
+  return success({
+    featureName,
+    featurePath: newSpecPath,
+    filesCreated: ["spec.md", "plan.md", "tasks.md"],
+    originalChangeId: changeId
+  });
+}
+function getTransitionGuide() {
+  return `=== \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC804\uD658 \uAC00\uC774\uB4DC ===
+
+## new \u2192 change \uC804\uD658
+
+\uC0AC\uC6A9 \uC2DC\uC810:
+- \uC0C8 \uAE30\uB2A5 \uC791\uC131 \uC911 \uAE30\uC874 \uC2A4\uD399\uACFC \uC911\uBCF5 \uBC1C\uACAC
+- \uAE30\uC874 \uAE30\uB2A5 \uD655\uC7A5\uC774 \uB354 \uC801\uC808\uD55C \uACBD\uC6B0
+- \uC758\uC874\uC131 \uBD84\uC11D \uACB0\uACFC \uAE30\uC874 \uC2A4\uD399 \uC218\uC815 \uD544\uC694
+
+\uBA85\uB839\uC5B4:
+sdd transition new-to-change <spec-id>
+  -t, --title <title>  : \uBCC0\uACBD \uC81C\uC548 \uC81C\uBAA9
+  -r, --reason <reason>: \uC804\uD658 \uC0AC\uC720
+
+## change \u2192 new \uC804\uD658
+
+\uC0AC\uC6A9 \uC2DC\uC810:
+- \uBCC0\uACBD \uBC94\uC704\uAC00 \uB108\uBB34 \uCEE4\uC11C \uBCC4\uB3C4 \uAE30\uB2A5\uC73C\uB85C \uBD84\uB9AC \uD544\uC694
+- \uAE30\uC874 \uC2A4\uD399\uACFC \uB3C5\uB9BD\uC801\uC778 \uC0C8 \uAE30\uB2A5\uC73C\uB85C \uBC1C\uC804
+- \uC601\uD5A5\uB3C4 \uBD84\uC11D \uACB0\uACFC \uBD84\uB9AC\uAC00 \uC548\uC804
+
+\uBA85\uB839\uC5B4:
+sdd transition change-to-new <change-id>
+  -n, --name <name>    : \uC0C8 \uAE30\uB2A5 \uC774\uB984
+  -r, --reason <reason>: \uC804\uD658 \uC0AC\uC720
+
+## \uC804\uD658 \uD310\uB2E8 \uAE30\uC900
+
+new \u2192 change:
+- \uC601\uD5A5\uBC1B\uB294 \uC2A4\uD399 \uC218 \u2264 3\uAC1C
+- \uBCC0\uACBD\uC774 \uAE30\uC874 \uAE30\uB2A5\uC758 \uC790\uC5F0\uC2A4\uB7EC\uC6B4 \uD655\uC7A5
+- \uC0C8 \uC2DC\uB098\uB9AC\uC624 \uCD94\uAC00\uBCF4\uB2E4 \uAE30\uC874 \uC2DC\uB098\uB9AC\uC624 \uC218\uC815 \uC911\uC2EC
+
+change \u2192 new:
+- \uC601\uD5A5\uBC1B\uB294 \uC2A4\uD399 \uC218 > 3\uAC1C
+- \uC0C8\uB85C\uC6B4 \uAC1C\uB150/\uB3C4\uBA54\uC778 \uB3C4\uC785
+- \uAE30\uC874 \uC2A4\uD399\uACFC \uB3C5\uB9BD\uC801\uC73C\uB85C \uD14C\uC2A4\uD2B8 \uAC00\uB2A5`;
+}
 function registerTransitionCommand(program2) {
   const transition = program2.command("transition").description("\uC6CC\uD06C\uD50C\uB85C\uC6B0 \uAC04 \uC804\uD658\uC744 \uC218\uD589\uD569\uB2C8\uB2E4");
   transition.command("new-to-change <spec-id>").description("\uC0C8 \uAE30\uB2A5 \uC791\uC5C5\uC744 \uAE30\uC874 \uC2A4\uD399 \uBCC0\uACBD\uC73C\uB85C \uC804\uD658\uD569\uB2C8\uB2E4").option("-t, --title <title>", "\uBCC0\uACBD \uC81C\uC548 \uC81C\uBAA9").option("-r, --reason <reason>", "\uC804\uD658 \uC0AC\uC720").action(async (specId, options) => {
@@ -8767,33 +9801,17 @@ async function runNewToChange(specId, options) {
     error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const sddPath = path19.join(projectRoot, ".sdd");
-  const specsPath = path19.join(sddPath, "specs");
-  const specPath = path19.join(specsPath, specId, "spec.md");
-  if (!await fileExists(specPath)) {
-    error(`\uC2A4\uD399\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${specId}`);
-    info("\uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uC2A4\uD399 \uBAA9\uB85D\uC740 `sdd list`\uB85C \uD655\uC778\uD558\uC138\uC694.");
-    process.exit(ExitCode.GENERAL_ERROR);
-  }
+  const sddPath = path20.join(projectRoot, ".sdd");
   info("=== \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC804\uD658: new \u2192 change ===");
   newline();
   info(`\uB300\uC0C1 \uC2A4\uD399: ${specId}`);
-  const changeId = generateChangeId();
-  const changePath = path19.join(sddPath, "changes", changeId);
-  await ensureDir(changePath);
-  const specContent = await readFile(specPath);
-  if (!specContent.success) {
-    error("\uC2A4\uD399 \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  const result = await transitionNewToChange(sddPath, specId, options);
+  if (!result.success) {
+    error(result.error.message);
+    info("\uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uC2A4\uD399 \uBAA9\uB85D\uC740 `sdd list`\uB85C \uD655\uC778\uD558\uC138\uC694.");
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const title2 = options.title || `${specId} \uAE30\uB2A5 \uD655\uC7A5`;
-  const reason = options.reason || "new \uC6CC\uD06C\uD50C\uB85C\uC6B0\uC5D0\uC11C \uC804\uD658\uB428";
-  const proposalContent = generateTransitionProposal(specId, title2, reason, "new-to-change");
-  await writeFile(path19.join(changePath, "proposal.md"), proposalContent);
-  const deltaContent = generateDeltaTemplate(specId);
-  await writeFile(path19.join(changePath, "delta.md"), deltaContent);
-  const tasksContent = generateTasksTemplate();
-  await writeFile(path19.join(changePath, "tasks.md"), tasksContent);
+  const { changeId } = result.data;
   newline();
   success2(`\uC804\uD658 \uC644\uB8CC! \uBCC0\uACBD \uC81C\uC548\uC774 \uC0DD\uC131\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`);
   newline();
@@ -8815,56 +9833,27 @@ async function runChangeToNew(changeId, options) {
     error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  const sddPath = path19.join(projectRoot, ".sdd");
-  const changePath = path19.join(sddPath, "changes", changeId);
-  if (!await directoryExists(changePath)) {
-    error(`\uBCC0\uACBD \uC81C\uC548\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${changeId}`);
-    info("\uC9C4\uD589 \uC911\uC778 \uBCC0\uACBD \uBAA9\uB85D\uC740 `sdd change -l`\uB85C \uD655\uC778\uD558\uC138\uC694.");
-    process.exit(ExitCode.GENERAL_ERROR);
-  }
+  const sddPath = path20.join(projectRoot, ".sdd");
   info("=== \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC804\uD658: change \u2192 new ===");
   newline();
   info(`\uC6D0\uBCF8 \uBCC0\uACBD: ${changeId}`);
-  const proposalPath = path19.join(changePath, "proposal.md");
-  let extractedTitle = "";
-  if (await fileExists(proposalPath)) {
-    const proposalContent = await readFile(proposalPath);
-    if (proposalContent.success) {
-      const titleMatch = proposalContent.data.match(/^#\s+(.+)$/m);
-      if (titleMatch) {
-        extractedTitle = titleMatch[1];
-      }
+  const result = await transitionChangeToNew(sddPath, changeId, options);
+  if (!result.success) {
+    error(result.error.message);
+    if (result.error.message.includes("\uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4")) {
+      info("\uC9C4\uD589 \uC911\uC778 \uBCC0\uACBD \uBAA9\uB85D\uC740 `sdd change -l`\uB85C \uD655\uC778\uD558\uC138\uC694.");
+    } else if (result.error.message.includes("\uC774\uBBF8 \uC874\uC7AC")) {
+      info("\uB2E4\uB978 \uC774\uB984\uC744 \uC9C0\uC815\uD558\uC138\uC694: --name <name>");
     }
-  }
-  const featureName = options.name || extractedTitle.toLowerCase().replace(/\s+/g, "-") || `feature-from-${changeId}`;
-  const specsPath = path19.join(sddPath, "specs");
-  const newSpecPath = path19.join(specsPath, featureName);
-  if (await directoryExists(newSpecPath)) {
-    error(`\uC2A4\uD399\uC774 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4: ${featureName}`);
-    info("\uB2E4\uB978 \uC774\uB984\uC744 \uC9C0\uC815\uD558\uC138\uC694: --name <name>");
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  await ensureDir(newSpecPath);
-  const reason = options.reason || "change \uC6CC\uD06C\uD50C\uB85C\uC6B0\uC5D0\uC11C \uC804\uD658\uB428";
-  const specContent = generateTransitionSpec(featureName, extractedTitle || featureName, reason, changeId);
-  await writeFile(path19.join(newSpecPath, "spec.md"), specContent);
-  const planContent = generatePlanTemplate(featureName);
-  await writeFile(path19.join(newSpecPath, "plan.md"), planContent);
-  const tasksContent = generateTasksTemplate();
-  await writeFile(path19.join(newSpecPath, "tasks.md"), tasksContent);
-  const statusPath = path19.join(changePath, ".status");
-  await writeFile(statusPath, JSON.stringify({
-    status: "transitioned",
-    transitionedTo: featureName,
-    transitionedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    reason
-  }, null, 2));
+  const { featureName, originalChangeId } = result.data;
   newline();
   success2(`\uC804\uD658 \uC644\uB8CC! \uC0C8 \uAE30\uB2A5 \uC2A4\uD399\uC774 \uC0DD\uC131\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`);
   newline();
   info(`\uAE30\uB2A5 \uC774\uB984: ${featureName}`);
   info(`\uC704\uCE58: .sdd/specs/${featureName}/`);
-  info(`\uC6D0\uBCF8 \uBCC0\uACBD ${changeId}\uC740 'transitioned' \uC0C1\uD0DC\uB85C \uBCC0\uACBD\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`);
+  info(`\uC6D0\uBCF8 \uBCC0\uACBD ${originalChangeId}\uC740 'transitioned' \uC0C1\uD0DC\uB85C \uBCC0\uACBD\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`);
   newline();
   info("\uB2E4\uC74C \uB2E8\uACC4:");
   listItem(`1. .sdd/specs/${featureName}/spec.md \uD3B8\uC9D1`);
@@ -8876,43 +9865,7 @@ async function runChangeToNew(changeId, options) {
   listItem("/sdd.new - \uBA85\uC138 \uC791\uC131 \uB3C4\uC6C0");
 }
 function displayTransitionGuide() {
-  info("=== \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC804\uD658 \uAC00\uC774\uB4DC ===");
-  newline();
-  info("## new \u2192 change \uC804\uD658");
-  newline();
-  info("\uC0AC\uC6A9 \uC2DC\uC810:");
-  listItem("\uC0C8 \uAE30\uB2A5 \uC791\uC131 \uC911 \uAE30\uC874 \uC2A4\uD399\uACFC \uC911\uBCF5 \uBC1C\uACAC");
-  listItem("\uAE30\uC874 \uAE30\uB2A5 \uD655\uC7A5\uC774 \uB354 \uC801\uC808\uD55C \uACBD\uC6B0");
-  listItem("\uC758\uC874\uC131 \uBD84\uC11D \uACB0\uACFC \uAE30\uC874 \uC2A4\uD399 \uC218\uC815 \uD544\uC694");
-  newline();
-  info("\uBA85\uB839\uC5B4:");
-  listItem("sdd transition new-to-change <spec-id>");
-  listItem("  -t, --title <title>  : \uBCC0\uACBD \uC81C\uC548 \uC81C\uBAA9");
-  listItem("  -r, --reason <reason>: \uC804\uD658 \uC0AC\uC720");
-  newline();
-  info("## change \u2192 new \uC804\uD658");
-  newline();
-  info("\uC0AC\uC6A9 \uC2DC\uC810:");
-  listItem("\uBCC0\uACBD \uBC94\uC704\uAC00 \uB108\uBB34 \uCEE4\uC11C \uBCC4\uB3C4 \uAE30\uB2A5\uC73C\uB85C \uBD84\uB9AC \uD544\uC694");
-  listItem("\uAE30\uC874 \uC2A4\uD399\uACFC \uB3C5\uB9BD\uC801\uC778 \uC0C8 \uAE30\uB2A5\uC73C\uB85C \uBC1C\uC804");
-  listItem("\uC601\uD5A5\uB3C4 \uBD84\uC11D \uACB0\uACFC \uBD84\uB9AC\uAC00 \uC548\uC804");
-  newline();
-  info("\uBA85\uB839\uC5B4:");
-  listItem("sdd transition change-to-new <change-id>");
-  listItem("  -n, --name <name>    : \uC0C8 \uAE30\uB2A5 \uC774\uB984");
-  listItem("  -r, --reason <reason>: \uC804\uD658 \uC0AC\uC720");
-  newline();
-  info("## \uC804\uD658 \uD310\uB2E8 \uAE30\uC900");
-  newline();
-  info("new \u2192 change:");
-  listItem("\uC601\uD5A5\uBC1B\uB294 \uC2A4\uD399 \uC218 \u2264 3\uAC1C");
-  listItem("\uBCC0\uACBD\uC774 \uAE30\uC874 \uAE30\uB2A5\uC758 \uC790\uC5F0\uC2A4\uB7EC\uC6B4 \uD655\uC7A5");
-  listItem("\uC0C8 \uC2DC\uB098\uB9AC\uC624 \uCD94\uAC00\uBCF4\uB2E4 \uAE30\uC874 \uC2DC\uB098\uB9AC\uC624 \uC218\uC815 \uC911\uC2EC");
-  newline();
-  info("change \u2192 new:");
-  listItem("\uC601\uD5A5\uBC1B\uB294 \uC2A4\uD399 \uC218 > 3\uAC1C");
-  listItem("\uC0C8\uB85C\uC6B4 \uAC1C\uB150/\uB3C4\uBA54\uC778 \uB3C4\uC785");
-  listItem("\uAE30\uC874 \uC2A4\uD399\uACFC \uB3C5\uB9BD\uC801\uC73C\uB85C \uD14C\uC2A4\uD2B8 \uAC00\uB2A5");
+  console.log(getTransitionGuide());
 }
 function generateTransitionProposal(specId, title2, reason, direction) {
   const now = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
@@ -8954,7 +9907,7 @@ transition_reason: "${reason}"
 <!-- \uCD94\uAC00 \uCC38\uACE0 \uC815\uBCF4\uAC00 \uC788\uB2E4\uBA74 \uC791\uC131\uD558\uC138\uC694 -->
 `;
 }
-function generateDeltaTemplate(specId) {
+function generateDeltaTemplate2(specId) {
   return `---
 target: ${specId}
 ---
@@ -9065,7 +10018,7 @@ status: draft
 <!-- \uAD6C\uD604 \uC2DC \uACE0\uB824\uD560 \uC704\uD5D8 \uC694\uC18C -->
 `;
 }
-function generateTasksTemplate() {
+function generateTasksTemplate2() {
   return `---
 status: pending
 ---
@@ -9086,6 +10039,1156 @@ status: pending
 `;
 }
 
+// src/cli/commands/watch.ts
+import path22 from "path";
+
+// src/core/watch/watcher.ts
+import chokidar from "chokidar";
+import path21 from "path";
+import { EventEmitter } from "events";
+var SpecWatcher = class extends EventEmitter {
+  watcher = null;
+  specsPath;
+  debounceMs;
+  debounceTimer = null;
+  pendingEvents = [];
+  isRunning = false;
+  constructor(options) {
+    super();
+    this.specsPath = options.specsPath;
+    this.debounceMs = options.debounceMs ?? 500;
+  }
+  /**
+   * 감시 시작
+   */
+  start() {
+    if (this.isRunning) {
+      return;
+    }
+    const ignored = [
+      "**/node_modules/**",
+      "**/.git/**",
+      "**/.*"
+    ];
+    this.watcher = chokidar.watch(this.specsPath, {
+      persistent: true,
+      ignoreInitial: true,
+      ignored,
+      awaitWriteFinish: {
+        stabilityThreshold: 100,
+        pollInterval: 100
+      }
+    });
+    this.watcher.on("add", (filePath) => this.handleEvent("add", filePath)).on("change", (filePath) => this.handleEvent("change", filePath)).on("unlink", (filePath) => this.handleEvent("unlink", filePath)).on("error", (error2) => this.emit("error", error2)).on("ready", () => {
+      this.isRunning = true;
+      this.emit("ready");
+    });
+  }
+  /**
+   * 감시 중지
+   */
+  async stop() {
+    if (this.debounceTimer) {
+      clearTimeout(this.debounceTimer);
+      this.debounceTimer = null;
+    }
+    if (this.watcher) {
+      await this.watcher.close();
+      this.watcher = null;
+    }
+    this.isRunning = false;
+    this.pendingEvents = [];
+  }
+  /**
+   * 실행 상태 확인
+   */
+  get running() {
+    return this.isRunning;
+  }
+  /**
+   * 파일 이벤트 처리
+   */
+  handleEvent(type, filePath) {
+    if (!filePath.endsWith(".md")) {
+      return;
+    }
+    const event = {
+      type,
+      path: filePath,
+      relativePath: path21.relative(this.specsPath, filePath),
+      timestamp: /* @__PURE__ */ new Date()
+    };
+    this.pendingEvents.push(event);
+    if (this.debounceTimer) {
+      clearTimeout(this.debounceTimer);
+    }
+    this.debounceTimer = setTimeout(() => {
+      this.flushEvents();
+    }, this.debounceMs);
+  }
+  /**
+   * 대기 중인 이벤트 처리
+   */
+  flushEvents() {
+    if (this.pendingEvents.length === 0) {
+      return;
+    }
+    const events = [...this.pendingEvents];
+    this.pendingEvents = [];
+    this.debounceTimer = null;
+    this.emit("change", events);
+  }
+};
+function createWatcher(options) {
+  return new SpecWatcher(options);
+}
+
+// src/cli/commands/watch.ts
+init_fs();
+init_errors();
+function registerWatchCommand(program2) {
+  program2.command("watch").description("\uC2A4\uD399 \uD30C\uC77C \uBCC0\uACBD\uC744 \uC2E4\uC2DC\uAC04 \uAC10\uC2DC\uD558\uACE0 \uC790\uB3D9 \uAC80\uC99D\uD569\uB2C8\uB2E4").option("--no-validate", "\uC790\uB3D9 \uAC80\uC99D \uBE44\uD65C\uC131\uD654").option("--impact", "\uC601\uD5A5\uB3C4 \uBD84\uC11D \uD3EC\uD568").option("-q, --quiet", "\uC131\uACF5 \uC2DC \uCD9C\uB825 \uC0DD\uB7B5").option("--debounce <ms>", "\uB514\uBC14\uC6B4\uC2A4 \uC2DC\uAC04 (\uAE30\uBCF8: 500ms)", "500").action(async (options) => {
+    try {
+      await runWatch(options);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+}
+async function runWatch(options) {
+  const projectRoot = await findSddRoot();
+  if (!projectRoot) {
+    error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  const sddPath = path22.join(projectRoot, ".sdd");
+  const specsPath = path22.join(sddPath, "specs");
+  const debounceMs = parseInt(options.debounce || "500", 10);
+  info("\u{1F441}\uFE0F  Watch \uBAA8\uB4DC \uC2DC\uC791");
+  info(`   \uACBD\uB85C: ${specsPath}`);
+  info(`   \uB514\uBC14\uC6B4\uC2A4: ${debounceMs}ms`);
+  info(`   \uAC80\uC99D: ${options.validate !== false ? "\uD65C\uC131\uD654" : "\uBE44\uD65C\uC131\uD654"}`);
+  newline();
+  info("\uD30C\uC77C \uBCC0\uACBD\uC744 \uAC10\uC2DC \uC911... (Ctrl+C\uB85C \uC885\uB8CC)");
+  newline();
+  const watcher = createWatcher({
+    specsPath,
+    debounceMs
+  });
+  let validationCount = 0;
+  let errorCount = 0;
+  watcher.on("change", async (events) => {
+    const timestamp = (/* @__PURE__ */ new Date()).toLocaleTimeString();
+    const addCount = events.filter((e) => e.type === "add").length;
+    const changeCount = events.filter((e) => e.type === "change").length;
+    const unlinkCount = events.filter((e) => e.type === "unlink").length;
+    const parts = [];
+    if (addCount > 0) parts.push(`\uCD94\uAC00 ${addCount}`);
+    if (changeCount > 0) parts.push(`\uC218\uC815 ${changeCount}`);
+    if (unlinkCount > 0) parts.push(`\uC0AD\uC81C ${unlinkCount}`);
+    info(`[${timestamp}] \uBCC0\uACBD \uAC10\uC9C0: ${parts.join(", ")}`);
+    for (const event of events) {
+      const icon = event.type === "add" ? "\u2795" : event.type === "change" ? "\u270F\uFE0F" : "\u274C";
+      info(`  ${icon} ${event.relativePath}`);
+    }
+    if (options.validate !== false) {
+      newline();
+      info("\u{1F50D} \uAC80\uC99D \uC2E4\uD589 \uC911...");
+      const result = await validateSpecs(sddPath, { strict: false });
+      validationCount++;
+      if (result.success) {
+        const data = result.data;
+        const hasErrors = data.results.some((r) => r.errors.length > 0);
+        const hasWarnings = data.results.some((r) => r.warnings.length > 0);
+        if (hasErrors) {
+          errorCount++;
+          error(`\u274C \uAC80\uC99D \uC2E4\uD328: ${data.errorCount}\uAC1C \uC5D0\uB7EC, ${data.warningCount}\uAC1C \uACBD\uACE0`);
+          for (const specResult of data.results) {
+            if (specResult.errors.length > 0) {
+              error(`   ${specResult.file}:`);
+              for (const err of specResult.errors) {
+                error(`     - ${err}`);
+              }
+            }
+          }
+        } else if (hasWarnings) {
+          if (!options.quiet) {
+            warn(`\u26A0\uFE0F  \uAC80\uC99D \uC644\uB8CC: ${data.warningCount}\uAC1C \uACBD\uACE0`);
+          }
+        } else {
+          if (!options.quiet) {
+            success2(`\u2705 \uAC80\uC99D \uD1B5\uACFC (${data.validCount}\uAC1C \uC2A4\uD399)`);
+          }
+        }
+      } else {
+        errorCount++;
+        error(`\u274C \uAC80\uC99D \uC624\uB958: ${result.error.message}`);
+      }
+      newline();
+    }
+  });
+  watcher.on("error", (error2) => {
+    error(`\uAC10\uC2DC \uC624\uB958: ${error2.message}`);
+  });
+  watcher.on("ready", () => {
+    success2("\u2705 \uAC10\uC2DC \uC900\uBE44 \uC644\uB8CC");
+    newline();
+  });
+  const cleanup = async () => {
+    newline();
+    info("Watch \uBAA8\uB4DC \uC885\uB8CC \uC911...");
+    await watcher.stop();
+    newline();
+    info("\u{1F4CA} \uC138\uC158 \uC694\uC57D:");
+    info(`   \uAC80\uC99D \uC2E4\uD589: ${validationCount}\uD68C`);
+    info(`   \uC5D0\uB7EC \uBC1C\uC0DD: ${errorCount}\uD68C`);
+    process.exit(0);
+  };
+  process.on("SIGINT", cleanup);
+  process.on("SIGTERM", cleanup);
+  watcher.start();
+  await new Promise(() => {
+  });
+}
+
+// src/cli/commands/quality.ts
+import path24 from "path";
+
+// src/core/quality/analyzer.ts
+init_types();
+init_errors();
+init_fs();
+import path23 from "path";
+import { promises as fs13 } from "fs";
+function getGrade(percentage) {
+  if (percentage >= 90) return "A";
+  if (percentage >= 80) return "B";
+  if (percentage >= 70) return "C";
+  if (percentage >= 60) return "D";
+  return "F";
+}
+function scoreRfc2119(content) {
+  const maxScore = 10;
+  const details = [];
+  const suggestions = [];
+  const keywords = ["SHALL", "MUST", "SHOULD", "MAY", "SHALL NOT", "MUST NOT", "SHOULD NOT"];
+  const found = [];
+  for (const kw of keywords) {
+    const regex = new RegExp(`\\b${kw}\\b`, "gi");
+    const matches = content.match(regex);
+    if (matches && matches.length > 0) {
+      found.push(`${kw}: ${matches.length}\uAC1C`);
+    }
+  }
+  let score = 0;
+  if (found.length > 0) {
+    score = Math.min(maxScore, found.length * 2);
+    details.push(`\uBC1C\uACAC\uB41C \uD0A4\uC6CC\uB4DC: ${found.join(", ")}`);
+  } else {
+    details.push("RFC 2119 \uD0A4\uC6CC\uB4DC\uAC00 \uBC1C\uACAC\uB418\uC9C0 \uC54A\uC74C");
+    suggestions.push("\uC694\uAD6C\uC0AC\uD56D\uC5D0 SHALL, MUST, SHOULD, MAY \uD0A4\uC6CC\uB4DC\uB97C \uC0AC\uC6A9\uD558\uC138\uC694");
+  }
+  return {
+    name: "RFC 2119 \uD0A4\uC6CC\uB4DC",
+    score,
+    maxScore,
+    percentage: score / maxScore * 100,
+    details,
+    suggestions
+  };
+}
+function scoreScenarios(content) {
+  const maxScore = 20;
+  const details = [];
+  const suggestions = [];
+  const givenCount = (content.match(/\*\*GIVEN\*\*|\bGIVEN\b/gi) || []).length;
+  const whenCount = (content.match(/\*\*WHEN\*\*|\bWHEN\b/gi) || []).length;
+  const thenCount = (content.match(/\*\*THEN\*\*|\bTHEN\b/gi) || []).length;
+  const scenarioCount = Math.min(givenCount, whenCount, thenCount);
+  let score = 0;
+  if (scenarioCount > 0) {
+    score = Math.min(maxScore, scenarioCount * 5);
+    details.push(`\uC644\uC804\uD55C \uC2DC\uB098\uB9AC\uC624: ${scenarioCount}\uAC1C`);
+    details.push(`GIVEN: ${givenCount}, WHEN: ${whenCount}, THEN: ${thenCount}`);
+  } else {
+    details.push("GIVEN-WHEN-THEN \uC2DC\uB098\uB9AC\uC624\uAC00 \uC5C6\uC74C");
+    suggestions.push("\uCD5C\uC18C 2\uAC1C \uC774\uC0C1\uC758 GIVEN-WHEN-THEN \uC2DC\uB098\uB9AC\uC624\uB97C \uC791\uC131\uD558\uC138\uC694");
+  }
+  if (scenarioCount < 2 && scenarioCount > 0) {
+    suggestions.push("\uCD94\uAC00 \uC2DC\uB098\uB9AC\uC624 \uC791\uC131\uC744 \uAD8C\uC7A5\uD569\uB2C8\uB2E4 (\uCD5C\uC18C 2\uAC1C)");
+  }
+  return {
+    name: "GIVEN-WHEN-THEN \uC2DC\uB098\uB9AC\uC624",
+    score,
+    maxScore,
+    percentage: score / maxScore * 100,
+    details,
+    suggestions
+  };
+}
+function scoreRequirements(content) {
+  const maxScore = 15;
+  const details = [];
+  const suggestions = [];
+  const reqIdPattern = /REQ-\d+|REQ-[A-Z]+-\d+/gi;
+  const reqIds = content.match(reqIdPattern) || [];
+  const hasRequirementsSection = /^##\s*(요구사항|Requirements)/im.test(content);
+  let score = 0;
+  if (hasRequirementsSection) {
+    score += 5;
+    details.push("\uC694\uAD6C\uC0AC\uD56D \uC139\uC158\uC774 \uC874\uC7AC\uD568");
+  } else {
+    suggestions.push("## \uC694\uAD6C\uC0AC\uD56D \uC139\uC158\uC744 \uCD94\uAC00\uD558\uC138\uC694");
+  }
+  if (reqIds.length > 0) {
+    score += Math.min(10, reqIds.length * 2);
+    details.push(`\uC694\uAD6C\uC0AC\uD56D ID: ${reqIds.length}\uAC1C (${[...new Set(reqIds)].slice(0, 3).join(", ")}...)`);
+  } else {
+    suggestions.push("\uC694\uAD6C\uC0AC\uD56D\uC5D0 REQ-01 \uD615\uC2DD\uC758 ID\uB97C \uBD80\uC5EC\uD558\uC138\uC694");
+  }
+  return {
+    name: "\uC694\uAD6C\uC0AC\uD56D \uBA85\uD655\uC131",
+    score,
+    maxScore,
+    percentage: score / maxScore * 100,
+    details,
+    suggestions
+  };
+}
+function scoreDependencies(spec) {
+  const maxScore = 10;
+  const details = [];
+  const suggestions = [];
+  let score = 0;
+  if (spec.metadata.depends) {
+    const deps = Array.isArray(spec.metadata.depends) ? spec.metadata.depends : [spec.metadata.depends];
+    if (deps.length > 0 && deps[0] !== null) {
+      score = maxScore;
+      details.push(`\uC758\uC874\uC131: ${deps.join(", ")}`);
+    } else {
+      score = 5;
+      details.push("\uC758\uC874\uC131 \uC5C6\uC74C (\uBA85\uC2DC\uC801 \uC120\uC5B8)");
+    }
+  } else {
+    score = 5;
+    details.push("\uC758\uC874\uC131 \uD544\uB4DC \uC5C6\uC74C (\uC554\uC2DC\uC801 \uC5C6\uC74C)");
+  }
+  return {
+    name: "\uC758\uC874\uC131 \uBA85\uC2DC",
+    score,
+    maxScore,
+    percentage: score / maxScore * 100,
+    details,
+    suggestions
+  };
+}
+function scoreStructure(content) {
+  const maxScore = 15;
+  const details = [];
+  const suggestions = [];
+  const requiredSections = [
+    { pattern: /^#\s+.+/m, name: "\uC81C\uBAA9 (H1)" },
+    { pattern: /^##\s*(요구사항|Requirements)/im, name: "\uC694\uAD6C\uC0AC\uD56D \uC139\uC158" },
+    { pattern: /^##\s*(시나리오|Scenario)/im, name: "\uC2DC\uB098\uB9AC\uC624 \uC139\uC158" }
+  ];
+  const optionalSections = [
+    { pattern: /^##\s*(개요|Overview|설명|Description)/im, name: "\uAC1C\uC694/\uC124\uBA85 \uC139\uC158" },
+    { pattern: /^##\s*(제약|Constraints|제한)/im, name: "\uC81C\uC57D\uC0AC\uD56D \uC139\uC158" },
+    { pattern: /^##\s*(비고|Notes|참고)/im, name: "\uBE44\uACE0 \uC139\uC158" }
+  ];
+  let score = 0;
+  const foundRequired = [];
+  const missingRequired = [];
+  for (const section of requiredSections) {
+    if (section.pattern.test(content)) {
+      foundRequired.push(section.name);
+      score += 4;
+    } else {
+      missingRequired.push(section.name);
+    }
+  }
+  for (const section of optionalSections) {
+    if (section.pattern.test(content)) {
+      score += 1;
+    }
+  }
+  score = Math.min(maxScore, score);
+  if (foundRequired.length > 0) {
+    details.push(`\uD544\uC218 \uC139\uC158: ${foundRequired.join(", ")}`);
+  }
+  if (missingRequired.length > 0) {
+    suggestions.push(`\uB204\uB77D\uB41C \uC139\uC158: ${missingRequired.join(", ")}`);
+  }
+  return {
+    name: "\uBB38\uC11C \uAD6C\uC870",
+    score,
+    maxScore,
+    percentage: score / maxScore * 100,
+    details,
+    suggestions
+  };
+}
+function scoreConstitution(spec, hasConstitution) {
+  const maxScore = 10;
+  const details = [];
+  const suggestions = [];
+  let score = 0;
+  if (!hasConstitution) {
+    score = maxScore;
+    details.push("Constitution \uBBF8\uC124\uC815 (\uAC80\uC0AC \uC0DD\uB7B5)");
+  } else if (spec.metadata.constitution_version) {
+    score = maxScore;
+    details.push(`Constitution \uBC84\uC804: ${spec.metadata.constitution_version}`);
+  } else {
+    details.push("constitution_version \uD544\uB4DC \uC5C6\uC74C");
+    suggestions.push("frontmatter\uC5D0 constitution_version\uC744 \uCD94\uAC00\uD558\uC138\uC694");
+  }
+  return {
+    name: "Constitution \uC900\uC218",
+    score,
+    maxScore,
+    percentage: score / maxScore * 100,
+    details,
+    suggestions
+  };
+}
+function scoreLinks(content) {
+  const maxScore = 10;
+  const details = [];
+  const suggestions = [];
+  const linkPattern = /\[([^\]]+)\]\(([^)]+)\)/g;
+  const links = [...content.matchAll(linkPattern)];
+  let score = 5;
+  if (links.length > 0) {
+    score = Math.min(maxScore, 5 + links.length);
+    details.push(`\uB9C1\uD06C: ${links.length}\uAC1C`);
+  } else {
+    details.push("\uB9C1\uD06C \uC5C6\uC74C");
+    suggestions.push("\uAD00\uB828 \uBB38\uC11C\uB098 \uC678\uBD80 \uCC38\uC870 \uB9C1\uD06C\uB97C \uCD94\uAC00\uD558\uBA74 \uC88B\uC2B5\uB2C8\uB2E4");
+  }
+  return {
+    name: "\uCC38\uC870 \uB9C1\uD06C",
+    score,
+    maxScore,
+    percentage: score / maxScore * 100,
+    details,
+    suggestions
+  };
+}
+function scoreMetadata(spec) {
+  const maxScore = 10;
+  const details = [];
+  const suggestions = [];
+  const requiredFields = ["id", "title", "status"];
+  const optionalFields = ["created", "updated", "author", "version"];
+  let score = 0;
+  const missingRequired = [];
+  for (const field of requiredFields) {
+    if (spec.metadata[field]) {
+      score += 2;
+    } else {
+      missingRequired.push(field);
+    }
+  }
+  for (const field of optionalFields) {
+    if (spec.metadata[field]) {
+      score += 1;
+    }
+  }
+  score = Math.min(maxScore, score);
+  const presentFields = Object.keys(spec.metadata).filter(
+    (k) => spec.metadata[k] !== null && spec.metadata[k] !== void 0
+  );
+  details.push(`\uBA54\uD0C0\uB370\uC774\uD130 \uD544\uB4DC: ${presentFields.length}\uAC1C`);
+  if (missingRequired.length > 0) {
+    suggestions.push(`\uD544\uC218 \uD544\uB4DC \uB204\uB77D: ${missingRequired.join(", ")}`);
+  }
+  return {
+    name: "\uBA54\uD0C0\uB370\uC774\uD130 \uC644\uC131\uB3C4",
+    score,
+    maxScore,
+    percentage: score / maxScore * 100,
+    details,
+    suggestions
+  };
+}
+async function analyzeSpecQuality(specPath, sddPath) {
+  try {
+    if (!await fileExists(specPath)) {
+      return failure(new ChangeError(`\uC2A4\uD399 \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${specPath}`));
+    }
+    const contentResult = await readFile(specPath);
+    if (!contentResult.success) {
+      return failure(new ChangeError("\uC2A4\uD399 \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    }
+    const content = contentResult.data;
+    const parseResult = parseSpec(content);
+    if (!parseResult.success) {
+      return failure(new ChangeError(`\uC2A4\uD399 \uD30C\uC2F1 \uC2E4\uD328: ${parseResult.error.message}`));
+    }
+    const spec = parseResult.data;
+    const constitutionPath = path23.join(sddPath, "constitution.md");
+    const hasConstitution = await fileExists(constitutionPath);
+    const items = [
+      scoreRfc2119(content),
+      scoreScenarios(content),
+      scoreRequirements(content),
+      scoreDependencies(spec),
+      scoreStructure(content),
+      scoreConstitution(spec, hasConstitution),
+      scoreLinks(content),
+      scoreMetadata(spec)
+    ];
+    const totalScore = items.reduce((sum, item) => sum + item.score, 0);
+    const maxScore = items.reduce((sum, item) => sum + item.maxScore, 0);
+    const percentage = Math.round(totalScore / maxScore * 100);
+    const grade = getGrade(percentage);
+    const topSuggestions = items.filter((item) => item.suggestions.length > 0).sort((a, b) => a.percentage - b.percentage).slice(0, 3).flatMap((item) => item.suggestions);
+    const specId = spec.metadata.id || path23.basename(path23.dirname(specPath));
+    const summary = `\uC2A4\uD399 '${specId}'\uC758 \uD488\uC9C8 \uC810\uC218: ${totalScore}/${maxScore} (${percentage}%, \uB4F1\uAE09: ${grade})`;
+    return success({
+      specId,
+      specPath,
+      totalScore,
+      maxScore,
+      percentage,
+      grade,
+      items,
+      summary,
+      topSuggestions
+    });
+  } catch (error2) {
+    return failure(
+      new ChangeError(
+        `\uD488\uC9C8 \uBD84\uC11D \uC2E4\uD328: ${error2 instanceof Error ? error2.message : String(error2)}`
+      )
+    );
+  }
+}
+async function analyzeProjectQuality(sddPath) {
+  try {
+    const specsPath = path23.join(sddPath, "specs");
+    if (!await directoryExists(specsPath)) {
+      return failure(new ChangeError("\uC2A4\uD399 \uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    }
+    const specFiles = [];
+    await findSpecFiles2(specsPath, specFiles);
+    if (specFiles.length === 0) {
+      return failure(new ChangeError("\uC2A4\uD399 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    }
+    const specResults = [];
+    for (const specFile of specFiles) {
+      const result = await analyzeSpecQuality(specFile, sddPath);
+      if (result.success) {
+        specResults.push(result.data);
+      }
+    }
+    if (specResults.length === 0) {
+      return failure(new ChangeError("\uBD84\uC11D \uAC00\uB2A5\uD55C \uC2A4\uD399\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    }
+    const totalPercentage = specResults.reduce((sum, r) => sum + r.percentage, 0);
+    const averagePercentage = Math.round(totalPercentage / specResults.length);
+    const averageScore = Math.round(
+      specResults.reduce((sum, r) => sum + r.totalScore, 0) / specResults.length
+    );
+    const grade = getGrade(averagePercentage);
+    const summary = `\uD504\uB85C\uC81D\uD2B8 \uD488\uC9C8: \uD3C9\uADE0 ${averagePercentage}% (\uB4F1\uAE09: ${grade}), ${specResults.length}\uAC1C \uC2A4\uD399 \uBD84\uC11D`;
+    return success({
+      averageScore,
+      averagePercentage,
+      grade,
+      totalSpecs: specResults.length,
+      specResults,
+      summary
+    });
+  } catch (error2) {
+    return failure(
+      new ChangeError(
+        `\uD504\uB85C\uC81D\uD2B8 \uD488\uC9C8 \uBD84\uC11D \uC2E4\uD328: ${error2 instanceof Error ? error2.message : String(error2)}`
+      )
+    );
+  }
+}
+async function findSpecFiles2(dir, files) {
+  const entries = await fs13.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path23.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      await findSpecFiles2(fullPath, files);
+    } else if (entry.name === "spec.md") {
+      files.push(fullPath);
+    }
+  }
+}
+function formatQualityResult(result) {
+  const lines = [];
+  const gradeIcon = result.grade === "A" ? "\u{1F3C6}" : result.grade === "B" ? "\u2705" : result.grade === "C" ? "\u{1F7E1}" : result.grade === "D" ? "\u{1F7E0}" : "\u{1F534}";
+  lines.push(`\u{1F4CA} \uD488\uC9C8 \uBD84\uC11D: ${result.specId}`);
+  lines.push(`   ${gradeIcon} \uB4F1\uAE09: ${result.grade} (${result.percentage}%)`);
+  lines.push(`   \u{1F4C8} \uC810\uC218: ${result.totalScore}/${result.maxScore}`);
+  lines.push("");
+  lines.push("\u{1F4CB} \uD56D\uBAA9\uBCC4 \uC810\uC218:");
+  for (const item of result.items) {
+    const icon = item.percentage >= 80 ? "\u2705" : item.percentage >= 60 ? "\u{1F7E1}" : "\u{1F534}";
+    lines.push(`   ${icon} ${item.name}: ${item.score}/${item.maxScore} (${Math.round(item.percentage)}%)`);
+    for (const detail of item.details) {
+      lines.push(`      \u2514\u2500 ${detail}`);
+    }
+  }
+  lines.push("");
+  if (result.topSuggestions.length > 0) {
+    lines.push("\u{1F4A1} \uAC1C\uC120 \uC81C\uC548:");
+    for (const suggestion of result.topSuggestions) {
+      lines.push(`   - ${suggestion}`);
+    }
+  }
+  return lines.join("\n");
+}
+function formatProjectQualityResult(result) {
+  const lines = [];
+  const gradeIcon = result.grade === "A" ? "\u{1F3C6}" : result.grade === "B" ? "\u2705" : result.grade === "C" ? "\u{1F7E1}" : result.grade === "D" ? "\u{1F7E0}" : "\u{1F534}";
+  lines.push("\u{1F4CA} \uD504\uB85C\uC81D\uD2B8 \uD488\uC9C8 \uBD84\uC11D");
+  lines.push(`   ${gradeIcon} \uD3C9\uADE0 \uB4F1\uAE09: ${result.grade} (${result.averagePercentage}%)`);
+  lines.push(`   \u{1F4C8} \uBD84\uC11D\uB41C \uC2A4\uD399: ${result.totalSpecs}\uAC1C`);
+  lines.push("");
+  const gradeCount = { A: 0, B: 0, C: 0, D: 0, F: 0 };
+  for (const spec of result.specResults) {
+    gradeCount[spec.grade]++;
+  }
+  lines.push("\u{1F4C8} \uB4F1\uAE09 \uBD84\uD3EC:");
+  if (gradeCount.A > 0) lines.push(`   \u{1F3C6} A: ${gradeCount.A}\uAC1C`);
+  if (gradeCount.B > 0) lines.push(`   \u2705 B: ${gradeCount.B}\uAC1C`);
+  if (gradeCount.C > 0) lines.push(`   \u{1F7E1} C: ${gradeCount.C}\uAC1C`);
+  if (gradeCount.D > 0) lines.push(`   \u{1F7E0} D: ${gradeCount.D}\uAC1C`);
+  if (gradeCount.F > 0) lines.push(`   \u{1F534} F: ${gradeCount.F}\uAC1C`);
+  lines.push("");
+  lines.push("\u{1F4CB} \uC2A4\uD399\uBCC4 \uC810\uC218:");
+  const sortedSpecs = [...result.specResults].sort((a, b) => b.percentage - a.percentage);
+  for (const spec of sortedSpecs) {
+    const icon = spec.grade === "A" ? "\u{1F3C6}" : spec.grade === "B" ? "\u2705" : spec.grade === "C" ? "\u{1F7E1}" : spec.grade === "D" ? "\u{1F7E0}" : "\u{1F534}";
+    lines.push(`   ${icon} ${spec.specId}: ${spec.percentage}% (${spec.grade})`);
+  }
+  return lines.join("\n");
+}
+
+// src/cli/commands/quality.ts
+init_fs();
+init_errors();
+init_types();
+async function executeQuality(feature, options, projectRoot) {
+  const sddPath = path24.join(projectRoot, ".sdd");
+  const minScore = parseInt(options.minScore || "0", 10);
+  if (options.all || !feature) {
+    const result2 = await analyzeProjectQuality(sddPath);
+    if (!result2.success) {
+      return failure(result2.error);
+    }
+    const formatted2 = options.json ? JSON.stringify(result2.data, null, 2) : formatProjectQualityResult(result2.data);
+    return success({
+      type: "project",
+      data: result2.data,
+      formatted: formatted2,
+      passed: result2.data.averagePercentage >= minScore
+    });
+  }
+  const specPath = path24.join(sddPath, "specs", feature, "spec.md");
+  const result = await analyzeSpecQuality(specPath, sddPath);
+  if (!result.success) {
+    return failure(result.error);
+  }
+  const formatted = options.json ? JSON.stringify(result.data, null, 2) : formatQualityResult(result.data);
+  return success({
+    type: "spec",
+    data: result.data,
+    formatted,
+    passed: result.data.percentage >= minScore
+  });
+}
+function registerQualityCommand(program2) {
+  program2.command("quality [feature]").description("\uC2A4\uD399 \uD488\uC9C8\uC744 \uBD84\uC11D\uD558\uACE0 \uC810\uC218\uB97C \uC0B0\uCD9C\uD569\uB2C8\uB2E4").option("-a, --all", "\uC804\uCCB4 \uD504\uB85C\uC81D\uD2B8 \uBD84\uC11D").option("--json", "JSON \uD615\uC2DD \uCD9C\uB825").option("--min-score <score>", "\uCD5C\uC18C \uC810\uC218 \uAE30\uC900 (\uC774\uD558 \uC2DC \uC5D0\uB7EC)", "0").action(async (feature, options) => {
+    try {
+      await runQuality(feature, options);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+}
+async function runQuality(feature, options) {
+  const projectRoot = await findSddRoot();
+  if (!projectRoot) {
+    error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  const result = await executeQuality(feature, options, projectRoot);
+  if (!result.success) {
+    error(result.error.message);
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  console.log(result.data.formatted);
+  if (!result.data.passed) {
+    const minScore = parseInt(options.minScore || "0", 10);
+    newline();
+    error(`\uD488\uC9C8 \uC810\uC218\uAC00 \uCD5C\uC18C \uAE30\uC900(${minScore}%) \uBBF8\uB2EC\uC785\uB2C8\uB2E4.`);
+    process.exit(ExitCode.VALIDATION_FAILED);
+  }
+}
+
+// src/cli/commands/report.ts
+import path26 from "path";
+
+// src/core/report/reporter.ts
+init_types();
+init_errors();
+import path25 from "path";
+import fs14 from "fs/promises";
+init_fs();
+async function loadSpecList(specsPath) {
+  try {
+    if (!await fileExists(specsPath)) {
+      return failure(new ChangeError("\uC2A4\uD399 \uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    }
+    const result = await readDir(specsPath);
+    if (!result.success) {
+      return failure(new ChangeError("\uC2A4\uD399 \uB514\uB809\uD1A0\uB9AC\uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    }
+    const specs = [];
+    for (const entry of result.data) {
+      const featurePath = path25.join(specsPath, entry);
+      const stat = await fs14.stat(featurePath);
+      if (stat.isDirectory()) {
+        const specFile = path25.join(featurePath, "spec.md");
+        if (await fileExists(specFile)) {
+          const content = await fs14.readFile(specFile, "utf-8");
+          const metadata = parseSpecMetadata2(content);
+          specs.push({
+            id: entry,
+            title: metadata?.title,
+            phase: metadata?.phase,
+            status: metadata?.status,
+            description: metadata?.description
+          });
+        }
+      }
+    }
+    return success(specs);
+  } catch (error2) {
+    return failure(new ChangeError(error2 instanceof Error ? error2.message : String(error2)));
+  }
+}
+function parseSpecMetadata2(content) {
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!frontmatterMatch) return null;
+  const frontmatter = frontmatterMatch[1];
+  const result = {};
+  const lines = frontmatter.split("\n");
+  for (const line of lines) {
+    const match = line.match(/^(\w+):\s*['"]?([^'"]+)['"]?$/);
+    if (match) {
+      result[match[1]] = match[2].trim();
+    }
+  }
+  return {
+    title: result.title,
+    phase: result.phase,
+    status: result.status,
+    description: result.description
+  };
+}
+async function generateReport(sddPath, options) {
+  try {
+    const specsPath = path25.join(sddPath, "specs");
+    const specsResult = await loadSpecList(specsPath);
+    if (!specsResult.success) {
+      return failure(specsResult.error);
+    }
+    const specs = specsResult.data;
+    const reportData = {
+      title: options.title || "SDD \uD504\uB85C\uC81D\uD2B8 \uB9AC\uD3EC\uD2B8",
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      projectPath: sddPath,
+      specs,
+      summary: {
+        totalSpecs: specs.length,
+        byPhase: {},
+        byStatus: {}
+      }
+    };
+    for (const spec of specs) {
+      const phase = spec.phase || "unknown";
+      reportData.summary.byPhase[phase] = (reportData.summary.byPhase[phase] || 0) + 1;
+      const status = spec.status || "unknown";
+      reportData.summary.byStatus[status] = (reportData.summary.byStatus[status] || 0) + 1;
+    }
+    if (options.includeQuality !== false) {
+      const qualityResult = await analyzeProjectQuality(sddPath);
+      if (qualityResult.success) {
+        reportData.quality = qualityResult.data;
+        reportData.summary.averageQuality = qualityResult.data.averagePercentage;
+      }
+    }
+    if (options.includeValidation !== false) {
+      const validationResult = await validateSpecs(sddPath, { strict: false });
+      if (validationResult.success) {
+        reportData.validation = validationResult.data;
+        reportData.summary.validationErrors = validationResult.data.errorCount;
+        reportData.summary.validationWarnings = validationResult.data.warningCount;
+      }
+    }
+    let content;
+    switch (options.format) {
+      case "html":
+        content = renderHtmlReport(reportData);
+        break;
+      case "markdown":
+        content = renderMarkdownReport(reportData);
+        break;
+      case "json":
+        content = JSON.stringify(reportData, null, 2);
+        break;
+      default:
+        return failure(new ChangeError(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD615\uC2DD\uC785\uB2C8\uB2E4: ${options.format}`));
+    }
+    if (options.outputPath) {
+      await fs14.mkdir(path25.dirname(options.outputPath), { recursive: true });
+      await fs14.writeFile(options.outputPath, content, "utf-8");
+    }
+    return success({
+      format: options.format,
+      content,
+      outputPath: options.outputPath
+    });
+  } catch (error2) {
+    return failure(new ChangeError(error2 instanceof Error ? error2.message : String(error2)));
+  }
+}
+function renderHtmlReport(data) {
+  const gradeColor = (grade) => {
+    switch (grade) {
+      case "A":
+        return "#22c55e";
+      case "B":
+        return "#84cc16";
+      case "C":
+        return "#eab308";
+      case "D":
+        return "#f97316";
+      case "F":
+        return "#ef4444";
+      default:
+        return "#6b7280";
+    }
+  };
+  const statusBadge = (status) => {
+    const colors = {
+      draft: "#6b7280",
+      review: "#3b82f6",
+      approved: "#22c55e",
+      implemented: "#8b5cf6",
+      deprecated: "#ef4444"
+    };
+    const color = colors[status] || "#6b7280";
+    return `<span style="background:${color};color:white;padding:2px 8px;border-radius:4px;font-size:12px;">${status}</span>`;
+  };
+  const specRows = data.specs.map((spec) => `
+    <tr>
+      <td><strong>${spec.id}</strong></td>
+      <td>${spec.title || "-"}</td>
+      <td>${spec.phase || "-"}</td>
+      <td>${statusBadge(spec.status || "unknown")}</td>
+      <td>${spec.description || "-"}</td>
+    </tr>
+  `).join("");
+  const qualityRows = data.quality?.specResults?.map((q) => `
+    <tr>
+      <td>${q.specId}</td>
+      <td>${q.percentage}%</td>
+      <td style="color:${gradeColor(q.grade)};font-weight:bold;">${q.grade}</td>
+      <td>${q.totalScore}/${q.maxScore}</td>
+    </tr>
+  `).join("") || "";
+  const validationRows = data.validation?.files?.map((v) => `
+    <tr>
+      <td>${v.file}</td>
+      <td style="color:${v.errors.length > 0 ? "#ef4444" : "#22c55e"};">${v.errors.length > 0 ? "\u274C \uC2E4\uD328" : "\u2705 \uD1B5\uACFC"}</td>
+      <td>${v.errors.length}</td>
+      <td>${v.warnings.length}</td>
+    </tr>
+  `).join("") || "";
+  return `<!DOCTYPE html>
+<html lang="ko">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${data.title}</title>
+  <style>
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; line-height: 1.6; color: #1f2937; background: #f9fafb; padding: 2rem; }
+    .container { max-width: 1200px; margin: 0 auto; }
+    h1 { font-size: 2rem; margin-bottom: 0.5rem; color: #111827; }
+    h2 { font-size: 1.5rem; margin: 2rem 0 1rem; color: #374151; border-bottom: 2px solid #e5e7eb; padding-bottom: 0.5rem; }
+    .meta { color: #6b7280; margin-bottom: 2rem; }
+    .summary { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 1rem; margin-bottom: 2rem; }
+    .card { background: white; border-radius: 8px; padding: 1.5rem; box-shadow: 0 1px 3px rgba(0,0,0,0.1); }
+    .card-title { font-size: 0.875rem; color: #6b7280; margin-bottom: 0.5rem; }
+    .card-value { font-size: 2rem; font-weight: bold; color: #111827; }
+    .card-value.success { color: #22c55e; }
+    .card-value.warning { color: #eab308; }
+    .card-value.error { color: #ef4444; }
+    table { width: 100%; border-collapse: collapse; background: white; border-radius: 8px; overflow: hidden; box-shadow: 0 1px 3px rgba(0,0,0,0.1); margin-bottom: 2rem; }
+    th, td { padding: 0.75rem 1rem; text-align: left; border-bottom: 1px solid #e5e7eb; }
+    th { background: #f3f4f6; font-weight: 600; color: #374151; }
+    tr:hover { background: #f9fafb; }
+    .phase-chart { display: flex; gap: 0.5rem; flex-wrap: wrap; }
+    .phase-item { background: #e0e7ff; color: #3730a3; padding: 0.25rem 0.75rem; border-radius: 9999px; font-size: 0.875rem; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h1>${data.title}</h1>
+    <p class="meta">\uC0DD\uC131: ${new Date(data.generatedAt).toLocaleString("ko-KR")} | \uACBD\uB85C: ${data.projectPath}</p>
+
+    <div class="summary">
+      <div class="card">
+        <div class="card-title">\uCD1D \uC2A4\uD399 \uC218</div>
+        <div class="card-value">${data.summary.totalSpecs}</div>
+      </div>
+      ${data.summary.averageQuality !== void 0 ? `
+      <div class="card">
+        <div class="card-title">\uD3C9\uADE0 \uD488\uC9C8</div>
+        <div class="card-value ${data.summary.averageQuality >= 80 ? "success" : data.summary.averageQuality >= 60 ? "warning" : "error"}">${data.summary.averageQuality.toFixed(1)}%</div>
+      </div>` : ""}
+      ${data.summary.validationErrors !== void 0 ? `
+      <div class="card">
+        <div class="card-title">\uAC80\uC99D \uC5D0\uB7EC</div>
+        <div class="card-value ${data.summary.validationErrors === 0 ? "success" : "error"}">${data.summary.validationErrors}</div>
+      </div>` : ""}
+      ${data.summary.validationWarnings !== void 0 ? `
+      <div class="card">
+        <div class="card-title">\uAC80\uC99D \uACBD\uACE0</div>
+        <div class="card-value ${data.summary.validationWarnings === 0 ? "success" : "warning"}">${data.summary.validationWarnings}</div>
+      </div>` : ""}
+    </div>
+
+    <h2>Phase\uBCC4 \uBD84\uD3EC</h2>
+    <div class="phase-chart">
+      ${Object.entries(data.summary.byPhase).map(([phase, count]) => `
+        <span class="phase-item">${phase}: ${count}</span>
+      `).join("")}
+    </div>
+
+    <h2>\uC2A4\uD399 \uBAA9\uB85D</h2>
+    <table>
+      <thead>
+        <tr>
+          <th>ID</th>
+          <th>\uC81C\uBAA9</th>
+          <th>Phase</th>
+          <th>\uC0C1\uD0DC</th>
+          <th>\uC124\uBA85</th>
+        </tr>
+      </thead>
+      <tbody>
+        ${specRows}
+      </tbody>
+    </table>
+
+    ${data.quality ? `
+    <h2>\uD488\uC9C8 \uBD84\uC11D</h2>
+    <table>
+      <thead>
+        <tr>
+          <th>\uC2A4\uD399 ID</th>
+          <th>\uC810\uC218</th>
+          <th>\uB4F1\uAE09</th>
+          <th>\uC0C1\uC138</th>
+        </tr>
+      </thead>
+      <tbody>
+        ${qualityRows}
+      </tbody>
+    </table>` : ""}
+
+    ${data.validation ? `
+    <h2>\uAC80\uC99D \uACB0\uACFC</h2>
+    <table>
+      <thead>
+        <tr>
+          <th>\uD30C\uC77C</th>
+          <th>\uC0C1\uD0DC</th>
+          <th>\uC5D0\uB7EC</th>
+          <th>\uACBD\uACE0</th>
+        </tr>
+      </thead>
+      <tbody>
+        ${validationRows}
+      </tbody>
+    </table>` : ""}
+
+    <footer style="margin-top:3rem;padding-top:1rem;border-top:1px solid #e5e7eb;color:#6b7280;font-size:0.875rem;">
+      Generated by SDD CLI v0.5.0
+    </footer>
+  </div>
+</body>
+</html>`;
+}
+function renderMarkdownReport(data) {
+  const lines = [];
+  lines.push(`# ${data.title}`);
+  lines.push("");
+  lines.push(`> \uC0DD\uC131: ${new Date(data.generatedAt).toLocaleString("ko-KR")}`);
+  lines.push(`> \uACBD\uB85C: ${data.projectPath}`);
+  lines.push("");
+  lines.push("## \uC694\uC57D");
+  lines.push("");
+  lines.push(`| \uD56D\uBAA9 | \uAC12 |`);
+  lines.push(`|------|-----|`);
+  lines.push(`| \uCD1D \uC2A4\uD399 \uC218 | ${data.summary.totalSpecs} |`);
+  if (data.summary.averageQuality !== void 0) {
+    lines.push(`| \uD3C9\uADE0 \uD488\uC9C8 | ${data.summary.averageQuality.toFixed(1)}% |`);
+  }
+  if (data.summary.validationErrors !== void 0) {
+    lines.push(`| \uAC80\uC99D \uC5D0\uB7EC | ${data.summary.validationErrors} |`);
+  }
+  if (data.summary.validationWarnings !== void 0) {
+    lines.push(`| \uAC80\uC99D \uACBD\uACE0 | ${data.summary.validationWarnings} |`);
+  }
+  lines.push("");
+  lines.push("## Phase\uBCC4 \uBD84\uD3EC");
+  lines.push("");
+  for (const [phase, count] of Object.entries(data.summary.byPhase)) {
+    lines.push(`- **${phase}**: ${count}\uAC1C`);
+  }
+  lines.push("");
+  lines.push("## \uC0C1\uD0DC\uBCC4 \uBD84\uD3EC");
+  lines.push("");
+  for (const [status, count] of Object.entries(data.summary.byStatus)) {
+    lines.push(`- **${status}**: ${count}\uAC1C`);
+  }
+  lines.push("");
+  lines.push("## \uC2A4\uD399 \uBAA9\uB85D");
+  lines.push("");
+  lines.push("| ID | \uC81C\uBAA9 | Phase | \uC0C1\uD0DC |");
+  lines.push("|----|------|-------|------|");
+  for (const spec of data.specs) {
+    lines.push(`| ${spec.id} | ${spec.title || "-"} | ${spec.phase || "-"} | ${spec.status || "-"} |`);
+  }
+  lines.push("");
+  if (data.quality) {
+    lines.push("## \uD488\uC9C8 \uBD84\uC11D");
+    lines.push("");
+    lines.push(`\uD3C9\uADE0 \uC810\uC218: **${data.quality.averagePercentage.toFixed(1)}%** (${data.quality.grade})`);
+    lines.push("");
+    lines.push("| \uC2A4\uD399 ID | \uC810\uC218 | \uB4F1\uAE09 |");
+    lines.push("|---------|------|------|");
+    for (const q of data.quality.specResults || []) {
+      lines.push(`| ${q.specId} | ${q.percentage}% | ${q.grade} |`);
+    }
+    lines.push("");
+  }
+  if (data.validation) {
+    lines.push("## \uAC80\uC99D \uACB0\uACFC");
+    lines.push("");
+    lines.push(`- \uD1B5\uACFC: ${data.validation.passed}\uAC1C`);
+    lines.push(`- \uC2E4\uD328: ${data.validation.failed}\uAC1C`);
+    lines.push(`- \uACBD\uACE0: ${data.validation.warnings}\uAC1C`);
+    lines.push("");
+    if (data.validation.failed > 0 || data.validation.warnings > 0) {
+      lines.push("### \uC0C1\uC138 \uACB0\uACFC");
+      lines.push("");
+      for (const v of data.validation.files || []) {
+        if (v.errors.length > 0 || v.warnings.length > 0) {
+          lines.push(`#### ${v.file}`);
+          for (const e of v.errors) {
+            lines.push(`- ${e}`);
+          }
+          for (const w of v.warnings) {
+            lines.push(`- ${w}`);
+          }
+          lines.push("");
+        }
+      }
+    }
+  }
+  lines.push("---");
+  lines.push("*Generated by SDD CLI v0.5.0*");
+  return lines.join("\n");
+}
+
+// src/cli/commands/report.ts
+init_fs();
+init_errors();
+init_types();
+function isValidReportFormat(format) {
+  return ["html", "markdown", "json"].includes(format);
+}
+function resolveOutputPath(format, output, projectRoot) {
+  if (!output) {
+    const ext = format === "markdown" ? "md" : format;
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    return path26.join(projectRoot, `sdd-report-${timestamp}.${ext}`);
+  }
+  return path26.isAbsolute(output) ? output : path26.join(projectRoot, output);
+}
+async function executeReport(options, projectRoot) {
+  const sddPath = path26.join(projectRoot, ".sdd");
+  const format = options.format || "html";
+  if (!isValidReportFormat(format)) {
+    return failure(new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD615\uC2DD\uC785\uB2C8\uB2E4: ${format}. \uC9C0\uC6D0 \uD615\uC2DD: html, markdown, json`));
+  }
+  const outputPath = resolveOutputPath(format, options.output, projectRoot);
+  const result = await generateReport(sddPath, {
+    format,
+    outputPath,
+    title: options.title,
+    includeQuality: options.quality !== false,
+    includeValidation: options.validation !== false
+  });
+  if (!result.success) {
+    return failure(result.error);
+  }
+  return success({
+    format,
+    outputPath: result.data.outputPath || outputPath,
+    content: result.data.content
+  });
+}
+function registerReportCommand(program2) {
+  program2.command("report").description("\uC2A4\uD399 \uB9AC\uD3EC\uD2B8\uB97C \uC0DD\uC131\uD569\uB2C8\uB2E4").option("-f, --format <format>", "\uCD9C\uB825 \uD615\uC2DD (html, markdown, json)", "html").option("-o, --output <path>", "\uCD9C\uB825 \uD30C\uC77C \uACBD\uB85C").option("--title <title>", "\uB9AC\uD3EC\uD2B8 \uC81C\uBAA9").option("--no-quality", "\uD488\uC9C8 \uBD84\uC11D \uC81C\uC678").option("--no-validation", "\uAC80\uC99D \uACB0\uACFC \uC81C\uC678").action(async (options) => {
+    try {
+      await runReport(options);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+}
+async function runReport(options) {
+  const projectRoot = await findSddRoot();
+  if (!projectRoot) {
+    error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  const format = options.format || "html";
+  info("\u{1F4CA} \uB9AC\uD3EC\uD2B8 \uC0DD\uC131 \uC911...");
+  info(`   \uD615\uC2DD: ${format}`);
+  info(`   \uD488\uC9C8 \uBD84\uC11D: ${options.quality !== false ? "\uD3EC\uD568" : "\uC81C\uC678"}`);
+  info(`   \uAC80\uC99D \uACB0\uACFC: ${options.validation !== false ? "\uD3EC\uD568" : "\uC81C\uC678"}`);
+  newline();
+  const result = await executeReport(options, projectRoot);
+  if (!result.success) {
+    error(result.error.message);
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  success2(`\u2705 \uB9AC\uD3EC\uD2B8\uAC00 \uC0DD\uC131\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`);
+  info(`   \uACBD\uB85C: ${result.data.outputPath}`);
+  if (!options.output && format === "json") {
+    newline();
+    console.log(result.data.content);
+  }
+}
+
 // src/cli/index.ts
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../../package.json");
@@ -9104,6 +11207,9 @@ registerStartCommand(program);
 registerMigrateCommand(program);
 registerCicdCommand(program);
 registerTransitionCommand(program);
+registerWatchCommand(program);
+registerQualityCommand(program);
+registerReportCommand(program);
 function run() {
   program.parse();
 }