sdd-tool 0.6.2 → 0.7.2

package/dist/cli/index.js

@@ -128,10 +128,10 @@ var init_base = __esm({
     };
     FileSystemError = class extends SddError {
       path;
-      constructor(code, path29) {
-        super(code, formatMessage(code, path29), ExitCode.FILE_SYSTEM_ERROR);
+      constructor(code, path36) {
+        super(code, formatMessage(code, path36), ExitCode.FILE_SYSTEM_ERROR);
         this.name = "FileSystemError";
-        this.path = path29;
+        this.path = path36;
       }
     };
     ValidationError = class extends SddError {
@@ -2132,70 +2132,92 @@ erDiagram
     },
     {
       name: "sdd.prepare",
-      content: `\uAE30\uB2A5 \uAD6C\uD604\uC5D0 \uD544\uC694\uD55C \uD658\uACBD\uC744 \uC900\uBE44\uD569\uB2C8\uB2E4.
+      content: `\uAE30\uB2A5 \uAD6C\uD604 \uC804 \uD544\uC694\uD55C \uC11C\uBE0C\uC5D0\uC774\uC804\uD2B8\uC640 \uC2A4\uD0AC\uC744 \uC810\uAC80\uD569\uB2C8\uB2E4.
 
 ## \uAC1C\uC694
 
-\uC0C8\uB85C\uC6B4 \uAE30\uB2A5\uC744 \uAD6C\uD604\uD558\uAE30 \uC804\uC5D0 \uD544\uC694\uD55C \uB3C4\uAD6C, \uC758\uC874\uC131, \uC124\uC815\uC744 \uBD84\uC11D\uD558\uACE0 \uC900\uBE44\uD569\uB2C8\uB2E4.
+\uC2A4\uD399/\uACC4\uD68D/\uC791\uC5C5 \uBB38\uC11C\uB97C \uBD84\uC11D\uD558\uC5EC \uAD6C\uD604\uC5D0 \uD544\uC694\uD55C Claude Code \uC11C\uBE0C\uC5D0\uC774\uC804\uD2B8\uC640 \uC2A4\uD0AC\uC744 \uAC10\uC9C0\uD558\uACE0,
+\uB204\uB77D\uB41C \uB3C4\uAD6C\uAC00 \uC788\uC73C\uBA74 \uC790\uB3D9\uC73C\uB85C \uC0DD\uC131\uD569\uB2C8\uB2E4.
 
 ## \uC9C0\uC2DC\uC0AC\uD56D
 
-1. \uC2A4\uD399\uC744 \uBD84\uC11D\uD558\uC5EC \uD544\uC694\uD55C \uAE30\uC220\uC744 \uD30C\uC545\uD558\uC138\uC694
-2. \uD544\uC694\uD55C \uC758\uC874\uC131\uC744 \uB098\uC5F4\uD558\uC138\uC694
-3. \uD544\uC694\uD55C MCP \uC11C\uBC84\uAC00 \uC788\uB2E4\uBA74 \uD655\uC778\uD558\uC138\uC694
-4. AGENTS.md\uC5D0 \uD544\uC694\uD55C \uC9C0\uCE68\uC744 \uCD94\uAC00\uD558\uC138\uC694
+1. \`sdd prepare <feature-id>\` \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD558\uC138\uC694
+2. \uAC10\uC9C0\uB41C \uB3C4\uAD6C \uBAA9\uB85D\uACFC \uC874\uC7AC \uC5EC\uBD80\uB97C \uD655\uC778\uD558\uC138\uC694
+3. \uB204\uB77D\uB41C \uB3C4\uAD6C \uC0DD\uC131 \uC5EC\uBD80\uB97C \uACB0\uC815\uD558\uC138\uC694
 
-## \uC900\uBE44 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8
+## \uC6CC\uD06C\uD50C\uB85C\uC6B0
 
-### 1. \uC758\uC874\uC131 \uD655\uC778
+\`\`\`
+/sdd.new \u2192 /sdd.plan \u2192 /sdd.tasks \u2192 sdd prepare \u2192 /sdd.implement
+\`\`\`
+
+## \uBA85\uB839\uC5B4
 
 \`\`\`bash
-# \uD544\uC694\uD55C npm \uD328\uD0A4\uC9C0 \uD655\uC778
-npm list [package-name]
+# \uAE30\uBCF8 \uC0AC\uC6A9 (\uB300\uD654\uD615)
+sdd prepare user-auth
+
+# \uBBF8\uB9AC\uBCF4\uAE30 (\uD30C\uC77C \uC0DD\uC131 \uC5C6\uC74C)
+sdd prepare user-auth --dry-run
+
+# \uC790\uB3D9 \uC2B9\uC778 (\uB204\uB77D \uB3C4\uAD6C \uC790\uB3D9 \uC0DD\uC131)
+sdd prepare user-auth --auto-approve
 
-# \uC124\uCE58 \uD544\uC694\uC2DC
-npm install [package-name]
+# JSON \uCD9C\uB825
+sdd prepare user-auth --json
 \`\`\`
 
-### 2. \uD658\uACBD \uC124\uC815
+## \uAC10\uC9C0 \uB300\uC0C1
 
-- [ ] \uD658\uACBD \uBCC0\uC218 \uD655\uC778 (.env)
-- [ ] API \uD0A4 \uC124\uC815
-- [ ] \uB370\uC774\uD130\uBCA0\uC774\uC2A4 \uC5F0\uACB0
+### \uC11C\uBE0C\uC5D0\uC774\uC804\uD2B8 (\`.claude/agents/*.md\`)
 
-### 3. MCP \uC11C\uBC84 (\uD544\uC694\uC2DC)
+| \uC5D0\uC774\uC804\uD2B8 | \uAC10\uC9C0 \uD0A4\uC6CC\uB4DC | \uC124\uBA85 |
+|----------|-------------|------|
+| test-runner | \uD14C\uC2A4\uD2B8, test, jest, vitest | \uD14C\uC2A4\uD2B8 \uC2E4\uD589 |
+| api-scaffold | api, rest, endpoint | API \uC2A4\uCE90\uD3F4\uB529 |
+| component-gen | component, \uCEF4\uD3EC\uB10C\uD2B8, react | \uCEF4\uD3EC\uB10C\uD2B8 \uC0DD\uC131 |
+| code-reviewer | review, \uB9AC\uBDF0 | \uCF54\uB4DC \uB9AC\uBDF0 |
 
-\uD544\uC694\uD55C MCP \uC11C\uBC84 \uBAA9\uB85D:
-- filesystem: \uD30C\uC77C \uC2DC\uC2A4\uD15C \uC811\uADFC
-- github: GitHub API \uC5F0\uB3D9
-- database: \uB370\uC774\uD130\uBCA0\uC774\uC2A4 \uC811\uADFC
+### \uC2A4\uD0AC (\`.claude/skills/<name>/SKILL.md\`)
 
-### 4. AGENTS.md \uC5C5\uB370\uC774\uD2B8
+| \uC2A4\uD0AC | \uAC10\uC9C0 \uD0A4\uC6CC\uB4DC | \uC124\uBA85 |
+|------|-------------|------|
+| test | \uD14C\uC2A4\uD2B8, test | \uD14C\uC2A4\uD2B8 \uC791\uC131 |
+| gen-api | api, rest | API \uC0DD\uC131 |
+| gen-component | component | \uCEF4\uD3EC\uB10C\uD2B8 \uC0DD\uC131 |
+| db-migrate | database, \uB9C8\uC774\uADF8\uB808\uC774\uC158 | DB \uB9C8\uC774\uADF8\uB808\uC774\uC158 |
+| gen-doc | \uBB38\uC11C, doc | \uBB38\uC11C \uC0DD\uC131 |
 
-\uAE30\uB2A5 \uAD6C\uD604\uC5D0 \uD544\uC694\uD55C \uC9C0\uCE68\uC744 AGENTS.md\uC5D0 \uCD94\uAC00:
+## \uCD9C\uB825 \uC608\uC2DC
 
-\`\`\`markdown
-## [\uAE30\uB2A5\uBA85] \uAD6C\uD604 \uC9C0\uCE68
+\`\`\`
+=== SDD Prepare: user-auth ===
 
-### \uC0AC\uC6A9 \uAE30\uC220
-- ...
+\uBD84\uC11D \uB300\uC0C1: 3\uAC1C \uBB38\uC11C, 5\uAC1C \uD0DC\uC2A4\uD06C
 
-### \uAD6C\uD604 \uADDC\uCE59
-- ...
+--- \uC11C\uBE0C\uC5D0\uC774\uC804\uD2B8 ---
+  [x] test-runner (\uC874\uC7AC)
+  [ ] api-scaffold (\uC5C6\uC74C) \u2192 \uC0DD\uC131 \uD544\uC694
 
-### \uCC38\uACE0 \uC790\uB8CC
-- ...
-\`\`\`
+--- \uC2A4\uD0AC ---
+  [x] test (\uC874\uC7AC)
+  [ ] gen-api (\uC5C6\uC74C) \u2192 \uC0DD\uC131 \uD544\uC694
 
-## \uBA85\uB839\uC5B4
+\uB204\uB77D\uB41C \uB3C4\uAD6C\uB97C \uC0DD\uC131\uD558\uC2DC\uACA0\uC2B5\uB2C8\uAE4C? (y/n)
+\`\`\`
 
-\`\`\`bash
-# \uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC \uD655\uC778
-sdd status
+## \uC0DD\uC131 \uD30C\uC77C \uAD6C\uC870
 
-# \uC2A4\uD399 \uAC80\uC99D
-sdd validate
 \`\`\`
+.claude/
+\u251C\u2500\u2500 agents/
+\u2502   \u2514\u2500\u2500 api-scaffold.md     # \uC5D0\uC774\uC804\uD2B8 \uC815\uC758
+\u2514\u2500\u2500 skills/
+    \u2514\u2500\u2500 gen-api/
+        \u2514\u2500\u2500 SKILL.md        # \uC2A4\uD0AC \uC815\uC758
+\`\`\`
+
+\uC644\uB8CC \uD6C4 \`/sdd.implement\`\uB85C \uAD6C\uD604\uC744 \uC2DC\uC791\uD558\uC138\uC694.
 `
     },
     {
@@ -3934,9 +3956,9 @@ async function validateSpecs(targetPath, options = {}) {
 async function findSpecFiles(dirPath) {
   const files = [];
   async function scanDir(dir) {
-    const { promises: fs16 } = await import("fs");
+    const { promises: fs22 } = await import("fs");
     try {
-      const entries = await fs16.readdir(dir, { withFileTypes: true });
+      const entries = await fs22.readdir(dir, { withFileTypes: true });
       for (const entry of entries) {
         const fullPath = path3.join(dir, entry.name);
         if (entry.isDirectory()) {
@@ -6059,19 +6081,19 @@ function detectCircularDependencies(graph) {
   const cycles = [];
   const visited = /* @__PURE__ */ new Set();
   const recStack = /* @__PURE__ */ new Set();
-  function dfs(nodeId, path29) {
+  function dfs(nodeId, path36) {
     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, [...path29, nodeId])) {
+        if (dfs(depId, [...path36, nodeId])) {
           return true;
         }
       } else if (recStack.has(depId)) {
-        const cycleStart = path29.indexOf(depId);
-        const cycle = cycleStart >= 0 ? [...path29.slice(cycleStart), nodeId, depId] : [nodeId, depId];
+        const cycleStart = path36.indexOf(depId);
+        const cycle = cycleStart >= 0 ? [...path36.slice(cycleStart), nodeId, depId] : [nodeId, depId];
         cycles.push({
           cycle,
           description: `\uC21C\uD658 \uC758\uC874\uC131: ${cycle.join(" \u2192 ")}`
@@ -11835,6 +11857,1179 @@ async function executeSearch(query, options) {
   }
 }
 
+// src/cli/commands/prepare.ts
+import path35 from "path";
+
+// src/core/prepare/schemas.ts
+import { z as z8 } from "zod";
+var ToolTypeSchema = z8.enum(["agent", "skill"]);
+var ToolStatusSchema = z8.enum(["exists", "missing", "outdated"]);
+var DetectionSourceSchema = z8.object({
+  file: z8.string(),
+  line: z8.number(),
+  text: z8.string(),
+  keyword: z8.string()
+});
+var DetectedToolSchema = z8.object({
+  type: ToolTypeSchema,
+  name: z8.string(),
+  description: z8.string(),
+  sources: z8.array(DetectionSourceSchema)
+});
+var AgentMetadataSchema = z8.object({
+  name: z8.string(),
+  description: z8.string(),
+  tools: z8.array(z8.string()).optional(),
+  model: z8.string().optional()
+});
+var ScannedAgentSchema = z8.object({
+  name: z8.string(),
+  filePath: z8.string(),
+  metadata: AgentMetadataSchema,
+  content: z8.string()
+});
+var SkillMetadataSchema = z8.object({
+  name: z8.string(),
+  description: z8.string(),
+  "allowed-tools": z8.array(z8.string()).optional()
+});
+var ScannedSkillSchema = z8.object({
+  name: z8.string(),
+  dirPath: z8.string(),
+  filePath: z8.string(),
+  metadata: SkillMetadataSchema,
+  content: z8.string()
+});
+var ToolCheckResultSchema = z8.object({
+  tool: DetectedToolSchema,
+  status: ToolStatusSchema,
+  filePath: z8.string().optional(),
+  action: z8.string()
+});
+var PrepareReportSchema = z8.object({
+  feature: z8.string(),
+  totalTasks: z8.number(),
+  agents: z8.object({
+    required: z8.number(),
+    existing: z8.number(),
+    missing: z8.number(),
+    checks: z8.array(ToolCheckResultSchema)
+  }),
+  skills: z8.object({
+    required: z8.number(),
+    existing: z8.number(),
+    missing: z8.number(),
+    checks: z8.array(ToolCheckResultSchema)
+  }),
+  proposals: z8.array(z8.object({
+    type: ToolTypeSchema,
+    name: z8.string(),
+    filePath: z8.string(),
+    content: z8.string()
+  })),
+  createdAt: z8.string()
+});
+var KeywordMappingSchema = z8.object({
+  keywords: z8.array(z8.string()),
+  agent: z8.string().nullable(),
+  skill: z8.string(),
+  agentDescription: z8.string().optional(),
+  skillDescription: z8.string().optional()
+});
+var DEFAULT_KEYWORD_MAPPINGS = [
+  {
+    keywords: ["test", "\uD14C\uC2A4\uD2B8", "vitest", "jest", "\uB2E8\uC704 \uD14C\uC2A4\uD2B8", "unit test"],
+    agent: "test-runner",
+    skill: "test",
+    agentDescription: "\uD14C\uC2A4\uD2B8 \uC2E4\uD589 \uBC0F \uACB0\uACFC \uBD84\uC11D \uC5D0\uC774\uC804\uD2B8",
+    skillDescription: "\uD14C\uC2A4\uD2B8 \uC791\uC131 \uBC0F \uC2E4\uD589 \uC2A4\uD0AC"
+  },
+  {
+    keywords: ["api", "rest", "endpoint", "\uC5D4\uB4DC\uD3EC\uC778\uD2B8", "graphql"],
+    agent: "api-scaffold",
+    skill: "gen-api",
+    agentDescription: "REST API \uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8 \uC0DD\uC131 \uC5D0\uC774\uC804\uD2B8",
+    skillDescription: "API \uC5D4\uB4DC\uD3EC\uC778\uD2B8 \uC0DD\uC131 \uC2A4\uD0AC"
+  },
+  {
+    keywords: ["component", "\uCEF4\uD3EC\uB10C\uD2B8", "react", "vue", "ui"],
+    agent: "component-gen",
+    skill: "gen-component",
+    agentDescription: "UI \uCEF4\uD3EC\uB10C\uD2B8 \uC0DD\uC131 \uC5D0\uC774\uC804\uD2B8",
+    skillDescription: "\uCEF4\uD3EC\uB10C\uD2B8 \uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8 \uC0DD\uC131 \uC2A4\uD0AC"
+  },
+  {
+    keywords: ["db", "database", "prisma", "migration", "\uB9C8\uC774\uADF8\uB808\uC774\uC158", "\uB370\uC774\uD130\uBCA0\uC774\uC2A4"],
+    agent: null,
+    skill: "db-migrate",
+    skillDescription: "\uB370\uC774\uD130\uBCA0\uC774\uC2A4 \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uC2A4\uD0AC"
+  },
+  {
+    keywords: ["doc", "\uBB38\uC11C", "readme", "jsdoc", "\uC8FC\uC11D", "documentation"],
+    agent: "doc-generator",
+    skill: "doc",
+    agentDescription: "\uBB38\uC11C \uC0DD\uC131 \uC5D0\uC774\uC804\uD2B8",
+    skillDescription: "\uBB38\uC11C\uD654 \uC2A4\uD0AC"
+  },
+  {
+    keywords: ["type", "\uD0C0\uC785", "schema", "zod", "typescript"],
+    agent: null,
+    skill: "gen-types",
+    skillDescription: "\uD0C0\uC785 \uC815\uC758 \uC0DD\uC131 \uC2A4\uD0AC"
+  },
+  {
+    keywords: ["lint", "eslint", "prettier", "\uD3EC\uB9F7", "format"],
+    agent: null,
+    skill: "lint",
+    skillDescription: "\uCF54\uB4DC \uB9B0\uD2B8 \uBC0F \uD3EC\uB9F7 \uC2A4\uD0AC"
+  },
+  {
+    keywords: ["review", "\uB9AC\uBDF0", "\uAC80\uC99D", "code review", "\uCF54\uB4DC \uB9AC\uBDF0"],
+    agent: "code-reviewer",
+    skill: "review",
+    agentDescription: "\uCF54\uB4DC \uB9AC\uBDF0 \uBC0F \uD488\uC9C8 \uAC80\uC99D \uC5D0\uC774\uC804\uD2B8",
+    skillDescription: "\uCF54\uB4DC \uB9AC\uBDF0 \uC2A4\uD0AC"
+  }
+];
+
+// src/core/prepare/document-analyzer.ts
+import * as fs16 from "fs";
+import * as path29 from "path";
+var DocumentAnalyzer = class {
+  sddDir;
+  constructor(projectRoot) {
+    this.sddDir = path29.join(projectRoot, ".sdd");
+  }
+  /**
+   * 기능 디렉토리의 모든 문서 분석
+   */
+  async analyzeFeature(featureName) {
+    const featureDir = path29.join(this.sddDir, "specs", featureName);
+    if (!fs16.existsSync(featureDir)) {
+      throw new Error(`\uAE30\uB2A5 \uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${featureDir}`);
+    }
+    const results = [];
+    const documents = [
+      { file: "tasks.md", type: "tasks" },
+      { file: "plan.md", type: "plan" },
+      { file: "spec.md", type: "spec" }
+    ];
+    for (const doc of documents) {
+      const filePath = path29.join(featureDir, doc.file);
+      if (fs16.existsSync(filePath)) {
+        const analysis = await this.analyzeDocument(filePath, doc.type);
+        results.push(analysis);
+      }
+    }
+    return results;
+  }
+  /**
+   * 단일 문서 분석
+   */
+  async analyzeDocument(filePath, type) {
+    const content = fs16.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    const analyzedLines = [];
+    let taskCount = 0;
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      const keywords = this.extractKeywords(line);
+      if (/^[\s]*-\s*\[[\sx]\]/.test(line)) {
+        taskCount++;
+      }
+      if (keywords.length > 0) {
+        analyzedLines.push({
+          lineNumber: i + 1,
+          content: line.trim(),
+          keywords
+        });
+      }
+    }
+    return {
+      file: filePath,
+      type,
+      lines: analyzedLines,
+      taskCount
+    };
+  }
+  /**
+   * 라인에서 키워드 추출
+   */
+  extractKeywords(line) {
+    const keywords = [];
+    const lowerLine = line.toLowerCase();
+    if (/test|테스트|vitest|jest|단위\s*테스트|unit\s*test/i.test(lowerLine)) {
+      keywords.push("test");
+    }
+    if (/\bapi\b|rest|endpoint|엔드포인트|graphql/i.test(lowerLine)) {
+      keywords.push("api");
+    }
+    if (/component|컴포넌트|\breact\b|\bvue\b|\bui\b/i.test(lowerLine)) {
+      keywords.push("component");
+    }
+    if (/\bdb\b|database|prisma|migration|마이그레이션|데이터베이스/i.test(lowerLine)) {
+      keywords.push("database");
+    }
+    if (/\bdoc\b|문서|readme|jsdoc|주석|documentation/i.test(lowerLine)) {
+      keywords.push("doc");
+    }
+    if (/\btype\b|타입|schema|스키마|\bzod\b|typescript/i.test(lowerLine)) {
+      keywords.push("type");
+    }
+    if (/lint|eslint|prettier|포맷|format/i.test(lowerLine)) {
+      keywords.push("lint");
+    }
+    if (/review|리뷰|검증|code\s*review|코드\s*리뷰/i.test(lowerLine)) {
+      keywords.push("review");
+    }
+    return [...new Set(keywords)];
+  }
+  /**
+   * 분석 결과에서 DetectionSource 배열 생성
+   */
+  static toDetectionSources(analyses) {
+    const sources = [];
+    for (const analysis of analyses) {
+      for (const line of analysis.lines) {
+        for (const keyword of line.keywords) {
+          sources.push({
+            file: path29.basename(analysis.file),
+            line: line.lineNumber,
+            text: line.content,
+            keyword
+          });
+        }
+      }
+    }
+    return sources;
+  }
+  /**
+   * 전체 태스크 수 계산
+   */
+  static getTotalTaskCount(analyses) {
+    return analyses.reduce((sum, a) => sum + a.taskCount, 0);
+  }
+};
+
+// src/core/prepare/tool-detector.ts
+var ToolDetector = class {
+  mappings;
+  constructor(customMappings) {
+    this.mappings = customMappings ?? DEFAULT_KEYWORD_MAPPINGS;
+  }
+  /**
+   * 문서 분석 결과에서 필요한 도구 감지
+   */
+  detect(analyses) {
+    const sources = DocumentAnalyzer.toDetectionSources(analyses);
+    return this.detectFromSources(sources);
+  }
+  /**
+   * DetectionSource 배열에서 도구 감지
+   */
+  detectFromSources(sources) {
+    const agentMap = /* @__PURE__ */ new Map();
+    const skillMap = /* @__PURE__ */ new Map();
+    for (const source of sources) {
+      const mapping = this.findMapping(source.keyword);
+      if (!mapping) continue;
+      if (mapping.agent) {
+        const existing2 = agentMap.get(mapping.agent);
+        if (existing2) {
+          existing2.sources.push(source);
+        } else {
+          agentMap.set(mapping.agent, {
+            type: "agent",
+            name: mapping.agent,
+            description: mapping.agentDescription ?? `${mapping.agent} \uC5D0\uC774\uC804\uD2B8`,
+            sources: [source]
+          });
+        }
+      }
+      const existing = skillMap.get(mapping.skill);
+      if (existing) {
+        existing.sources.push(source);
+      } else {
+        skillMap.set(mapping.skill, {
+          type: "skill",
+          name: mapping.skill,
+          description: mapping.skillDescription ?? `${mapping.skill} \uC2A4\uD0AC`,
+          sources: [source]
+        });
+      }
+    }
+    return {
+      agents: Array.from(agentMap.values()),
+      skills: Array.from(skillMap.values()),
+      totalSources: sources.length
+    };
+  }
+  /**
+   * 키워드에 해당하는 매핑 찾기
+   */
+  findMapping(keyword) {
+    const lowerKeyword = keyword.toLowerCase();
+    for (const mapping of this.mappings) {
+      for (const kw of mapping.keywords) {
+        if (lowerKeyword.includes(kw.toLowerCase()) || kw.toLowerCase().includes(lowerKeyword)) {
+          return mapping;
+        }
+      }
+    }
+    return void 0;
+  }
+  /**
+   * 감지된 도구 요약
+   */
+  static summarize(result) {
+    const lines = [];
+    lines.push(`## \uAC10\uC9C0\uB41C \uB3C4\uAD6C`);
+    lines.push("");
+    if (result.agents.length > 0) {
+      lines.push(`### \uC11C\uBE0C\uC5D0\uC774\uC804\uD2B8 (${result.agents.length}\uAC1C)`);
+      lines.push("");
+      lines.push("| \uC774\uB984 | \uC124\uBA85 | \uAC10\uC9C0 \uD69F\uC218 |");
+      lines.push("|------|------|-----------|");
+      for (const agent of result.agents) {
+        lines.push(`| ${agent.name} | ${agent.description} | ${agent.sources.length} |`);
+      }
+      lines.push("");
+    }
+    if (result.skills.length > 0) {
+      lines.push(`### \uC2A4\uD0AC (${result.skills.length}\uAC1C)`);
+      lines.push("");
+      lines.push("| \uC774\uB984 | \uC124\uBA85 | \uAC10\uC9C0 \uD69F\uC218 |");
+      lines.push("|------|------|-----------|");
+      for (const skill of result.skills) {
+        lines.push(`| ${skill.name} | ${skill.description} | ${skill.sources.length} |`);
+      }
+      lines.push("");
+    }
+    return lines.join("\n");
+  }
+};
+
+// src/core/prepare/agent-scanner.ts
+import * as fs17 from "fs";
+import * as path30 from "path";
+import matter6 from "gray-matter";
+var AgentScanner = class {
+  agentsDir;
+  constructor(projectRoot) {
+    this.agentsDir = path30.join(projectRoot, ".claude", "agents");
+  }
+  /**
+   * 에이전트 디렉토리 존재 여부
+   */
+  exists() {
+    return fs17.existsSync(this.agentsDir);
+  }
+  /**
+   * 모든 에이전트 스캔
+   */
+  async scanAll() {
+    if (!this.exists()) {
+      return [];
+    }
+    const agents = [];
+    const files = fs17.readdirSync(this.agentsDir);
+    for (const file of files) {
+      if (!file.endsWith(".md")) continue;
+      const filePath = path30.join(this.agentsDir, file);
+      const agent = await this.scanAgent(filePath);
+      if (agent) {
+        agents.push(agent);
+      }
+    }
+    return agents;
+  }
+  /**
+   * 단일 에이전트 파일 스캔
+   */
+  async scanAgent(filePath) {
+    try {
+      const content = fs17.readFileSync(filePath, "utf-8");
+      const { data, content: body } = matter6(content);
+      const metadata = this.parseMetadata(data, filePath);
+      if (!metadata) {
+        return null;
+      }
+      return {
+        name: metadata.name,
+        filePath,
+        metadata,
+        content: body.trim()
+      };
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * 특정 에이전트 존재 확인
+   */
+  hasAgent(name) {
+    const filePath = path30.join(this.agentsDir, `${name}.md`);
+    return fs17.existsSync(filePath);
+  }
+  /**
+   * 특정 에이전트 가져오기
+   */
+  async getAgent(name) {
+    const filePath = path30.join(this.agentsDir, `${name}.md`);
+    if (!fs17.existsSync(filePath)) {
+      return null;
+    }
+    return this.scanAgent(filePath);
+  }
+  /**
+   * 메타데이터 파싱
+   */
+  parseMetadata(data, filePath) {
+    try {
+      if (typeof data.tools === "string") {
+        data.tools = data.tools.split(",").map((t) => t.trim());
+      }
+      const result = AgentMetadataSchema.safeParse(data);
+      if (result.success) {
+        return result.data;
+      }
+      const fileName = path30.basename(filePath, ".md");
+      const withName = { ...data, name: data.name ?? fileName };
+      const retryResult = AgentMetadataSchema.safeParse(withName);
+      if (retryResult.success) {
+        return retryResult.data;
+      }
+      return null;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * 에이전트 디렉토리 경로
+   */
+  getAgentsDir() {
+    return this.agentsDir;
+  }
+  /**
+   * 에이전트 파일 경로 생성
+   */
+  getAgentFilePath(name) {
+    return path30.join(this.agentsDir, `${name}.md`);
+  }
+};
+
+// src/core/prepare/skill-scanner.ts
+import * as fs18 from "fs";
+import * as path31 from "path";
+import matter7 from "gray-matter";
+var SkillScanner = class {
+  skillsDir;
+  constructor(projectRoot) {
+    this.skillsDir = path31.join(projectRoot, ".claude", "skills");
+  }
+  /**
+   * 스킬 디렉토리 존재 여부
+   */
+  exists() {
+    return fs18.existsSync(this.skillsDir);
+  }
+  /**
+   * 모든 스킬 스캔
+   */
+  async scanAll() {
+    if (!this.exists()) {
+      return [];
+    }
+    const skills = [];
+    const entries = fs18.readdirSync(this.skillsDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const skillDir = path31.join(this.skillsDir, entry.name);
+      const skill = await this.scanSkill(skillDir);
+      if (skill) {
+        skills.push(skill);
+      }
+    }
+    return skills;
+  }
+  /**
+   * 단일 스킬 디렉토리 스캔
+   */
+  async scanSkill(skillDir) {
+    const skillFile = path31.join(skillDir, "SKILL.md");
+    if (!fs18.existsSync(skillFile)) {
+      return null;
+    }
+    try {
+      const content = fs18.readFileSync(skillFile, "utf-8");
+      const { data, content: body } = matter7(content);
+      const metadata = this.parseMetadata(data, skillDir);
+      if (!metadata) {
+        return null;
+      }
+      return {
+        name: metadata.name,
+        dirPath: skillDir,
+        filePath: skillFile,
+        metadata,
+        content: body.trim()
+      };
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * 특정 스킬 존재 확인
+   */
+  hasSkill(name) {
+    const skillDir = path31.join(this.skillsDir, name);
+    const skillFile = path31.join(skillDir, "SKILL.md");
+    return fs18.existsSync(skillFile);
+  }
+  /**
+   * 특정 스킬 가져오기
+   */
+  async getSkill(name) {
+    const skillDir = path31.join(this.skillsDir, name);
+    if (!fs18.existsSync(skillDir)) {
+      return null;
+    }
+    return this.scanSkill(skillDir);
+  }
+  /**
+   * 메타데이터 파싱
+   */
+  parseMetadata(data, skillDir) {
+    try {
+      if (typeof data["allowed-tools"] === "string") {
+        data["allowed-tools"] = data["allowed-tools"].split(",").map((t) => t.trim());
+      }
+      const result = SkillMetadataSchema.safeParse(data);
+      if (result.success) {
+        return result.data;
+      }
+      const dirName = path31.basename(skillDir);
+      const withName = { ...data, name: data.name ?? dirName };
+      const retryResult = SkillMetadataSchema.safeParse(withName);
+      if (retryResult.success) {
+        return retryResult.data;
+      }
+      return null;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * 스킬 디렉토리 경로
+   */
+  getSkillsDir() {
+    return this.skillsDir;
+  }
+  /**
+   * 스킬 디렉토리 경로 생성
+   */
+  getSkillDirPath(name) {
+    return path31.join(this.skillsDir, name);
+  }
+  /**
+   * 스킬 파일 경로 생성
+   */
+  getSkillFilePath(name) {
+    return path31.join(this.skillsDir, name, "SKILL.md");
+  }
+};
+
+// src/core/prepare/agent-generator.ts
+import * as fs19 from "fs";
+import * as path32 from "path";
+var AgentGenerator = class {
+  agentsDir;
+  constructor(projectRoot) {
+    this.agentsDir = path32.join(projectRoot, ".claude", "agents");
+  }
+  /**
+   * 감지된 도구에서 에이전트 초안 생성
+   */
+  generate(tool, options) {
+    const model = options?.model ?? "sonnet";
+    const tools = options?.tools ?? this.getDefaultTools(tool.name);
+    const content = this.generateContent(tool, model, tools);
+    const filePath = path32.join(this.agentsDir, `${tool.name}.md`);
+    return {
+      name: tool.name,
+      filePath,
+      content
+    };
+  }
+  /**
+   * 에이전트 파일 생성
+   */
+  async writeAgent(agent) {
+    if (!fs19.existsSync(this.agentsDir)) {
+      fs19.mkdirSync(this.agentsDir, { recursive: true });
+    }
+    fs19.writeFileSync(agent.filePath, agent.content, "utf-8");
+  }
+  /**
+   * 에이전트 콘텐츠 생성
+   */
+  generateContent(tool, model, tools) {
+    const lines = [];
+    lines.push("---");
+    lines.push(`name: ${tool.name}`);
+    lines.push(`description: ${tool.description}`);
+    lines.push(`tools: ${tools.join(", ")}`);
+    lines.push(`model: ${model}`);
+    lines.push("---");
+    lines.push("");
+    lines.push(`# ${this.formatTitle(tool.name)} Agent`);
+    lines.push("");
+    lines.push(tool.description);
+    lines.push("");
+    lines.push("## Instructions");
+    lines.push("");
+    lines.push(...this.getInstructions(tool.name));
+    lines.push("");
+    if (tool.sources.length > 0) {
+      lines.push("## Detection Sources");
+      lines.push("");
+      lines.push("> \uC774 \uC5D0\uC774\uC804\uD2B8\uB294 \uB2E4\uC74C \uBB38\uC11C\uC5D0\uC11C \uAC10\uC9C0\uB41C \uD0A4\uC6CC\uB4DC\uB97C \uAE30\uBC18\uC73C\uB85C \uC0DD\uC131\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
+      lines.push("");
+      for (const source of tool.sources.slice(0, 5)) {
+        lines.push(`- ${source.file}:${source.line} - "${source.text.substring(0, 50)}..."`);
+      }
+      lines.push("");
+    }
+    return lines.join("\n");
+  }
+  /**
+   * 에이전트별 기본 도구
+   */
+  getDefaultTools(name) {
+    const toolMap = {
+      "test-runner": ["Read", "Glob", "Grep", "Bash"],
+      "api-scaffold": ["Read", "Write", "Edit", "Glob", "Grep"],
+      "component-gen": ["Read", "Write", "Edit", "Glob"],
+      "doc-generator": ["Read", "Write", "Edit", "Glob", "Grep"],
+      "code-reviewer": ["Read", "Glob", "Grep", "Bash"]
+    };
+    return toolMap[name] ?? ["Read", "Write", "Edit", "Glob", "Grep", "Bash"];
+  }
+  /**
+   * 에이전트별 지침
+   */
+  getInstructions(name) {
+    const instructionMap = {
+      "test-runner": [
+        "1. \uD14C\uC2A4\uD2B8 \uD30C\uC77C \uD0D0\uC0C9 (`*.test.ts`, `*.spec.ts`)",
+        "2. \uD14C\uC2A4\uD2B8 \uC2E4\uD589 (`vitest run` \uB610\uB294 `jest`)",
+        "3. \uC2E4\uD328\uD55C \uD14C\uC2A4\uD2B8 \uBD84\uC11D",
+        "4. \uCEE4\uBC84\uB9AC\uC9C0 \uB9AC\uD3EC\uD2B8 \uC0DD\uC131"
+      ],
+      "api-scaffold": [
+        "1. API \uC0AC\uC591 \uBD84\uC11D",
+        "2. \uB77C\uC6B0\uD130/\uCEE8\uD2B8\uB864\uB7EC \uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8 \uC0DD\uC131",
+        "3. \uD0C0\uC785 \uC815\uC758 \uC0DD\uC131",
+        "4. \uAE30\uBCF8 \uD14C\uC2A4\uD2B8 \uCF00\uC774\uC2A4 \uC0DD\uC131"
+      ],
+      "component-gen": [
+        "1. \uCEF4\uD3EC\uB10C\uD2B8 \uC694\uAD6C\uC0AC\uD56D \uBD84\uC11D",
+        "2. \uCEF4\uD3EC\uB10C\uD2B8 \uD30C\uC77C \uC0DD\uC131",
+        "3. \uC2A4\uD0C0\uC77C \uD30C\uC77C \uC0DD\uC131",
+        "4. \uAE30\uBCF8 \uD14C\uC2A4\uD2B8 \uC0DD\uC131"
+      ],
+      "doc-generator": [
+        "1. \uCF54\uB4DC\uBCA0\uC774\uC2A4 \uBD84\uC11D",
+        "2. JSDoc/TSDoc \uC8FC\uC11D \uC0DD\uC131",
+        "3. README \uC5C5\uB370\uC774\uD2B8",
+        "4. API \uBB38\uC11C \uC0DD\uC131"
+      ],
+      "code-reviewer": [
+        "1. \uBCC0\uACBD\uB41C \uD30C\uC77C \uBD84\uC11D",
+        "2. \uCF54\uB4DC \uD488\uC9C8 \uAC80\uC0AC",
+        "3. \uBCF4\uC548 \uCDE8\uC57D\uC810 \uAC80\uC0AC",
+        "4. \uAC1C\uC120 \uC81C\uC548 \uC791\uC131"
+      ]
+    };
+    return instructionMap[name] ?? [
+      "1. \uC791\uC5C5 \uC694\uAD6C\uC0AC\uD56D \uBD84\uC11D",
+      "2. \uD544\uC694\uD55C \uD30C\uC77C \uD0D0\uC0C9",
+      "3. \uC791\uC5C5 \uC218\uD589",
+      "4. \uACB0\uACFC \uAC80\uC99D"
+    ];
+  }
+  /**
+   * 이름 포맷팅 (kebab-case → Title Case)
+   */
+  formatTitle(name) {
+    return name.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+  }
+};
+
+// src/core/prepare/skill-generator.ts
+import * as fs20 from "fs";
+import * as path33 from "path";
+var SkillGenerator = class {
+  skillsDir;
+  constructor(projectRoot) {
+    this.skillsDir = path33.join(projectRoot, ".claude", "skills");
+  }
+  /**
+   * 감지된 도구에서 스킬 초안 생성
+   */
+  generate(tool, options) {
+    const allowedTools = options?.allowedTools ?? this.getDefaultTools(tool.name);
+    const content = this.generateContent(tool, allowedTools);
+    const dirPath = path33.join(this.skillsDir, tool.name);
+    const filePath = path33.join(dirPath, "SKILL.md");
+    return {
+      name: tool.name,
+      dirPath,
+      filePath,
+      content
+    };
+  }
+  /**
+   * 스킬 파일 생성
+   */
+  async writeSkill(skill) {
+    if (!fs20.existsSync(skill.dirPath)) {
+      fs20.mkdirSync(skill.dirPath, { recursive: true });
+    }
+    fs20.writeFileSync(skill.filePath, skill.content, "utf-8");
+  }
+  /**
+   * 스킬 콘텐츠 생성
+   */
+  generateContent(tool, allowedTools) {
+    const lines = [];
+    lines.push("---");
+    lines.push(`name: ${tool.name}`);
+    lines.push(`description: ${tool.description}`);
+    lines.push(`allowed-tools: ${allowedTools.join(", ")}`);
+    lines.push("---");
+    lines.push("");
+    lines.push(`# ${this.formatTitle(tool.name)} Skill`);
+    lines.push("");
+    lines.push(tool.description);
+    lines.push("");
+    lines.push("## Instructions");
+    lines.push("");
+    lines.push(...this.getInstructions(tool.name));
+    lines.push("");
+    lines.push("## Examples");
+    lines.push("");
+    lines.push(...this.getExamples(tool.name));
+    lines.push("");
+    if (tool.sources.length > 0) {
+      lines.push("## Detection Sources");
+      lines.push("");
+      lines.push("> \uC774 \uC2A4\uD0AC\uC740 \uB2E4\uC74C \uBB38\uC11C\uC5D0\uC11C \uAC10\uC9C0\uB41C \uD0A4\uC6CC\uB4DC\uB97C \uAE30\uBC18\uC73C\uB85C \uC0DD\uC131\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
+      lines.push("");
+      for (const source of tool.sources.slice(0, 5)) {
+        lines.push(`- ${source.file}:${source.line} - "${source.text.substring(0, 50)}..."`);
+      }
+      lines.push("");
+    }
+    return lines.join("\n");
+  }
+  /**
+   * 스킬별 기본 도구
+   */
+  getDefaultTools(name) {
+    const toolMap = {
+      "test": ["Read", "Glob", "Grep", "Bash"],
+      "gen-api": ["Read", "Write", "Edit", "Glob"],
+      "gen-component": ["Read", "Write", "Edit", "Glob"],
+      "db-migrate": ["Read", "Write", "Bash"],
+      "doc": ["Read", "Write", "Edit", "Glob", "Grep"],
+      "gen-types": ["Read", "Write", "Edit", "Glob"],
+      "lint": ["Read", "Bash"],
+      "review": ["Read", "Glob", "Grep"]
+    };
+    return toolMap[name] ?? ["Read", "Write", "Edit", "Glob"];
+  }
+  /**
+   * 스킬별 지침
+   */
+  getInstructions(name) {
+    const instructionMap = {
+      "test": [
+        "1. \uB300\uC0C1 \uD30C\uC77C \uB610\uB294 \uBAA8\uB4C8 \uBD84\uC11D",
+        "2. \uD14C\uC2A4\uD2B8 \uCF00\uC774\uC2A4 \uC791\uC131",
+        "3. \uD14C\uC2A4\uD2B8 \uC2E4\uD589 \uBC0F \uACB0\uACFC \uD655\uC778",
+        "4. \uCEE4\uBC84\uB9AC\uC9C0 \uAC1C\uC120 \uC81C\uC548"
+      ],
+      "gen-api": [
+        "1. API \uC694\uAD6C\uC0AC\uD56D \uBD84\uC11D",
+        "2. \uC5D4\uB4DC\uD3EC\uC778\uD2B8 \uAD6C\uC870 \uC124\uACC4",
+        "3. \uB77C\uC6B0\uD130/\uCEE8\uD2B8\uB864\uB7EC \uCF54\uB4DC \uC0DD\uC131",
+        "4. \uD0C0\uC785 \uC815\uC758 \uC0DD\uC131"
+      ],
+      "gen-component": [
+        "1. \uCEF4\uD3EC\uB10C\uD2B8 \uC694\uAD6C\uC0AC\uD56D \uBD84\uC11D",
+        "2. \uCEF4\uD3EC\uB10C\uD2B8 \uAD6C\uC870 \uC124\uACC4",
+        "3. \uCEF4\uD3EC\uB10C\uD2B8 \uCF54\uB4DC \uC0DD\uC131",
+        "4. \uC2A4\uD0C0\uC77C \uBC0F \uD14C\uC2A4\uD2B8 \uC0DD\uC131"
+      ],
+      "db-migrate": [
+        "1. \uC2A4\uD0A4\uB9C8 \uBCC0\uACBD\uC0AC\uD56D \uBD84\uC11D",
+        "2. \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uD30C\uC77C \uC0DD\uC131",
+        "3. \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uC2E4\uD589",
+        "4. \uB864\uBC31 \uC2A4\uD06C\uB9BD\uD2B8 \uAC80\uC99D"
+      ],
+      "doc": [
+        "1. \uCF54\uB4DC\uBCA0\uC774\uC2A4 \uBD84\uC11D",
+        "2. \uBB38\uC11C\uD654 \uB300\uC0C1 \uC2DD\uBCC4",
+        "3. \uBB38\uC11C \uC0DD\uC131 (README, API \uBB38\uC11C \uB4F1)",
+        "4. \uAE30\uC874 \uBB38\uC11C \uC5C5\uB370\uC774\uD2B8"
+      ],
+      "gen-types": [
+        "1. \uB370\uC774\uD130 \uAD6C\uC870 \uBD84\uC11D",
+        "2. TypeScript \uD0C0\uC785/\uC778\uD130\uD398\uC774\uC2A4 \uC0DD\uC131",
+        "3. Zod \uC2A4\uD0A4\uB9C8 \uC0DD\uC131 (\uD544\uC694\uC2DC)",
+        "4. \uD0C0\uC785 \uB0B4\uBCF4\uB0B4\uAE30 \uC124\uC815"
+      ],
+      "lint": [
+        "1. \uB9B0\uD2B8 \uADDC\uCE59 \uD655\uC778",
+        "2. \uB9B0\uD2B8 \uC624\uB958 \uAC80\uC0AC",
+        "3. \uC790\uB3D9 \uC218\uC815 \uAC00\uB2A5\uD55C \uC624\uB958 \uC218\uC815",
+        "4. \uC218\uB3D9 \uC218\uC815 \uD544\uC694\uD55C \uD56D\uBAA9 \uB9AC\uD3EC\uD2B8"
+      ],
+      "review": [
+        "1. \uBCC0\uACBD\uB41C \uCF54\uB4DC \uBD84\uC11D",
+        "2. \uCF54\uB4DC \uD488\uC9C8 \uAC80\uC0AC",
+        "3. \uC7A0\uC7AC\uC801 \uBB38\uC81C\uC810 \uC2DD\uBCC4",
+        "4. \uAC1C\uC120 \uC81C\uC548 \uC791\uC131"
+      ]
+    };
+    return instructionMap[name] ?? [
+      "1. \uC694\uAD6C\uC0AC\uD56D \uBD84\uC11D",
+      "2. \uC791\uC5C5 \uC218\uD589",
+      "3. \uACB0\uACFC \uAC80\uC99D",
+      "4. \uB9AC\uD3EC\uD2B8 \uC791\uC131"
+    ];
+  }
+  /**
+   * 스킬별 사용 예시
+   */
+  getExamples(name) {
+    const exampleMap = {
+      "test": [
+        "**\uC0AC\uC6A9\uC790**: UserService\uC5D0 \uB300\uD55C \uD14C\uC2A4\uD2B8\uB97C \uC791\uC131\uD574\uC918",
+        "",
+        "**\uC751\uB2F5**: UserService\uC758 \uC8FC\uC694 \uBA54\uC11C\uB4DC\uC5D0 \uB300\uD55C \uD14C\uC2A4\uD2B8 \uCF00\uC774\uC2A4\uB97C \uC791\uC131\uD558\uACA0\uC2B5\uB2C8\uB2E4..."
+      ],
+      "gen-api": [
+        "**\uC0AC\uC6A9\uC790**: \uC0AC\uC6A9\uC790 CRUD API\uB97C \uC0DD\uC131\uD574\uC918",
+        "",
+        "**\uC751\uB2F5**: \uC0AC\uC6A9\uC790 \uAD00\uB9AC\uB97C \uC704\uD55C CRUD API \uC5D4\uB4DC\uD3EC\uC778\uD2B8\uB97C \uC0DD\uC131\uD558\uACA0\uC2B5\uB2C8\uB2E4..."
+      ],
+      "gen-component": [
+        "**\uC0AC\uC6A9\uC790**: \uBAA8\uB2EC \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uB9CC\uB4E4\uC5B4\uC918",
+        "",
+        "**\uC751\uB2F5**: \uC7AC\uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uBAA8\uB2EC \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uC0DD\uC131\uD558\uACA0\uC2B5\uB2C8\uB2E4..."
+      ],
+      "doc": [
+        "**\uC0AC\uC6A9\uC790**: API \uBB38\uC11C\uB97C \uC5C5\uB370\uC774\uD2B8\uD574\uC918",
+        "",
+        "**\uC751\uB2F5**: \uD604\uC7AC API \uC5D4\uB4DC\uD3EC\uC778\uD2B8\uB97C \uBD84\uC11D\uD558\uC5EC \uBB38\uC11C\uB97C \uC5C5\uB370\uC774\uD2B8\uD558\uACA0\uC2B5\uB2C8\uB2E4..."
+      ]
+    };
+    return exampleMap[name] ?? [
+      `**\uC0AC\uC6A9\uC790**: ${this.formatTitle(name)} \uC791\uC5C5\uC744 \uC218\uD589\uD574\uC918`,
+      "",
+      "**\uC751\uB2F5**: \uC694\uCCAD\uD558\uC2E0 \uC791\uC5C5\uC744 \uC218\uD589\uD558\uACA0\uC2B5\uB2C8\uB2E4..."
+    ];
+  }
+  /**
+   * 이름 포맷팅 (kebab-case → Title Case)
+   */
+  formatTitle(name) {
+    return name.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+  }
+};
+
+// src/core/prepare/prepare-report.ts
+import * as fs21 from "fs";
+import * as path34 from "path";
+var PrepareReportGenerator = class {
+  sddDir;
+  constructor(projectRoot) {
+    this.sddDir = path34.join(projectRoot, ".sdd");
+  }
+  /**
+   * 보고서 생성
+   */
+  generate(input) {
+    const agentMissing = input.agentChecks.filter((c) => c.status === "missing").length;
+    const agentExisting = input.agentChecks.filter((c) => c.status === "exists").length;
+    const skillMissing = input.skillChecks.filter((c) => c.status === "missing").length;
+    const skillExisting = input.skillChecks.filter((c) => c.status === "exists").length;
+    return {
+      feature: input.feature,
+      totalTasks: input.totalTasks,
+      agents: {
+        required: input.agentChecks.length,
+        existing: agentExisting,
+        missing: agentMissing,
+        checks: input.agentChecks
+      },
+      skills: {
+        required: input.skillChecks.length,
+        existing: skillExisting,
+        missing: skillMissing,
+        checks: input.skillChecks
+      },
+      proposals: [
+        ...input.generatedAgents.map((a) => ({
+          type: "agent",
+          name: a.name,
+          filePath: a.filePath,
+          content: a.content
+        })),
+        ...input.generatedSkills.map((s) => ({
+          type: "skill",
+          name: s.name,
+          filePath: s.filePath,
+          content: s.content
+        }))
+      ],
+      createdAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  }
+  /**
+   * 마크다운 보고서 생성
+   */
+  toMarkdown(report) {
+    const lines = [];
+    lines.push(`# Prepare: ${report.feature}`);
+    lines.push("");
+    lines.push(`> \uC0DD\uC131\uC77C: ${report.createdAt.split("T")[0]}`);
+    lines.push("");
+    lines.push("## \uBD84\uC11D \uC694\uC57D");
+    lines.push("");
+    lines.push(`- \uCD1D \uC791\uC5C5 \uC218: ${report.totalTasks}\uAC1C`);
+    lines.push(`- \uD544\uC694 \uC11C\uBE0C\uC5D0\uC774\uC804\uD2B8: ${report.agents.required}\uAC1C (\uC874\uC7AC: ${report.agents.existing}, \uB204\uB77D: ${report.agents.missing})`);
+    lines.push(`- \uD544\uC694 \uC2A4\uD0AC: ${report.skills.required}\uAC1C (\uC874\uC7AC: ${report.skills.existing}, \uB204\uB77D: ${report.skills.missing})`);
+    lines.push("");
+    if (report.agents.checks.length > 0) {
+      lines.push("## \uC11C\uBE0C\uC5D0\uC774\uC804\uD2B8 \uC810\uAC80");
+      lines.push("");
+      lines.push("> \uC704\uCE58: `.claude/agents/`");
+      lines.push("");
+      lines.push("| \uC5D0\uC774\uC804\uD2B8 | \uC124\uBA85 | \uC0C1\uD0DC | \uC870\uCE58 |");
+      lines.push("|----------|------|------|------|");
+      for (const check of report.agents.checks) {
+        const status = check.status === "exists" ? "\u2705 \uC874\uC7AC" : "\u274C \uC5C6\uC74C";
+        lines.push(`| ${check.tool.name} | ${check.tool.description} | ${status} | ${check.action} |`);
+      }
+      lines.push("");
+    }
+    if (report.skills.checks.length > 0) {
+      lines.push("## \uC2A4\uD0AC \uC810\uAC80");
+      lines.push("");
+      lines.push("> \uC704\uCE58: `.claude/skills/<name>/SKILL.md`");
+      lines.push("");
+      lines.push("| \uC2A4\uD0AC | \uC124\uBA85 | \uC0C1\uD0DC | \uC870\uCE58 |");
+      lines.push("|------|------|------|------|");
+      for (const check of report.skills.checks) {
+        const status = check.status === "exists" ? "\u2705 \uC874\uC7AC" : "\u274C \uC5C6\uC74C";
+        lines.push(`| ${check.tool.name} | ${check.tool.description} | ${status} | ${check.action} |`);
+      }
+      lines.push("");
+    }
+    const proposals = report.proposals.filter((p) => p.content);
+    if (proposals.length > 0) {
+      lines.push("## \uCD94\uAC00/\uC218\uC815 \uC81C\uC548");
+      lines.push("");
+      for (const proposal of proposals) {
+        const typeLabel = proposal.type === "agent" ? "\uC11C\uBE0C\uC5D0\uC774\uC804\uD2B8" : "\uC2A4\uD0AC";
+        lines.push(`### \uC0C8 ${typeLabel}: ${proposal.name}`);
+        lines.push("");
+        lines.push(`**\uD30C\uC77C:** \`${proposal.filePath}\``);
+        lines.push("");
+        lines.push("```markdown");
+        lines.push(proposal.content);
+        lines.push("```");
+        lines.push("");
+      }
+    }
+    const pendingApprovals = report.proposals.filter((p) => p.content);
+    if (pendingApprovals.length > 0) {
+      lines.push("## \uC2B9\uC778 \uB300\uAE30");
+      lines.push("");
+      for (const proposal of pendingApprovals) {
+        const typeLabel = proposal.type === "agent" ? "\uC11C\uBE0C\uC5D0\uC774\uC804\uD2B8" : "\uC2A4\uD0AC";
+        lines.push(`- [ ] ${proposal.name} ${typeLabel} \uCD94\uAC00 \u2192 \`${proposal.filePath}\``);
+      }
+      lines.push("");
+    }
+    return lines.join("\n");
+  }
+  /**
+   * 보고서 파일 저장
+   */
+  async writeReport(feature, report) {
+    const featureDir = path34.join(this.sddDir, "specs", feature);
+    if (!fs21.existsSync(featureDir)) {
+      fs21.mkdirSync(featureDir, { recursive: true });
+    }
+    const filePath = path34.join(featureDir, "prepare.md");
+    const content = this.toMarkdown(report);
+    fs21.writeFileSync(filePath, content, "utf-8");
+    return filePath;
+  }
+};
+
+// src/cli/commands/prepare.ts
+init_fs();
+init_errors();
+init_types();
+async function executePrepare(feature, options, projectRoot) {
+  try {
+    const docAnalyzer = new DocumentAnalyzer(projectRoot);
+    const analyses = await docAnalyzer.analyzeFeature(feature);
+    if (analyses.length === 0) {
+      return failure(new Error(`\uAE30\uB2A5 '${feature}'\uC758 \uBB38\uC11C\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`));
+    }
+    const toolDetector = new ToolDetector();
+    const detected = toolDetector.detect(analyses);
+    const agentScanner = new AgentScanner(projectRoot);
+    const existingAgents = await agentScanner.scanAll();
+    const existingAgentNames = new Set(existingAgents.map((a) => a.name));
+    const skillScanner = new SkillScanner(projectRoot);
+    const existingSkills = await skillScanner.scanAll();
+    const existingSkillNames = new Set(existingSkills.map((s) => s.name));
+    const agentChecks = detected.agents.map((agent) => ({
+      tool: agent,
+      status: existingAgentNames.has(agent.name) ? "exists" : "missing",
+      filePath: agentScanner.getAgentFilePath(agent.name),
+      action: existingAgentNames.has(agent.name) ? "-" : "\uCD94\uAC00 \uD544\uC694"
+    }));
+    const skillChecks = detected.skills.map((skill) => ({
+      tool: skill,
+      status: existingSkillNames.has(skill.name) ? "exists" : "missing",
+      filePath: skillScanner.getSkillFilePath(skill.name),
+      action: existingSkillNames.has(skill.name) ? "-" : "\uCD94\uAC00 \uD544\uC694"
+    }));
+    const agentGenerator = new AgentGenerator(projectRoot);
+    const skillGenerator = new SkillGenerator(projectRoot);
+    const generatedAgents = [];
+    const generatedSkills = [];
+    for (const check of agentChecks) {
+      if (check.status === "missing") {
+        generatedAgents.push(agentGenerator.generate(check.tool));
+      }
+    }
+    for (const check of skillChecks) {
+      if (check.status === "missing") {
+        generatedSkills.push(skillGenerator.generate(check.tool));
+      }
+    }
+    const reportGenerator = new PrepareReportGenerator(projectRoot);
+    const totalTasks = DocumentAnalyzer.getTotalTaskCount(analyses);
+    const report = reportGenerator.generate({
+      feature,
+      totalTasks,
+      agentChecks,
+      skillChecks,
+      generatedAgents,
+      generatedSkills
+    });
+    const result = {
+      report,
+      created: {
+        agents: [],
+        skills: []
+      }
+    };
+    if (!options.dryRun) {
+      result.reportPath = await reportGenerator.writeReport(feature, report);
+      if (options.autoApprove) {
+        for (const agent of generatedAgents) {
+          await agentGenerator.writeAgent(agent);
+          result.created.agents.push(agent.filePath);
+        }
+        for (const skill of generatedSkills) {
+          await skillGenerator.writeSkill(skill);
+          result.created.skills.push(skill.filePath);
+        }
+      }
+    }
+    return success(result);
+  } catch (error2) {
+    return failure(error2 instanceof Error ? error2 : new Error(String(error2)));
+  }
+}
+function registerPrepareCommand(program2) {
+  program2.command("prepare <feature>").description("\uAD6C\uD604 \uC804 \uD544\uC694\uD55C \uC11C\uBE0C\uC5D0\uC774\uC804\uD2B8\uC640 \uC2A4\uD0AC\uC744 \uC810\uAC80\uD569\uB2C8\uB2E4").option("--dry-run", "\uBCC0\uACBD \uC5C6\uC774 \uBD84\uC11D \uACB0\uACFC\uB9CC \uCD9C\uB825").option("--auto-approve", "\uB204\uB77D\uB41C \uB3C4\uAD6C\uB97C \uC790\uB3D9\uC73C\uB85C \uC0DD\uC131").option("--json", "JSON \uD615\uC2DD \uCD9C\uB825").action(async (feature, options) => {
+    try {
+      await runPrepare(feature, options);
+    } catch (error2) {
+      error(error2 instanceof Error ? error2.message : String(error2));
+      process.exit(ExitCode.GENERAL_ERROR);
+    }
+  });
+}
+async function runPrepare(feature, options) {
+  const projectRoot = await findSddRoot();
+  if (!projectRoot) {
+    error("SDD \uD504\uB85C\uC81D\uD2B8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. `sdd init`\uC744 \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694.");
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  info(`\uAE30\uB2A5 '${feature}' \uC900\uBE44 \uC810\uAC80 \uC911...`);
+  newline();
+  const result = await executePrepare(feature, options, projectRoot);
+  if (!result.success) {
+    error(result.error.message);
+    process.exit(ExitCode.GENERAL_ERROR);
+  }
+  const { report, reportPath, created } = result.data;
+  if (options.json) {
+    console.log(JSON.stringify(report, null, 2));
+    return;
+  }
+  success2("\uBD84\uC11D \uC644\uB8CC");
+  newline();
+  console.log(`\uCD1D \uC791\uC5C5 \uC218: ${report.totalTasks}\uAC1C`);
+  console.log(`\uC11C\uBE0C\uC5D0\uC774\uC804\uD2B8: ${report.agents.required}\uAC1C \uD544\uC694 (\uC874\uC7AC: ${report.agents.existing}, \uB204\uB77D: ${report.agents.missing})`);
+  console.log(`\uC2A4\uD0AC: ${report.skills.required}\uAC1C \uD544\uC694 (\uC874\uC7AC: ${report.skills.existing}, \uB204\uB77D: ${report.skills.missing})`);
+  newline();
+  const missingAgents = report.agents.checks.filter((c) => c.status === "missing");
+  const missingSkills = report.skills.checks.filter((c) => c.status === "missing");
+  if (missingAgents.length > 0) {
+    warn("\uB204\uB77D\uB41C \uC11C\uBE0C\uC5D0\uC774\uC804\uD2B8:");
+    for (const check of missingAgents) {
+      console.log(`  - ${check.tool.name}: ${check.tool.description}`);
+    }
+    newline();
+  }
+  if (missingSkills.length > 0) {
+    warn("\uB204\uB77D\uB41C \uC2A4\uD0AC:");
+    for (const check of missingSkills) {
+      console.log(`  - ${check.tool.name}: ${check.tool.description}`);
+    }
+    newline();
+  }
+  if (created.agents.length > 0 || created.skills.length > 0) {
+    success2("\uC0DD\uC131\uB41C \uD30C\uC77C:");
+    for (const file of [...created.agents, ...created.skills]) {
+      console.log(`  - ${path35.relative(projectRoot, file)}`);
+    }
+    newline();
+  }
+  if (reportPath) {
+    info(`\uBCF4\uACE0\uC11C: ${path35.relative(projectRoot, reportPath)}`);
+  }
+  if (missingAgents.length > 0 || missingSkills.length > 0) {
+    if (!options.autoApprove && !options.dryRun) {
+      newline();
+      info("\uB204\uB77D\uB41C \uB3C4\uAD6C\uB97C \uC790\uB3D9 \uC0DD\uC131\uD558\uB824\uBA74: sdd prepare " + feature + " --auto-approve");
+    }
+  }
+}
+
 // src/cli/index.ts
 var require2 = createRequire(import.meta.url);
 var pkg = require2("../../package.json");
@@ -11857,6 +13052,7 @@ registerWatchCommand(program);
 registerQualityCommand(program);
 registerReportCommand(program);
 registerSearchCommand(program);
+registerPrepareCommand(program);
 function run() {
   program.parse();
 }