sdd-tool 1.3.0 → 1.3.2

package/README.md

@@ -345,11 +345,17 @@ sdd list                    # 목록 조회
 ### 기능 개발
 
 ```bash
-sdd new <name>              # 새 기능 생성
+sdd new <name>              # 새 기능 생성 (common 도메인)
+sdd new <name> -d <domain>  # 도메인 지정 생성 (v1.3.0)
 sdd new <name> --all        # spec + plan + tasks 모두 생성
 sdd prepare <name>          # 서브에이전트/스킬 점검
 ```
 
+**v1.3.0 도메인 기반 구조:**
+- 도메인 미지정 시 `common` 폴더에 생성
+- 경로: `.sdd/specs/<domain>/<feature>/spec.md`
+- 예: `sdd new login -d auth` → `.sdd/specs/auth/login/spec.md`
+
 ### 변경 관리
 
 ```bash
@@ -458,17 +464,20 @@ your-project/
 │   ├── AGENTS.md           # AI 워크플로우 가이드
 │   ├── domains.yml         # 도메인 정의 (v1.2.0)
 │   ├── .context.json       # 현재 컨텍스트 (v1.2.0)
-│   ├── specs/              # 기능 명세
-│   │   ├── feature-name/   # 단순 기능
-│   │   │   ├── spec.md
-│   │   │   ├── plan.md
-│   │   │   └── tasks.md
-│   │   └── domain-name/    # 도메인별 그룹 (v1.2.0)
-│   │       └── feature/
-│   │           └── spec.md
+│   ├── specs/              # 기능 명세 (v1.3.0: 도메인 기반 구조)
+│   │   ├── common/         # 기본 도메인 (도메인 미지정 시)
+│   │   │   └── feature-name/
+│   │   │       ├── spec.md
+│   │   │       ├── plan.md
+│   │   │       └── tasks.md
+│   │   └── auth/           # 도메인별 그룹
+│   │       └── login/
+│   │           ├── spec.md
+│   │           ├── plan.md
+│   │           └── tasks.md
 │   ├── changes/            # 변경 제안
 │   ├── archive/            # 완료된 변경
-│   └── drafts/             # 역추출 임시 스펙 (v1.2.0)
+│   └── .reverse-drafts/    # 역추출 임시 스펙 (v1.2.0)
 │
 └── .claude/
     ├── commands/           # 슬래시 커맨드 (29개)

package/dist/cli/index.js

@@ -1954,8 +1954,8 @@ var validateCommand = {
 # \uC804\uCCB4 \uC2A4\uD399 \uAC80\uC99D
 sdd validate
 
-# \uD2B9\uC815 \uD30C\uC77C \uAC80\uC99D
-sdd validate .sdd/specs/user-auth/spec.md
+# \uD2B9\uC815 \uD30C\uC77C \uAC80\uC99D (\uB3C4\uBA54\uC778 \uAE30\uBC18 \uACBD\uB85C)
+sdd validate .sdd/specs/auth/user-auth/spec.md
 
 # \uC5C4\uACA9 \uBAA8\uB4DC (\uACBD\uACE0\uB3C4 \uC5D0\uB7EC\uB85C \uCC98\uB9AC)
 sdd validate --strict
@@ -2080,7 +2080,7 @@ created: YYYY-MM-DD
 
 ## \uC601\uD5A5 \uBC94\uC704
 ### \uC601\uD5A5\uBC1B\uB294 \uC2A4\uD399
-- \`specs/user-auth/spec.md\`
+- \`.sdd/specs/auth/user-auth/spec.md\`
 
 ### \uBCC0\uACBD \uC720\uD615
 - [x] \uC218\uC815 (MODIFIED)
@@ -2705,9 +2705,23 @@ sdd reverse finalize -d auth      # \uD2B9\uC815 \uB3C4\uBA54\uC778 \uD655\uC815
 
 **\uC218\uD589 \uC791\uC5C5:**
 - \`.sdd/.reverse-drafts/\`\uC5D0\uC11C \uC2B9\uC778\uB41C \uC2A4\uD399 \uC77D\uAE30
-- \`.sdd/specs/<feature-id>/spec.md\` \uC0DD\uC131
+- \`.sdd/specs/<domain>/<feature-id>/spec.md\` \uC0DD\uC131 (\`/sdd.new\`\uC640 \uB3D9\uC77C\uD55C \uD615\uC2DD)
 - \uCD08\uC548 \uD30C\uC77C \uC0AD\uC81C
 
+**\uC0DD\uC131\uB418\uB294 \uC2A4\uD399 \uD615\uC2DD:**
+
+finalize\uB85C \uC0DD\uC131\uB418\uB294 \uC2A4\uD399\uC740 \`/sdd.new\`\uC640 **\uB3D9\uC77C\uD55C \uD615\uC2DD**\uC785\uB2C8\uB2E4:
+
+- YAML frontmatter (id, title, status, domain, depends, ...)
+- \`## \uC694\uAD6C\uC0AC\uD56D\` + REQ-ID + RFC 2119 \uD0A4\uC6CC\uB4DC (SHALL)
+- \`## \uC2DC\uB098\uB9AC\uC624\` + \`- **GIVEN/WHEN/THEN**\` \uD615\uC2DD
+- \`## \uBE44\uAE30\uB2A5 \uC694\uAD6C\uC0AC\uD56D\`, \`## \uC81C\uC57D\uC0AC\uD56D\`, \`## \uC6A9\uC5B4 \uC815\uC758\`
+
+\uCD94\uAC00 \uBA54\uD0C0\uB370\uC774\uD130 (\uC5ED\uCD94\uCD9C \uC804\uC6A9):
+- \`extracted_from: reverse-extraction\`
+- \`confidence: <\uC2E0\uB8B0\uB3C4 \uC810\uC218>\`
+- \`source_files: [\uC6D0\uBCF8 \uD30C\uC77C \uBAA9\uB85D]\`
+
 **\uC644\uB8CC \uD6C4 \uC548\uB0B4:** "\uC2A4\uD399 \uD655\uC815\uC774 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \`/sdd.validate\`\uB85C \uC2A4\uD399\uC744 \uAC80\uC99D\uD558\uAC70\uB098 \`/sdd.new\`\uB85C \uC0C8 \uAE30\uB2A5\uC744 \uCD94\uAC00\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4."
 
 ## \uCD9C\uB825 \uD30C\uC77C
@@ -21302,12 +21316,14 @@ function formatSpecAsMarkdown(spec) {
   if (spec.scenarios.length > 0) {
     lines.push("## \uC2DC\uB098\uB9AC\uC624");
     lines.push("");
-    for (const scenario of spec.scenarios) {
-      lines.push(`### ${scenario.name}${scenario.inferred ? " *(\uCD94\uB860\uB428)*" : ""}`);
+    for (let i = 0; i < spec.scenarios.length; i++) {
+      const scenario = spec.scenarios[i];
+      const inferredTag = scenario.inferred ? " *(\uCD94\uB860\uB428)*" : "";
+      lines.push(`### Scenario ${i + 1}: ${scenario.name}${inferredTag}`);
       lines.push("");
-      lines.push(`**Given** ${scenario.given}`);
-      lines.push(`**When** ${scenario.when}`);
-      lines.push(`**Then** ${scenario.then}`);
+      lines.push(`- **GIVEN** ${scenario.given}`);
+      lines.push(`- **WHEN** ${scenario.when}`);
+      lines.push(`- **THEN** ${scenario.then}`);
       lines.push("");
     }
   }
