sdd-tool 0.5.0 → 0.6.0

package/dist/cli/index.js

@@ -128,10 +128,10 @@ var init_base = __esm({
     };
     FileSystemError = class extends SddError {
       path;
-      constructor(code, path27) {
-        super(code, formatMessage(code, path27), ExitCode.FILE_SYSTEM_ERROR);
+      constructor(code, path29) {
+        super(code, formatMessage(code, path29), ExitCode.FILE_SYSTEM_ERROR);
         this.name = "FileSystemError";
-        this.path = path27;
+        this.path = path29;
       }
     };
     ValidationError = class extends SddError {
@@ -2497,34 +2497,272 @@ sdd transition change-to-new <change-id>
 \`\`\`bash
 sdd transition guide
 \`\`\`
+`
+    },
+    // CLI 래퍼 커맨드들
+    {
+      name: "sdd.search",
+      content: `---
+description: SDD \uC2A4\uD399\uC744 \uAC80\uC0C9\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read
+argument-hint: [query] [--status draft] [--phase phase1]
+---
+
+sdd search \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd search $ARGUMENTS
+\`\`\`
+
+## \uC635\uC158
+
+- \`--status <status>\`: \uC0C1\uD0DC \uD544\uD130 (draft, review, approved)
+- \`--phase <phase>\`: Phase \uD544\uD130
+- \`--author <name>\`: \uC791\uC131\uC790 \uD544\uD130
+- \`--tags <tags>\`: \uD0DC\uADF8 \uD544\uD130 (\uCF64\uB9C8 \uAD6C\uBD84)
+- \`--depends-on <spec>\`: \uC758\uC874\uC131 \uD544\uD130
+- \`--limit <n>\`: \uACB0\uACFC \uC81C\uD55C
+- \`--sort-by <field>\`: \uC815\uB82C \uAE30\uC900 (relevance, created, updated, title, status)
+- \`-r, --regex\`: \uC815\uADDC\uC2DD \uAC80\uC0C9
+- \`-c, --case-sensitive\`: \uB300\uC18C\uBB38\uC790 \uAD6C\uBD84
+- \`--json\`: JSON \uCD9C\uB825
+
+\uAC80\uC0C9 \uACB0\uACFC\uB97C \uBD84\uC11D\uD558\uACE0 \uAD00\uB828 \uC2A4\uD399 \uC815\uBCF4\uB97C \uC694\uC57D\uD574\uC8FC\uC138\uC694.
+`
+    },
+    {
+      name: "sdd.quality",
+      content: `---
+description: SDD \uC2A4\uD399 \uD488\uC9C8\uC744 \uBD84\uC11D\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read
+argument-hint: [specId] [--all] [--json]
+---
+
+sdd quality \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd quality $ARGUMENTS
+\`\`\`
+
+## \uC635\uC158
+
+- \`--all\`: \uBAA8\uB4E0 \uC2A4\uD399 \uBD84\uC11D
+- \`--json\`: JSON \uD615\uC2DD \uCD9C\uB825
+- \`--min-score <n>\`: \uCD5C\uC18C \uC810\uC218 \uAE30\uC900
+
+## \uB4F1\uAE09 \uAE30\uC900
+
+| \uB4F1\uAE09 | \uC810\uC218 | \uC124\uBA85 |
+|------|------|------|
+| A | 90-100 | \uC6B0\uC218 |
+| B | 80-89 | \uC591\uD638 |
+| C | 70-79 | \uBCF4\uD1B5 |
+| D | 60-69 | \uBBF8\uD761 |
+| F | 0-59 | \uBD80\uC871 |
+
+\uBD84\uC11D \uACB0\uACFC\uB97C \uBC14\uD0D5\uC73C\uB85C \uD488\uC9C8 \uAC1C\uC120 \uBC29\uC548\uC744 \uC81C\uC548\uD574\uC8FC\uC138\uC694.
+`
+    },
+    {
+      name: "sdd.report",
+      content: `---
+description: SDD \uD504\uB85C\uC81D\uD2B8 \uB9AC\uD3EC\uD2B8\uB97C \uC0DD\uC131\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read, Write
+argument-hint: [--format html] [-o report.html]
+---
+
+sdd report \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd report $ARGUMENTS
+\`\`\`
+
+## \uC635\uC158
+
+- \`--format <type>\`: \uCD9C\uB825 \uD615\uC2DD (html, markdown, json)
+- \`-o, --output <path>\`: \uD30C\uC77C\uB85C \uC800\uC7A5
+- \`--title <title>\`: \uB9AC\uD3EC\uD2B8 \uC81C\uBAA9
+- \`--no-quality\`: \uD488\uC9C8 \uBD84\uC11D \uC81C\uC678
+- \`--no-validation\`: \uAC80\uC99D \uACB0\uACFC \uC81C\uC678
+
+\uB9AC\uD3EC\uD2B8 \uB0B4\uC6A9\uC744 \uC694\uC57D\uD558\uACE0 \uC8FC\uC694 \uC9C0\uD45C\uB97C \uC124\uBA85\uD574\uC8FC\uC138\uC694.
+`
+    },
+    {
+      name: "sdd.impact",
+      content: `---
+description: SDD \uC2A4\uD399 \uBCC0\uACBD\uC758 \uC601\uD5A5\uB3C4\uB97C \uBD84\uC11D\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read
+argument-hint: <specId> [--graph] [--code] [--json]
+---
+
+sdd impact \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd impact $ARGUMENTS
+\`\`\`
+
+## \uC635\uC158
+
+- \`--graph\`: Mermaid \uC758\uC874\uC131 \uADF8\uB798\uD504 \uCD9C\uB825
+- \`--code\`: \uCF54\uB4DC \uC601\uD5A5\uB3C4 \uBD84\uC11D
+- \`--json\`: JSON \uD615\uC2DD \uCD9C\uB825
+
+## \uC11C\uBE0C\uCEE4\uB9E8\uB4DC
+
+- \`report\`: \uC804\uCCB4 \uD504\uB85C\uC81D\uD2B8 \uC601\uD5A5\uB3C4 \uB9AC\uD3EC\uD2B8
+- \`change <id>\`: \uBCC0\uACBD \uC81C\uC548\uC758 \uC601\uD5A5\uB3C4
+- \`simulate --remove <spec>\`: What-if \uC2DC\uBBAC\uB808\uC774\uC158
+
+\uC601\uD5A5\uBC1B\uB294 \uC2A4\uD399\uACFC \uCF54\uB4DC\uB97C \uBD84\uC11D\uD558\uACE0 \uBCC0\uACBD \uC804\uB7B5\uC744 \uC81C\uC548\uD574\uC8FC\uC138\uC694.
+`
+    },
+    {
+      name: "sdd.list",
+      content: `---
+description: SDD \uD56D\uBAA9 \uBAA9\uB85D\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read
+argument-hint: [features|changes|specs|templates] [--status draft]
+---
+
+sdd list \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd list $ARGUMENTS
+\`\`\`
+
+## \uC11C\uBE0C\uCEE4\uB9E8\uB4DC
+
+- (\uC5C6\uC74C): \uD504\uB85C\uC81D\uD2B8 \uC694\uC57D
+- \`features\` (f): \uAE30\uB2A5 \uBAA9\uB85D
+- \`changes\` (c): \uBCC0\uACBD \uBAA9\uB85D
+- \`specs\` (s): \uC2A4\uD399 \uD30C\uC77C \uBAA9\uB85D
+- \`templates\` (t): \uD15C\uD50C\uB9BF \uBAA9\uB85D
+
+## \uC635\uC158
+
+- \`--status <status>\`: \uC0C1\uD0DC\uBCC4 \uD544\uD130 (features)
+- \`--pending\`: \uB300\uAE30 \uC911\uB9CC (changes)
+- \`--archived\`: \uC544\uCE74\uC774\uBE0C\uB9CC (changes)
+
+\uBAA9\uB85D\uC744 \uBD84\uC11D\uD558\uACE0 \uC694\uC57D\uD574\uC8FC\uC138\uC694.
+`
+    },
+    {
+      name: "sdd.migrate",
+      content: `---
+description: \uAE30\uC874 \uD504\uB85C\uC81D\uD2B8\uB97C SDD\uB85C \uB9C8\uC774\uADF8\uB808\uC774\uC158\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read
+argument-hint: [detect|openspec|speckit|docs] [--dry-run]
+---
+
+sdd migrate \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd migrate $ARGUMENTS
+\`\`\`
+
+## \uC11C\uBE0C\uCEE4\uB9E8\uB4DC
+
+- \`detect\`: \uAE30\uC874 \uB3C4\uAD6C \uAC10\uC9C0
+- \`openspec\`: OpenSpec\uC5D0\uC11C \uB9C8\uC774\uADF8\uB808\uC774\uC158
+- \`speckit\`: SpecKit\uC5D0\uC11C \uB9C8\uC774\uADF8\uB808\uC774\uC158
+- \`docs\`: \uB9C8\uD06C\uB2E4\uC6B4 \uBB38\uC11C \uBCC0\uD658
+
+## \uC635\uC158
+
+- \`--dry-run\`: \uBBF8\uB9AC\uBCF4\uAE30
+- \`--overwrite\`: \uAE30\uC874 \uC2A4\uD399 \uB36E\uC5B4\uC4F0\uAE30
+- \`--source <path>\`: \uC18C\uC2A4 \uB514\uB809\uD1A0\uB9AC
+
+\uB9C8\uC774\uADF8\uB808\uC774\uC158 \uACB0\uACFC\uB97C \uD655\uC778\uD558\uACE0 \uD544\uC694\uD55C \uD6C4\uC18D \uC791\uC5C5\uC744 \uC548\uB0B4\uD574\uC8FC\uC138\uC694.
+`
+    },
+    {
+      name: "sdd.cicd",
+      content: `---
+description: CI/CD \uD30C\uC774\uD504\uB77C\uC778\uC744 \uC124\uC815\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read, Write
+argument-hint: [setup|hooks|check] [--platform github]
+---
+
+sdd cicd \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd cicd $ARGUMENTS
+\`\`\`
+
+## \uC11C\uBE0C\uCEE4\uB9E8\uB4DC
+
+- \`setup\`: CI/CD \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC0DD\uC131
+- \`hooks\`: Git hooks \uC124\uC815
+- \`check\`: CI \uAC80\uC99D \uC2E4\uD589
+
+## \uC635\uC158
+
+- \`--platform <type>\`: github, gitlab, all
+
+\uC0DD\uC131\uB41C CI/CD \uC124\uC815\uC744 \uD655\uC778\uD558\uACE0 \uCD94\uAC00 \uC124\uC815\uC774 \uD544\uC694\uD558\uBA74 \uC548\uB0B4\uD574\uC8FC\uC138\uC694.
+`
+    },
+    {
+      name: "sdd.watch",
+      content: `---
+description: \uC2A4\uD399 \uD30C\uC77C \uBCC0\uACBD\uC744 \uAC10\uC2DC\uD569\uB2C8\uB2E4
+allowed-tools: Bash
+argument-hint: [--validate] [--path .sdd/specs]
+---
+
+sdd watch \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd watch $ARGUMENTS
+\`\`\`
+
+## \uC635\uC158
+
+- \`--path <dir>\`: \uAC10\uC2DC\uD560 \uB514\uB809\uD1A0\uB9AC
+- \`--validate\`: \uBCC0\uACBD \uC2DC \uC790\uB3D9 \uAC80\uC99D
+- \`--quality\`: \uBCC0\uACBD \uC2DC \uD488\uC9C8 \uAC80\uC0AC
+
+Ctrl+C\uB85C \uC885\uB8CC\uD569\uB2C8\uB2E4.
+`
+    },
+    {
+      name: "sdd.prompt",
+      content: `---
+description: SDD \uC791\uC5C5\uC6A9 AI \uD504\uB86C\uD504\uD2B8\uB97C \uCD9C\uB825\uD569\uB2C8\uB2E4
+allowed-tools: Bash, Read
+argument-hint: [change|apply|archive|validate] [--list]
+---
+
+sdd prompt \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD569\uB2C8\uB2E4.
+
+\`\`\`bash
+sdd prompt $ARGUMENTS
+\`\`\`
+
+## \uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uD504\uB86C\uD504\uD2B8
+
+- \`change\`: \uBCC0\uACBD \uC81C\uC548 \uC791\uC131
+- \`apply\`: \uBCC0\uACBD \uC801\uC6A9
+- \`archive\`: \uBCC0\uACBD \uC544\uCE74\uC774\uBE0C
+- \`validate\`: \uC2A4\uD399 \uAC80\uC99D
+
+## \uC635\uC158
+
+- \`--list\`: \uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uD504\uB86C\uD504\uD2B8 \uBAA9\uB85D
+
+\uD504\uB86C\uD504\uD2B8 \uB0B4\uC6A9\uC744 \uCD9C\uB825\uD558\uACE0 \uC0AC\uC6A9 \uBC29\uBC95\uC744 \uC548\uB0B4\uD574\uC8FC\uC138\uC694.
 `
     }
   ];
 }
 
 // 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 +2771,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 +2809,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 +2840,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 +2965,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 +2999,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 +3053,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 +3934,9 @@ async function validateSpecs(targetPath, options = {}) {
 async function findSpecFiles(dirPath) {
   const files = [];
   async function scanDir(dir) {
-    const { promises: fs15 } = await import("fs");
+    const { promises: fs16 } = await import("fs");
     try {
-      const entries = await fs15.readdir(dir, { withFileTypes: true });
+      const entries = await fs16.readdir(dir, { withFileTypes: true });
       for (const entry of entries) {
         const fullPath = path3.join(dir, entry.name);
         if (entry.isDirectory()) {
@@ -3661,26 +3964,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 +3985,75 @@ async function runValidate(targetPath, options) {
     const constitutionPath = path4.join(sddRoot, ".sdd", "constitution.md");
     hasConstitution = await fileExists(constitutionPath);
   }
-  if (!options.quiet) {
-    info(`\uAC80\uC99D \uC911: ${resolvedPath}`);
+  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: ${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,6 +5245,149 @@ async function listPendingChanges(sddPath) {
 // src/cli/commands/change.ts
 init_fs();
 init_errors();
+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
+  });
+}
+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
+  });
+  const proposalPath = path6.join(changePath, "proposal.md");
+  await writeFile(proposalPath, proposal);
+  const delta = generateDelta({
+    proposalId: newId,
+    title: title2
+  });
+  const deltaPath = path6.join(changePath, "delta.md");
+  await writeFile(deltaPath, delta);
+  return success({
+    id: newId,
+    proposalPath,
+    deltaPath
+  });
+}
+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 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 {
@@ -4967,7 +5438,7 @@ async function runChange(id, options) {
   }
   const sddPath = path6.join(projectRoot, ".sdd");
   if (options.list) {
-    const result = await listPendingChanges(sddPath);
+    const result = await getChangeListItems(sddPath);
     if (!result.success) {
       error(result.error.message);
       process.exit(ExitCode.GENERAL_ERROR);
@@ -4985,53 +5456,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 +5504,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 +5542,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 +5595,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 +5631,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 +6059,19 @@ function detectCircularDependencies(graph) {
   const cycles = [];
   const visited = /* @__PURE__ */ new Set();
   const recStack = /* @__PURE__ */ new Set();
-  function dfs(nodeId, path27) {
+  function dfs(nodeId, path29) {
     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, [...path27, nodeId])) {
+        if (dfs(depId, [...path29, nodeId])) {
           return true;
         }
       } else if (recStack.has(depId)) {
-        const cycleStart = path27.indexOf(depId);
-        const cycle = cycleStart >= 0 ? [...path27.slice(cycleStart), nodeId, depId] : [nodeId, depId];
+        const cycleStart = path29.indexOf(depId);
+        const cycle = cycleStart >= 0 ? [...path29.slice(cycleStart), nodeId, depId] : [nodeId, depId];
         cycles.push({
           cycle,
           description: `\uC21C\uD658 \uC758\uC874\uC131: ${cycle.join(" \u2192 ")}`
@@ -6635,6 +7059,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 +7202,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 +7234,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 +7252,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 +7270,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 +7288,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 +7296,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,58 +7307,201 @@ 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();
+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);
@@ -6886,193 +7526,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 +7666,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 +7736,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 +7746,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,52 +7762,56 @@ 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;
   }
-  if (options.json) {
-    console.log(JSON.stringify(status, null, 2));
-  } else {
-    printStatus(status, options.verbose);
+  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";
   }
 }
-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;
+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;
   }
-  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
-    };
+  if (options.json) {
+    console.log(JSON.stringify(status, null, 2));
+  } else {
+    printStatus(status, options.verbose);
   }
-  return info2;
 }
 function printStatus(status, verbose) {
   console.log("");
@@ -7333,7 +7892,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 +7916,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 +7946,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 +8067,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 +8088,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,111 +8101,192 @@ 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: ${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");
+  console.log("  sdd list changes  - \uBCC0\uACBD \uBAA9\uB85D");
+  console.log("  sdd list specs    - \uC2A4\uD399 \uD30C\uC77C \uBAA9\uB85D");
+  console.log("  sdd status        - \uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC");
+  console.log("");
+}
+
+// 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;
       }
     }
   }
-  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("");
-  console.log("\uC0C1\uC138 \uC815\uBCF4:");
-  console.log("  sdd list features - \uAE30\uB2A5 \uBAA9\uB85D");
-  console.log("  sdd list changes  - \uBCC0\uACBD \uBAA9\uB85D");
-  console.log("  sdd list specs    - \uC2A4\uD399 \uD30C\uC77C \uBAA9\uB85D");
-  console.log("  sdd status        - \uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC");
-  console.log("");
+  const allEntries = [newEntry, ...existingEntries];
+  const newChangelog = generateChangelog(allEntries);
+  await writeFile(changelogPath, newChangelog);
+  return success({
+    previousVersion: currentVersion,
+    newVersion,
+    changelogPath
+  });
 }