@@ -21759,88 +21775,128 @@ import path52 from "path";
 import { promises as fs34 } from "fs";
 import chalk7 from "chalk";
 function convertToSddSpec(spec) {
-  const lines = [];
-  lines.push(`# ${spec.name}`);
-  lines.push("");
-  lines.push(`> \uB3C4\uBA54\uC778: \`${spec.domain}\``);
-  lines.push(`> \uBC84\uC804: ${spec.metadata.version}`);
-  lines.push(`> \uC0C1\uD0DC: ACTIVE`);
-  lines.push("");
-  lines.push("## \uAC1C\uC694");
-  lines.push("");
-  lines.push(spec.description);
-  lines.push("");
-  lines.push("## \uC2DC\uB098\uB9AC\uC624");
-  lines.push("");
-  for (const scenario of spec.scenarios) {
-    lines.push(`### ${scenario.name}`);
-    lines.push("");
-    lines.push("```gherkin");
-    lines.push(`Given ${scenario.given}`);
-    lines.push(`When ${scenario.when}`);
-    lines.push(`Then ${scenario.then}`);
-    lines.push("```");
-    lines.push("");
-  }
+  const extractedAt = spec.metadata.extractedAt instanceof Date ? spec.metadata.extractedAt.toISOString().split("T")[0] : String(spec.metadata.extractedAt).split("T")[0];
+  const featureId = spec.id.includes("/") ? spec.id.split("/").pop() : spec.id;
+  const sourceFilesYaml = spec.metadata.sourceFiles.length > 0 ? spec.metadata.sourceFiles.map((f) => `  - ${f}`).join("\n") : "  - (none)";
+  let content = `---
+id: ${featureId}
+title: "${spec.name}"
+status: draft
+created: ${extractedAt}
+domain: ${spec.domain}
+depends: null
+extracted_from: reverse-extraction
+confidence: ${spec.confidence.score}
+source_files:
+${sourceFilesYaml}
+---
+
+# ${spec.name}
+
+> ${spec.description}
+
+---
+
+## \uAC1C\uC694
+
+${spec.description}
+
+---
+
+## \uC694\uAD6C\uC0AC\uD56D
+
+`;
   if (spec.contracts.length > 0) {
-    lines.push("## \uACC4\uC57D");
-    lines.push("");
-    const inputContracts = spec.contracts.filter((c) => c.type === "input");
-    const outputContracts = spec.contracts.filter((c) => c.type === "output");
-    if (inputContracts.length > 0) {
-      lines.push("### \uC785\uB825");
-      lines.push("");
-      for (const contract of inputContracts) {
-        lines.push(`- ${contract.description}`);
-        if (contract.signature) {
-          lines.push(`  \`\`\`typescript`);
-          lines.push(`  ${contract.signature}`);
-          lines.push(`  \`\`\``);
-        }
+    let reqIndex = 1;
+    for (const contract of spec.contracts) {
+      const reqId = `REQ-${String(reqIndex++).padStart(2, "0")}`;
+      const reqTitle = contract.description.split("\uC758")[0] || contract.description;
+      content += `### ${reqId}: ${reqTitle}
+
+\uC2DC\uC2A4\uD15C\uC740 ${contract.description.toLowerCase()}\uC744(\uB97C) \uC81C\uACF5\uD574\uC57C \uD55C\uB2E4(SHALL).
+
+`;
+      if (contract.signature) {
+        content += `\`\`\`typescript
+${contract.signature}
+\`\`\`
+
+`;
       }
-      lines.push("");
     }
-    if (outputContracts.length > 0) {
-      lines.push("### \uCD9C\uB825");
-      lines.push("");
-      for (const contract of outputContracts) {
-        lines.push(`- ${contract.description}`);
-        if (contract.signature) {
-          lines.push(`  \`\`\`typescript`);
-          lines.push(`  ${contract.signature}`);
-          lines.push(`  \`\`\``);
-        }
-      }
-      lines.push("");
+  } else {
+    content += `### REQ-01: [\uC694\uAD6C\uC0AC\uD56D \uC81C\uBAA9]
+
+[\uC694\uAD6C\uC0AC\uD56D \uC0C1\uC138 \uC124\uBA85]
+- \uC2DC\uC2A4\uD15C\uC740 [\uAE30\uB2A5]\uC744 \uC9C0\uC6D0\uD574\uC57C \uD55C\uB2E4(SHALL)
+
+`;
+  }
+  content += `---
+
+## \uC2DC\uB098\uB9AC\uC624
+
+`;
+  if (spec.scenarios.length > 0) {
+    for (let i = 0; i < spec.scenarios.length; i++) {
+      const scenario = spec.scenarios[i];
+      content += `### Scenario ${i + 1}: ${scenario.name}
+
+- **GIVEN** ${scenario.given}
+- **WHEN** ${scenario.when}
+- **THEN** ${scenario.then}
+
+`;
     }
+  } else {
+    content += `### Scenario 1: [\uC2DC\uB098\uB9AC\uC624\uBA85]
+
+- **GIVEN** [\uC804\uC81C \uC870\uAC74]
+- **WHEN** [\uD589\uB3D9/\uD2B8\uB9AC\uAC70]
+- **THEN** [\uC608\uC0C1 \uACB0\uACFC]
+
+`;
   }
+  content += `---
+
+## \uBE44\uAE30\uB2A5 \uC694\uAD6C\uC0AC\uD56D
+
+### \uC131\uB2A5
+
+- \uC751\uB2F5 \uC2DC\uAC04: [N]ms \uC774\uB0B4 (SHOULD)
+
+### \uBCF4\uC548
+
+- [\uBCF4\uC548 \uC694\uAD6C\uC0AC\uD56D] (SHALL)
+
+---
+
+## \uC81C\uC57D\uC0AC\uD56D
+
+- \uC6D0\uBCF8 \uD30C\uC77C: ${spec.metadata.sourceFiles.join(", ") || "(\uC5C6\uC74C)"}
+- \uC5ED\uCD94\uCD9C \uC2E0\uB8B0\uB3C4: ${spec.confidence.grade} (${spec.confidence.score}%)
+
+---
+
+## \uC6A9\uC5B4 \uC815\uC758
+
+| \uC6A9\uC5B4 | \uC815\uC758 |
+|------|------|
+| [\uC6A9\uC5B41] | [\uC815\uC7581] |
+`;
   if (spec.relatedSpecs.length > 0) {
-    lines.push("## \uAD00\uB828 \uC2A4\uD399");
-    lines.push("");
+    content += `
+---
+
+## \uAD00\uB828 \uC2A4\uD399
+
+`;
     for (const related of spec.relatedSpecs) {
-      lines.push(`- [[${related}]]`);
+      content += `- [[${related}]]
+`;
     }
-    lines.push("");
   }
-  lines.push("---");
-  lines.push("");
-  lines.push("## \uBA54\uD0C0\uB370\uC774\uD130");
-  lines.push("");
-  lines.push("```yaml");
-  lines.push(`id: ${spec.id}`);
-  lines.push(`domain: ${spec.domain}`);
-  lines.push(`version: ${spec.metadata.version}`);
-  lines.push(`source: reverse-extraction`);
-  lines.push(`extracted_at: ${spec.metadata.extractedAt.toISOString()}`);
-  lines.push(`finalized_at: ${(/* @__PURE__ */ new Date()).toISOString()}`);
-  lines.push(`confidence: ${spec.confidence.score}`);
-  lines.push(`source_files:`);
-  for (const file of spec.metadata.sourceFiles) {
-    lines.push(`  - ${file}`);
-  }
-  lines.push("```");
-  lines.push("");
-  return lines.join("\n");
+  return content;
 }
 async function finalizeSpec(sddRoot, spec) {
   try {