-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";
+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
+  });
 }
-
-// src/cli/commands/constitution.ts
-init_fs();
-init_errors();
-import path15 from "path";
 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 +8335,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 +8384,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 +8434,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 +8463,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 +8487,7 @@ async function runStart(options) {
   newline();
   displayWorkflowMenu(projectStatus);
 }
-async function getProjectStatus() {
+async function getProjectStatus2() {
   const projectRoot = await findSddRoot();
   if (!projectRoot) {
     return {
@@ -7903,7 +8516,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)) {
@@ -8140,7 +8753,7 @@ function displayConstitutionGuide() {
 
 // src/cli/commands/migrate.ts
 import path18 from "path";
-import { promises as fs12 } from "fs";
+import { promises as fs11 } from "fs";
 init_errors();
 init_fs();
 init_new();
@@ -8151,7 +8764,7 @@ init_types();
 init_errors();
 init_fs();
 import path17 from "path";
-import fs11 from "fs/promises";
+import fs10 from "fs/promises";
 async function detectExternalTools(projectRoot) {
   try {
     const results = [];
@@ -8188,13 +8801,13 @@ async function detectOpenSpec(projectRoot) {
   }
   const specs = [];
   if (hasSpecs) {
-    const specDirs = await fs11.readdir(specsPath, { withFileTypes: true });
+    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 fs11.readFile(specFile, "utf-8");
+          const content = await fs10.readFile(specFile, "utf-8");
           const title2 = extractTitle2(content);
           const status = extractFrontmatterField(content, "status");
           specs.push({
@@ -8229,7 +8842,7 @@ async function detectSpecKit(projectRoot) {
     return null;
   }
   const specs = [];
-  const specDirs = await fs11.readdir(specsPath, { withFileTypes: true });
+  const specDirs = await fs10.readdir(specsPath, { withFileTypes: true });
   for (const entry of specDirs) {
     if (entry.isDirectory()) {
       const specPath = path17.join(specsPath, entry.name);
@@ -8243,7 +8856,7 @@ async function detectSpecKit(projectRoot) {
         let title2;
         let status;
         if (hasSpec) {
-          const content = await fs11.readFile(specFile, "utf-8");
+          const content = await fs10.readFile(specFile, "utf-8");
           title2 = extractTitle2(content);
           status = extractFrontmatterField(content, "status");
         }
@@ -8275,13 +8888,13 @@ async function detectSdd(projectRoot) {
     return null;
   }
   const specs = [];
-  const specDirs = await fs11.readdir(specsPath, { withFileTypes: true });
+  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 fs11.readFile(specFile, "utf-8");
+        const content = await fs10.readFile(specFile, "utf-8");
         const title2 = extractTitle2(content);
         const status = extractFrontmatterField(content, "status");
         specs.push({
@@ -8311,7 +8924,7 @@ async function migrateFromOpenSpec(sourcePath, targetPath, options = {}) {
     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 fs11.readdir(specsPath, { withFileTypes: true });
+    const specDirs = await fs10.readdir(specsPath, { withFileTypes: true });
     for (const entry of specDirs) {
       if (!entry.isDirectory()) continue;
       const sourceSpecPath = path17.join(specsPath, entry.name);
@@ -8324,18 +8937,18 @@ async function migrateFromOpenSpec(sourcePath, targetPath, options = {}) {
       }
       try {
         if (!options.dryRun) {
-          await fs11.mkdir(targetSpecPath, { recursive: true });
-          const files = await fs11.readdir(sourceSpecPath);
+          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 fs11.stat(sourceFile);
+            const stat = await fs10.stat(sourceFile);
             if (stat.isFile()) {
-              let content = await fs11.readFile(sourceFile, "utf-8");
+              let content = await fs10.readFile(sourceFile, "utf-8");
               if (file === "spec.md") {
                 content = convertOpenSpecToSdd(content, entry.name);
               }
-              await fs11.writeFile(targetFile, content);
+              await fs10.writeFile(targetFile, content);
             }
           }
         }
@@ -8365,7 +8978,7 @@ async function migrateFromSpecKit(sourcePath, targetPath, options = {}) {
     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 fs11.readdir(specsPath, { withFileTypes: true });
+    const specDirs = await fs10.readdir(specsPath, { withFileTypes: true });
     for (const entry of specDirs) {
       if (!entry.isDirectory()) continue;
       const sourceSpecPath = path17.join(specsPath, entry.name);
@@ -8378,18 +8991,18 @@ async function migrateFromSpecKit(sourcePath, targetPath, options = {}) {
       }
       try {
         if (!options.dryRun) {
-          await fs11.mkdir(targetSpecPath, { recursive: true });
-          const files = await fs11.readdir(sourceSpecPath);
+          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 fs11.stat(sourceFile);
+            const stat = await fs10.stat(sourceFile);
             if (stat.isFile()) {
-              let content = await fs11.readFile(sourceFile, "utf-8");
+              let content = await fs10.readFile(sourceFile, "utf-8");
               if (file === "spec.md") {
                 content = convertSpecKitToSdd(content, entry.name);
               }
-              await fs11.writeFile(targetFile, content);
+              await fs10.writeFile(targetFile, content);
             }
           }
         }
@@ -8547,7 +9160,7 @@ async function runMigrateDocs(source, options) {
   const sourcePath = path18.resolve(source);
   let files = [];
   try {
-    const stat = await fs12.stat(sourcePath);
+    const stat = await fs11.stat(sourcePath);
     if (stat.isDirectory()) {
       files = await collectMarkdownFiles(sourcePath);
     } else if (stat.isFile()) {
@@ -8590,7 +9203,7 @@ async function runMigrateDocs(source, options) {
 }
 async function migrateDocument(filePath, outputDir, dryRun) {
   try {
-    const content = await fs12.readFile(filePath, "utf-8");
+    const content = await fs11.readFile(filePath, "utf-8");
     const analysis = analyzeDocument(content);
     const featureId = generateFeatureId(analysis.title || path18.basename(filePath, ".md"));
     const specContent = generateSpec({
@@ -8658,7 +9271,7 @@ async function runAnalyze(file) {
     error(`\uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${file}`);
     process.exit(ExitCode.FILE_SYSTEM_ERROR);
   }
-  const content = await fs12.readFile(filePath, "utf-8");
+  const content = await fs11.readFile(filePath, "utf-8");
   const analysis = analyzeDocument(content);
   info(`\u{1F4CA} \uBB38\uC11C \uBD84\uC11D: ${path18.basename(file)}`);
   newline();
@@ -8719,7 +9332,7 @@ async function runScan(dir, options) {
   const results = [];
   for (const file of files) {
     try {
-      const content = await fs12.readFile(file, "utf-8");
+      const content = await fs11.readFile(file, "utf-8");
       const analysis = analyzeDocument(content);
       results.push({ file, analysis });
     } catch {
@@ -8781,7 +9394,7 @@ async function collectMarkdownFiles(dirPath) {
 async function collectFilesWithExtensions(dirPath, extensions) {
   const files = [];
   async function scan(dir) {
-    const entries = await fs12.readdir(dir, { withFileTypes: true });
+    const entries = await fs11.readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
       const fullPath = path18.join(dir, entry.name);
       if (entry.isDirectory()) {
@@ -9294,8 +9907,129 @@ async function runCiCheck(options) {
 
 // src/cli/commands/transition.ts
 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) => {
@@ -9325,32 +10059,16 @@ async function runNewToChange(specId, options) {
     process.exit(ExitCode.GENERAL_ERROR);
   }
   const sddPath = path20.join(projectRoot, ".sdd");
-  const specsPath = path20.join(sddPath, "specs");
-  const specPath = path20.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);
-  }
   info("=== \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC804\uD658: new \u2192 change ===");
   newline();
   info(`\uB300\uC0C1 \uC2A4\uD399: ${specId}`);
-  const changeId = generateChangeId();
-  const changePath = path20.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(path20.join(changePath, "proposal.md"), proposalContent);
-  const deltaContent = generateDeltaTemplate(specId);
-  await writeFile(path20.join(changePath, "delta.md"), deltaContent);
-  const tasksContent = generateTasksTemplate();
-  await writeFile(path20.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();
@@ -9368,60 +10086,31 @@ async function runNewToChange(specId, options) {
 }
 async function runChangeToNew(changeId, 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 = path20.join(projectRoot, ".sdd");
-  const changePath = path20.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.");
+  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 = path20.join(projectRoot, ".sdd");
   info("=== \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC804\uD658: change \u2192 new ===");
   newline();
   info(`\uC6D0\uBCF8 \uBCC0\uACBD: ${changeId}`);
-  const proposalPath = path20.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 = path20.join(sddPath, "specs");
-  const newSpecPath = path20.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(path20.join(newSpecPath, "spec.md"), specContent);
-  const planContent = generatePlanTemplate(featureName);
-  await writeFile(path20.join(newSpecPath, "plan.md"), planContent);
-  const tasksContent = generateTasksTemplate();
-  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));
+  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`);
@@ -9433,43 +10122,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];
@@ -9511,7 +10164,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}
 ---
@@ -9622,7 +10275,7 @@ status: draft
 <!-- \uAD6C\uD604 \uC2DC \uACE0\uB824\uD560 \uC704\uD5D8 \uC694\uC18C -->
 `;
 }
-function generateTasksTemplate() {
+function generateTasksTemplate2() {
   return `---
 status: pending
 ---
@@ -9965,8 +10618,8 @@ function scoreDependencies(spec) {
   const details = [];
   const suggestions = [];
   let score = 0;
-  if (spec.frontmatter.depends) {
-    const deps = Array.isArray(spec.frontmatter.depends) ? spec.frontmatter.depends : [spec.frontmatter.depends];
+  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(", ")}`);
@@ -9975,8 +10628,8 @@ function scoreDependencies(spec) {
       details.push("\uC758\uC874\uC131 \uC5C6\uC74C (\uBA85\uC2DC\uC801 \uC120\uC5B8)");
     }
   } else {
-    details.push("\uC758\uC874\uC131 \uD544\uB4DC\uAC00 \uC5C6\uC74C");
-    suggestions.push("frontmatter\uC5D0 depends \uD544\uB4DC\uB97C \uCD94\uAC00\uD558\uC138\uC694");
+    score = 5;
+    details.push("\uC758\uC874\uC131 \uD544\uB4DC \uC5C6\uC74C (\uC554\uC2DC\uC801 \uC5C6\uC74C)");
   }
   return {
     name: "\uC758\uC874\uC131 \uBA85\uC2DC",
@@ -10041,9 +10694,9 @@ function scoreConstitution(spec, hasConstitution) {
   if (!hasConstitution) {
     score = maxScore;
     details.push("Constitution \uBBF8\uC124\uC815 (\uAC80\uC0AC \uC0DD\uB7B5)");
-  } else if (spec.frontmatter.constitution_version) {
+  } else if (spec.metadata.constitution_version) {
     score = maxScore;
-    details.push(`Constitution \uBC84\uC804: ${spec.frontmatter.constitution_version}`);
+    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");
@@ -10089,20 +10742,20 @@ function scoreMetadata(spec) {
   let score = 0;
   const missingRequired = [];
   for (const field of requiredFields) {
-    if (spec.frontmatter[field]) {
+    if (spec.metadata[field]) {
       score += 2;
     } else {
       missingRequired.push(field);
     }
   }
   for (const field of optionalFields) {
-    if (spec.frontmatter[field]) {
+    if (spec.metadata[field]) {
       score += 1;
     }
   }
   score = Math.min(maxScore, score);
-  const presentFields = Object.keys(spec.frontmatter).filter(
-    (k) => spec.frontmatter[k] !== null && spec.frontmatter[k] !== void 0
+  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) {
@@ -10149,7 +10802,7 @@ async function analyzeSpecQuality(specPath, sddPath) {
     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.frontmatter.id || path23.basename(path23.dirname(specPath));
+    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,
@@ -10279,6 +10932,36 @@ function formatProjectQualityResult(result) {
 // 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 {
@@ -10295,41 +10978,17 @@ async function runQuality(feature, 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 = path24.join(projectRoot, ".sdd");
-  const minScore = parseInt(options.minScore || "0", 10);
-  if (options.all || !feature) {
-    const result2 = await analyzeProjectQuality(sddPath);
-    if (!result2.success) {
-      error(result2.error.message);
-      process.exit(ExitCode.GENERAL_ERROR);
-    }
-    if (options.json) {
-      console.log(JSON.stringify(result2.data, null, 2));
-    } else {
-      console.log(formatProjectQualityResult(result2.data));
-    }
-    if (result2.data.averagePercentage < minScore) {
-      newline();
-      error(`\uD488\uC9C8 \uC810\uC218\uAC00 \uCD5C\uC18C \uAE30\uC900(${minScore}%) \uBBF8\uB2EC\uC785\uB2C8\uB2E4.`);
-      process.exit(ExitCode.VALIDATION_ERROR);
-    }
-    return;
-  }
-  const specPath = path24.join(sddPath, "specs", feature, "spec.md");
-  const result = await analyzeSpecQuality(specPath, sddPath);
+  const result = await executeQuality(feature, options, projectRoot);
   if (!result.success) {
     error(result.error.message);
     process.exit(ExitCode.GENERAL_ERROR);
   }
-  if (options.json) {
-    console.log(JSON.stringify(result.data, null, 2));
-  } else {
-    console.log(formatQualityResult(result.data));
-  }
-  if (result.data.percentage < minScore) {
+  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_ERROR);
+    process.exit(ExitCode.VALIDATION_FAILED);
   }
 }
 
@@ -10498,7 +11157,7 @@ function renderHtmlReport(data) {
       <td>${spec.description || "-"}</td>
     </tr>
   `).join("");
-  const qualityRows = data.quality?.results.map((q) => `
+  const qualityRows = data.quality?.specResults?.map((q) => `
     <tr>
       <td>${q.specId}</td>
       <td>${q.percentage}%</td>
@@ -10506,7 +11165,7 @@ function renderHtmlReport(data) {
       <td>${q.totalScore}/${q.maxScore}</td>
     </tr>
   `).join("") || "";
-  const validationRows = data.validation?.results.map((v) => `
+  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>
@@ -10676,11 +11335,11 @@ function renderMarkdownReport(data) {
   if (data.quality) {
     lines.push("## \uD488\uC9C8 \uBD84\uC11D");
     lines.push("");
-    lines.push(`\uD3C9\uADE0 \uC810\uC218: **${data.quality.averagePercentage.toFixed(1)}%** (${data.quality.averageGrade})`);
+    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.results) {
+    for (const q of data.quality.specResults || []) {
       lines.push(`| ${q.specId} | ${q.percentage}% | ${q.grade} |`);
     }
     lines.push("");
@@ -10688,14 +11347,14 @@ function renderMarkdownReport(data) {
   if (data.validation) {
     lines.push("## \uAC80\uC99D \uACB0\uACFC");
     lines.push("");
-    lines.push(`- \uAC80\uC99D\uB41C \uC2A4\uD399: ${data.validation.validCount}\uAC1C`);
-    lines.push(`- \uC5D0\uB7EC: ${data.validation.errorCount}\uAC1C`);
-    lines.push(`- \uACBD\uACE0: ${data.validation.warningCount}\uAC1C`);
+    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.errorCount > 0 || data.validation.warningCount > 0) {
+    if (data.validation.failed > 0 || data.validation.warnings > 0) {
       lines.push("### \uC0C1\uC138 \uACB0\uACFC");
       lines.push("");
-      for (const v of data.validation.results) {
+      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) {
@@ -10717,6 +11376,41 @@ function renderMarkdownReport(data) {
 // 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 {
@@ -10733,33 +11427,13 @@ async function runReport(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 = path26.join(projectRoot, ".sdd");
   const format = options.format || "html";
-  if (!["html", "markdown", "json"].includes(format)) {
-    error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD615\uC2DD\uC785\uB2C8\uB2E4: ${format}`);
-    info("\uC9C0\uC6D0 \uD615\uC2DD: html, markdown, json");
-    process.exit(ExitCode.VALIDATION_ERROR);
-  }
-  let outputPath = options.output;
-  if (!outputPath) {
-    const ext = format === "markdown" ? "md" : format;
-    const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    outputPath = path26.join(projectRoot, `sdd-report-${timestamp}.${ext}`);
-  } else if (!path26.isAbsolute(outputPath)) {
-    outputPath = path26.join(projectRoot, outputPath);
-  }
   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 generateReport(sddPath, {
-    format,
-    outputPath,
-    title: options.title,
-    includeQuality: options.quality !== false,
-    includeValidation: options.validation !== false
-  });
+  const result = await executeReport(options, projectRoot);
   if (!result.success) {
     error(result.error.message);
     process.exit(ExitCode.GENERAL_ERROR);
@@ -10772,6 +11446,395 @@ async function runReport(options) {
   }
 }
 
+// src/cli/commands/search.ts
+import path28 from "path";
+init_fs();
+
+// src/core/search/searcher.ts
+init_types();
+init_errors();
+init_fs();
+import path27 from "path";
+import { promises as fs15 } from "fs";
+async function searchSpecs(sddPath, options = {}) {
+  const startTime = Date.now();
+  try {
+    const specsPath = path27.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 indexResult = await buildSearchIndex(specsPath);
+    if (!indexResult.success) {
+      return failure(indexResult.error);
+    }
+    const index = indexResult.data;
+    let results = filterByOptions(index, options);
+    if (options.query) {
+      results = searchByQuery(results, options.query, options);
+    } else {
+      results = results.map((item) => ({ ...item, score: 100, matches: [] }));
+    }
+    results = sortResults(results, options);
+    if (options.limit && options.limit > 0) {
+      results = results.slice(0, options.limit);
+    }
+    const duration = Date.now() - startTime;
+    return success({
+      query: options.query || "*",
+      options,
+      totalCount: results.length,
+      items: results,
+      duration
+    });
+  } catch (error2) {
+    return failure(
+      new ChangeError(
+        `\uAC80\uC0C9 \uC2E4\uD328: ${error2 instanceof Error ? error2.message : String(error2)}`
+      )
+    );
+  }
+}
+async function buildSearchIndex(specsPath) {
+  try {
+    const index = [];
+    await collectSpecs(specsPath, specsPath, index);
+    return success(index);
+  } catch (error2) {
+    return failure(
+      new ChangeError(
+        `\uC778\uB371\uC2A4 \uAD6C\uCD95 \uC2E4\uD328: ${error2 instanceof Error ? error2.message : String(error2)}`
+      )
+    );
+  }
+}
+async function collectSpecs(basePath, currentPath, index) {
+  const entries = await fs15.readdir(currentPath, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path27.join(currentPath, entry.name);
+    if (entry.isDirectory()) {
+      await collectSpecs(basePath, fullPath, index);
+    } else if (entry.name === "spec.md") {
+      const content = await fs15.readFile(fullPath, "utf-8");
+      const relativePath = path27.relative(basePath, fullPath);
+      const specId = path27.dirname(relativePath);
+      const metadata = parseMetadata(content);
+      const stat = await fs15.stat(fullPath);
+      index.push({
+        id: specId === "." ? entry.name : specId,
+        path: relativePath,
+        title: metadata.title || specId,
+        content,
+        status: metadata.status || "unknown",
+        phase: metadata.phase || "unknown",
+        author: metadata.author || "",
+        created: metadata.created || "",
+        updated: metadata.updated || stat.mtime.toISOString().split("T")[0],
+        depends: parseDependencies(metadata.depends),
+        tags: parseTags(metadata.tags)
+      });
+    }
+  }
+}
+function parseMetadata(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return {};
+  const metadata = {};
+  const lines = match[1].split("\n");
+  for (const line of lines) {
+    const kvMatch = line.match(/^(\w+):\s*(.*)$/);
+    if (kvMatch) {
+      let value = kvMatch[2].trim();
+      if (value.startsWith('"') && value.endsWith('"')) {
+        value = value.slice(1, -1);
+      }
+      if (value === "null" || value === "~") {
+        value = null;
+      }
+      metadata[kvMatch[1]] = value;
+    }
+  }
+  return metadata;
+}
+function parseDependencies(depends) {
+  if (!depends) return [];
+  if (Array.isArray(depends)) return depends.filter(Boolean);
+  if (typeof depends === "string" && depends !== "null") {
+    return depends.split(",").map((d) => d.trim()).filter(Boolean);
+  }
+  return [];
+}
+function parseTags(tags) {
+  if (!tags) return [];
+  if (Array.isArray(tags)) return tags.filter(Boolean);
+  if (typeof tags === "string") {
+    return tags.split(",").map((t) => t.trim()).filter(Boolean);
+  }
+  return [];
+}
+function filterByOptions(index, options) {
+  return index.filter((item) => {
+    if (options.status) {
+      const statuses = Array.isArray(options.status) ? options.status : [options.status];
+      if (!statuses.includes(item.status)) return false;
+    }
+    if (options.phase) {
+      const phases = Array.isArray(options.phase) ? options.phase : [options.phase];
+      if (!phases.includes(item.phase)) return false;
+    }
+    if (options.author) {
+      if (!item.author.toLowerCase().includes(options.author.toLowerCase())) {
+        return false;
+      }
+    }
+    if (options.createdAfter && item.created) {
+      if (item.created < options.createdAfter) return false;
+    }
+    if (options.createdBefore && item.created) {
+      if (item.created > options.createdBefore) return false;
+    }
+    if (options.updatedAfter && item.updated) {
+      if (item.updated < options.updatedAfter) return false;
+    }
+    if (options.updatedBefore && item.updated) {
+      if (item.updated > options.updatedBefore) return false;
+    }
+    if (options.dependsOn) {
+      if (!item.depends.includes(options.dependsOn)) return false;
+    }
+    if (options.tags && options.tags.length > 0) {
+      const hasTag = options.tags.some(
+        (tag) => item.tags.some((t) => t.toLowerCase() === tag.toLowerCase())
+      );
+      if (!hasTag) return false;
+    }
+    return true;
+  });
+}
+function searchByQuery(items, query, options) {
+  const results = [];
+  let pattern;
+  try {
+    if (options.regex) {
+      pattern = new RegExp(query, options.caseSensitive ? "g" : "gi");
+    } else {
+      const escaped = query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      pattern = new RegExp(escaped, options.caseSensitive ? "g" : "gi");
+    }
+  } catch {
+    const escaped = query.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    pattern = new RegExp(escaped, "gi");
+  }
+  for (const item of items) {
+    const matches = [];
+    let score = 0;
+    if (pattern.test(item.title)) {
+      score += 50;
+      pattern.lastIndex = 0;
+    }
+    if (pattern.test(item.id)) {
+      score += 30;
+      pattern.lastIndex = 0;
+    }
+    const lines = item.content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      pattern.lastIndex = 0;
+      if (pattern.test(line)) {
+        score += 10;
+        const highlighted = line.replace(
+          pattern,
+          (match) => `**${match}**`
+        );
+        matches.push({
+          line: i + 1,
+          content: highlighted.trim(),
+          original: line.trim()
+        });
+      }
+    }
+    if (score > 0) {
+      results.push({
+        id: item.id,
+        path: item.path,
+        title: item.title,
+        status: item.status,
+        phase: item.phase,
+        author: item.author || void 0,
+        created: item.created || void 0,
+        updated: item.updated || void 0,
+        depends: item.depends.length > 0 ? item.depends : void 0,
+        tags: item.tags.length > 0 ? item.tags : void 0,
+        score: Math.min(100, score),
+        matches: matches.slice(0, 5)
+        // 최대 5개 매칭 컨텍스트
+      });
+    }
+  }
+  return results;
+}
+function sortResults(results, options) {
+  const sortBy = options.sortBy || "relevance";
+  const sortOrder = options.sortOrder || "desc";
+  return [...results].sort((a, b) => {
+    let comparison = 0;
+    switch (sortBy) {
+      case "relevance":
+        comparison = a.score - b.score;
+        break;
+      case "created":
+        comparison = (a.created || "").localeCompare(b.created || "");
+        break;
+      case "updated":
+        comparison = (a.updated || "").localeCompare(b.updated || "");
+        break;
+      case "title":
+        comparison = (a.title || "").localeCompare(b.title || "");
+        break;
+      case "status":
+        comparison = (a.status || "").localeCompare(b.status || "");
+        break;
+      default:
+        comparison = a.score - b.score;
+    }
+    return sortOrder === "asc" ? comparison : -comparison;
+  });
+}
+function formatSearchResult(result) {
+  const lines = [];
+  lines.push(`\u{1F50D} \uAC80\uC0C9 \uACB0\uACFC: "${result.query}"`);
+  lines.push(`   ${result.totalCount}\uAC1C \uBC1C\uACAC (${result.duration}ms)`);
+  lines.push("");
+  if (result.items.length === 0) {
+    lines.push("   \uAC80\uC0C9 \uACB0\uACFC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    return lines.join("\n");
+  }
+  for (const item of result.items) {
+    const statusIcon = getStatusIcon2(item.status);
+    const scoreBar = getScoreBar(item.score);
+    lines.push(`${statusIcon} ${item.id}`);
+    if (item.title && item.title !== item.id) {
+      lines.push(`   \uC81C\uBAA9: ${item.title}`);
+    }
+    lines.push(`   \uC0C1\uD0DC: ${item.status || "unknown"} | Phase: ${item.phase || "unknown"} | \uC810\uC218: ${scoreBar}`);
+    if (item.matches && item.matches.length > 0) {
+      lines.push("   \uB9E4\uCE6D:");
+      for (const match of item.matches.slice(0, 3)) {
+        const truncated = match.content.length > 60 ? match.content.slice(0, 60) + "..." : match.content;
+        lines.push(`     L${match.line}: ${truncated}`);
+      }
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function getStatusIcon2(status) {
+  switch (status) {
+    case "draft":
+      return "\u{1F4DD}";
+    case "review":
+      return "\u{1F440}";
+    case "approved":
+      return "\u2705";
+    case "implemented":
+      return "\u{1F680}";
+    case "deprecated":
+      return "\u26A0\uFE0F";
+    default:
+      return "\u{1F4C4}";
+  }
+}
+function getScoreBar(score) {
+  const filled = Math.round(score / 10);
+  const empty = 10 - filled;
+  return "\u2588".repeat(filled) + "\u2591".repeat(empty) + ` ${score}%`;
+}
+function formatSearchResultJson(result) {
+  return JSON.stringify(result, null, 2);
+}
+
+// src/cli/commands/search.ts
+function parseSearchCliOptions(query, options) {
+  const searchOptions = {};
+  if (query) {
+    searchOptions.query = query;
+  }
+  if (options.status) {
+    searchOptions.status = options.status.includes(",") ? options.status.split(",").map((s) => s.trim()) : options.status;
+  }
+  if (options.phase) {
+    searchOptions.phase = options.phase.includes(",") ? options.phase.split(",").map((p) => p.trim()) : options.phase;
+  }
+  if (options.author) {
+    searchOptions.author = options.author;
+  }
+  if (options.tags) {
+    searchOptions.tags = options.tags.split(",").map((t) => t.trim());
+  }
+  if (options.createdAfter) {
+    searchOptions.createdAfter = options.createdAfter;
+  }
+  if (options.createdBefore) {
+    searchOptions.createdBefore = options.createdBefore;
+  }
+  if (options.updatedAfter) {
+    searchOptions.updatedAfter = options.updatedAfter;
+  }
+  if (options.updatedBefore) {
+    searchOptions.updatedBefore = options.updatedBefore;
+  }
+  if (options.dependsOn) {
+    searchOptions.dependsOn = options.dependsOn;
+  }
+  if (options.limit) {
+    const limit = parseInt(options.limit, 10);
+    if (!isNaN(limit) && limit > 0) {
+      searchOptions.limit = limit;
+    }
+  }
+  if (options.sortBy) {
+    const validSortBy = ["relevance", "created", "updated", "title", "status"];
+    if (validSortBy.includes(options.sortBy)) {
+      searchOptions.sortBy = options.sortBy;
+    }
+  }
+  if (options.sortOrder) {
+    if (options.sortOrder === "asc" || options.sortOrder === "desc") {
+      searchOptions.sortOrder = options.sortOrder;
+    }
+  }
+  if (options.regex) {
+    searchOptions.regex = true;
+  }
+  if (options.caseSensitive) {
+    searchOptions.caseSensitive = true;
+  }
+  return searchOptions;
+}
+function registerSearchCommand(program2) {
+  program2.command("search [query]").description("\uC2A4\uD399 \uAC80\uC0C9").option("--status <status>", "\uC0C1\uD0DC \uD544\uD130 (\uCF64\uB9C8\uB85C \uAD6C\uBD84)").option("--phase <phase>", "Phase \uD544\uD130 (\uCF64\uB9C8\uB85C \uAD6C\uBD84)").option("--author <author>", "\uC791\uC131\uC790 \uD544\uD130").option("--tags <tags>", "\uD0DC\uADF8 \uD544\uD130 (\uCF64\uB9C8\uB85C \uAD6C\uBD84)").option("--created-after <date>", "\uC0DD\uC131\uC77C \uC774\uD6C4 (YYYY-MM-DD)").option("--created-before <date>", "\uC0DD\uC131\uC77C \uC774\uC804 (YYYY-MM-DD)").option("--updated-after <date>", "\uC218\uC815\uC77C \uC774\uD6C4 (YYYY-MM-DD)").option("--updated-before <date>", "\uC218\uC815\uC77C \uC774\uC804 (YYYY-MM-DD)").option("--depends-on <specId>", "\uC758\uC874\uC131 \uD544\uD130").option("--limit <n>", "\uACB0\uACFC \uC81C\uD55C \uC218").option("--sort-by <field>", "\uC815\uB82C \uAE30\uC900 (relevance, created, updated, title, status)").option("--sort-order <order>", "\uC815\uB82C \uBC29\uD5A5 (asc, desc)").option("-r, --regex", "\uC815\uADDC\uC2DD \uAC80\uC0C9").option("-c, --case-sensitive", "\uB300\uC18C\uBB38\uC790 \uAD6C\uBD84").option("--json", "JSON \uD615\uC2DD\uC73C\uB85C \uCD9C\uB825").action(async (query, options) => {
+    await executeSearch(query, options);
+  });
+}
+async function executeSearch(query, options) {
+  const sddPath = path28.join(process.cwd(), ".sdd");
+  if (!await fileExists(sddPath)) {
+    logger_exports.error(".sdd \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. sdd init\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
+    return;
+  }
+  const searchOptions = parseSearchCliOptions(query, options);
+  const result = await searchSpecs(sddPath, searchOptions);
+  if (!result.success) {
+    logger_exports.error(`\uAC80\uC0C9 \uC2E4\uD328: ${result.error.message}`);
+    return;
+  }
+  if (options.json) {
+    console.log(formatSearchResultJson(result.data));
+  } else {
+    console.log("");
+    console.log(formatSearchResult(result.data));
+  }
+}
+
 // src/cli/index.ts
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../../package.json");
@@ -10793,6 +11856,7 @@ registerTransitionCommand(program);
 registerWatchCommand(program);
 registerQualityCommand(program);
 registerReportCommand(program);
+registerSearchCommand(program);
 function run() {
   program.parse();
 }