sdd-tool 0.1.0 → 0.2.0

package/dist/cli/index.js

@@ -434,6 +434,269 @@ sdd validate --strict    # \uACBD\uACE0\uB3C4 \uC5D0\uB7EC\uB85C \uCC98\uB9AC
 `;
 }
 
+// src/generators/claude-commands.ts
+function generateClaudeCommands() {
+  return [
+    {
+      name: "sdd-new",
+      content: `\uC0C8\uB85C\uC6B4 \uAE30\uB2A5 \uBA85\uC138\uB97C \uC791\uC131\uD569\uB2C8\uB2E4.
+
+## \uC9C0\uC2DC\uC0AC\uD56D
+
+1. \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uAE30\uB2A5\uBA85\uACFC \uAC04\uB2E8\uD55C \uC124\uBA85\uC744 \uC694\uCCAD\uD558\uC138\uC694
+2. \`sdd new <feature-id> --all\` \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD558\uC5EC \uAE30\uBCF8 \uAD6C\uC870\uB97C \uC0DD\uC131\uD558\uC138\uC694
+3. \uC0DD\uC131\uB41C \`.sdd/specs/<feature-id>/spec.md\` \uD30C\uC77C\uC744 \uC5F4\uC5B4 \uB0B4\uC6A9\uC744 \uC791\uC131\uD558\uC138\uC694
+
+## \uBA85\uC138 \uC791\uC131 \uADDC\uCE59
+
+- RFC 2119 \uD0A4\uC6CC\uB4DC \uC0AC\uC6A9: SHALL, MUST, SHOULD, MAY, SHALL NOT
+- GIVEN-WHEN-THEN \uD615\uC2DD\uC758 \uC2DC\uB098\uB9AC\uC624 \uD3EC\uD568 \uD544\uC218
+- \uAC01 \uC694\uAD6C\uC0AC\uD56D\uC5D0 \uACE0\uC720 ID \uBD80\uC5EC (REQ-001, REQ-002, ...)
+
+## \uC608\uC2DC
+
+\`\`\`markdown
+### REQ-01: \uC0AC\uC6A9\uC790 \uC778\uC99D
+
+\uC2DC\uC2A4\uD15C\uC740 \uC774\uBA54\uC77C\uACFC \uBE44\uBC00\uBC88\uD638\uB85C \uC0AC\uC6A9\uC790\uB97C \uC778\uC99D\uD574\uC57C \uD55C\uB2E4(SHALL).
+
+### Scenario: \uC62C\uBC14\uB978 \uC790\uACA9 \uC99D\uBA85\uC73C\uB85C \uB85C\uADF8\uC778
+
+- **GIVEN** \uB4F1\uB85D\uB41C \uC0AC\uC6A9\uC790\uAC00 \uC874\uC7AC\uD560 \uB54C
+- **WHEN** \uC62C\uBC14\uB978 \uC774\uBA54\uC77C\uACFC \uBE44\uBC00\uBC88\uD638\uB85C \uB85C\uADF8\uC778\uC744 \uC2DC\uB3C4\uD558\uBA74
+- **THEN** \uC561\uC138\uC2A4 \uD1A0\uD070\uC774 \uBC1C\uAE09\uB418\uC5B4\uC57C \uD55C\uB2E4
+\`\`\`
+
+\uC644\uB8CC \uD6C4 \`sdd validate\`\uB85C \uBA85\uC138\uB97C \uAC80\uC99D\uD558\uC138\uC694.
+`
+    },
+    {
+      name: "sdd-plan",
+      content: `\uAE30\uB2A5 \uBA85\uC138\uC5D0 \uB300\uD55C \uAD6C\uD604 \uACC4\uD68D\uC744 \uC791\uC131\uD569\uB2C8\uB2E4.
+
+## \uC9C0\uC2DC\uC0AC\uD56D
+
+1. \`.sdd/specs/\` \uB514\uB809\uD1A0\uB9AC\uC5D0\uC11C \uACC4\uD68D\uC744 \uC791\uC131\uD560 \uAE30\uB2A5\uC744 \uD655\uC778\uD558\uC138\uC694
+2. \uD574\uB2F9 \uAE30\uB2A5\uC758 \`spec.md\`\uB97C \uC77D\uACE0 \uC694\uAD6C\uC0AC\uD56D\uC744 \uBD84\uC11D\uD558\uC138\uC694
+3. \`sdd new plan <feature-id>\` \uBA85\uB839\uC5B4\uB85C \uACC4\uD68D \uD15C\uD50C\uB9BF\uC744 \uC0DD\uC131\uD558\uAC70\uB098 \uAE30\uC874 \`plan.md\`\uB97C \uC218\uC815\uD558\uC138\uC694
+
+## \uACC4\uD68D \uC791\uC131 \uADDC\uCE59
+
+- \uAE30\uC220 \uACB0\uC815\uC0AC\uD56D\uACFC \uADF8 \uADFC\uAC70\uB97C \uBA85\uC2DC
+- \uAD6C\uD604 \uB2E8\uACC4(Phase)\uB97C \uB098\uB204\uC5B4 \uC815\uC758
+- \uAC01 \uB2E8\uACC4\uBCC4 \uC0B0\uCD9C\uBB3C \uBAA9\uB85D \uC791\uC131
+- \uB9AC\uC2A4\uD06C \uBD84\uC11D \uBC0F \uC644\uD654 \uC804\uB7B5 \uD3EC\uD568
+- \uD14C\uC2A4\uD2B8 \uC804\uB7B5 \uC218\uB9BD
+
+## \uACC4\uD68D \uAD6C\uC870
+
+\`\`\`markdown
+## \uAE30\uC220 \uACB0\uC815
+### \uACB0\uC815 1: [\uC81C\uBAA9]
+**\uADFC\uAC70:** [\uC65C \uC774 \uAE30\uC220/\uBC29\uC2DD\uC744 \uC120\uD0DD\uD588\uB294\uC9C0]
+
+## \uAD6C\uD604 \uB2E8\uACC4
+### Phase 1: \uAE30\uBC18 \uAD6C\uC870
+[\uC124\uBA85]
+**\uC0B0\uCD9C\uBB3C:**
+- [ ] \uC0B0\uCD9C\uBB3C 1
+- [ ] \uC0B0\uCD9C\uBB3C 2
+
+## \uB9AC\uC2A4\uD06C \uBD84\uC11D
+| \uB9AC\uC2A4\uD06C | \uC601\uD5A5\uB3C4 | \uC644\uD654 \uC804\uB7B5 |
+\`\`\`
+
+\uC644\uB8CC \uD6C4 \`/sdd-tasks\`\uB85C \uC791\uC5C5\uC744 \uBD84\uD574\uD558\uC138\uC694.
+`
+    },
+    {
+      name: "sdd-tasks",
+      content: `\uAD6C\uD604 \uACC4\uD68D\uC744 \uC2E4\uD589 \uAC00\uB2A5\uD55C \uC791\uC5C5\uC73C\uB85C \uBD84\uD574\uD569\uB2C8\uB2E4.
+
+## \uC9C0\uC2DC\uC0AC\uD56D
+
+1. \uD574\uB2F9 \uAE30\uB2A5\uC758 \`plan.md\`\uB97C \uC77D\uACE0 \uAD6C\uD604 \uB2E8\uACC4\uB97C \uD655\uC778\uD558\uC138\uC694
+2. \`sdd new tasks <feature-id>\` \uBA85\uB839\uC5B4\uB85C \uC791\uC5C5 \uBAA9\uB85D\uC744 \uC0DD\uC131\uD558\uC138\uC694
+3. \uAC01 \uC791\uC5C5\uC5D0 \uC6B0\uC120\uC21C\uC704\uC640 \uC0C1\uD0DC\uB97C \uC9C0\uC815\uD558\uC138\uC694
+
+## \uC791\uC5C5 \uBD84\uD574 \uADDC\uCE59
+
+- \uAC01 \uC791\uC5C5\uC740 2-4\uC2DC\uAC04 \uB0B4 \uC644\uB8CC \uAC00\uB2A5\uD55C \uD06C\uAE30\uB85C \uBD84\uD574
+- \uC791\uC5C5 \uAC04 \uC758\uC874\uC131\uC744 \uBA85\uD655\uD788 \uD45C\uC2DC
+- \uC6B0\uC120\uC21C\uC704: HIGH(\u{1F534}), MEDIUM(\u{1F7E1}), LOW(\u{1F7E2})
+- \uC0C1\uD0DC: \uB300\uAE30, \uC9C4\uD589 \uC911, \uC644\uB8CC, \uCC28\uB2E8\uB428
+
+## \uC791\uC5C5 \uAD6C\uC870
+
+\`\`\`markdown
+### <feature>-task-001: [\uC791\uC5C5 \uC81C\uBAA9]
+
+- **\uC0C1\uD0DC:** \uB300\uAE30
+- **\uC6B0\uC120\uC21C\uC704:** \u{1F534} HIGH
+- **\uC758\uC874\uC131:** \uC5C6\uC74C
+
+#### \uC124\uBA85
+[\uC791\uC5C5 \uC0C1\uC138 \uC124\uBA85]
+
+#### \uC644\uB8CC \uC870\uAC74
+- [ ] \uC870\uAC74 1
+- [ ] \uC870\uAC74 2
+\`\`\`
+
+\uC644\uB8CC \uD6C4 \`/sdd-implement\`\uB85C \uAD6C\uD604\uC744 \uC2DC\uC791\uD558\uC138\uC694.
+`
+    },
+    {
+      name: "sdd-implement",
+      content: `\uC791\uC5C5 \uBAA9\uB85D\uC744 \uAE30\uBC18\uC73C\uB85C \uC21C\uCC28\uC801\uC73C\uB85C \uAD6C\uD604\uD569\uB2C8\uB2E4.
+
+## \uC9C0\uC2DC\uC0AC\uD56D
+
+1. \`sdd status\`\uB85C \uD604\uC7AC \uC9C4\uD589 \uC0C1\uD669\uC744 \uD655\uC778\uD558\uC138\uC694
+2. \uD574\uB2F9 \uAE30\uB2A5\uC758 \`tasks.md\`\uB97C \uC77D\uACE0 \uB2E4\uC74C \uC791\uC5C5\uC744 \uD655\uC778\uD558\uC138\uC694
+3. \uC791\uC5C5\uC744 \uAD6C\uD604\uD558\uACE0 \uC644\uB8CC \uC2DC \uC0C1\uD0DC\uB97C \uC5C5\uB370\uC774\uD2B8\uD558\uC138\uC694
+
+## \uAD6C\uD604 \uADDC\uCE59
+
+- \uD55C \uBC88\uC5D0 \uD558\uB098\uC758 \uC791\uC5C5\uB9CC \uC9C4\uD589
+- \uAC01 \uC791\uC5C5 \uC644\uB8CC \uD6C4 \uD14C\uC2A4\uD2B8 \uC791\uC131 \uD544\uC218
+- \uCEE4\uBC0B \uBA54\uC2DC\uC9C0\uC5D0 \uC791\uC5C5 ID \uD3EC\uD568
+- \`.sdd/constitution.md\`\uC758 \uC6D0\uCE59 \uC900\uC218
+
+## \uC791\uC5C5 \uD750\uB984
+
+1. \uC791\uC5C5 \uC0C1\uD0DC\uB97C "\uC9C4\uD589 \uC911"\uC73C\uB85C \uBCC0\uACBD
+2. \uCF54\uB4DC \uAD6C\uD604
+3. \uD14C\uC2A4\uD2B8 \uC791\uC131 \uBC0F \uC2E4\uD589
+4. \uC791\uC5C5 \uC0C1\uD0DC\uB97C "\uC644\uB8CC"\uB85C \uBCC0\uACBD
+5. \uCEE4\uBC0B: \`feat(<feature>): <task-id> - <\uC124\uBA85>\`
+
+## \uC644\uB8CC \uC870\uAC74
+
+\uBAA8\uB4E0 \uC791\uC5C5\uC774 \uC644\uB8CC\uB418\uBA74:
+1. \`sdd validate\`\uB85C \uCD5C\uC885 \uAC80\uC99D
+2. PR \uC0DD\uC131 \uB610\uB294 \uBA38\uC9C0
+3. \uD544\uC694\uC2DC \`/sdd-archive\`\uB85C \uC544\uCE74\uC774\uBE0C
+`
+    },
+    {
+      name: "sdd-validate",
+      content: `\uC2A4\uD399 \uD30C\uC77C\uC758 \uD615\uC2DD\uACFC \uADDC\uCE59\uC744 \uAC80\uC99D\uD569\uB2C8\uB2E4.
+
+## \uC9C0\uC2DC\uC0AC\uD56D
+
+\`sdd validate\` \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD558\uC5EC \uBAA8\uB4E0 \uC2A4\uD399\uC744 \uAC80\uC99D\uD558\uC138\uC694.
+
+## \uAC80\uC99D \uD56D\uBAA9
+
+1. **RFC 2119 \uD0A4\uC6CC\uB4DC**: SHALL, MUST, SHOULD, MAY \uB4F1 \uD3EC\uD568 \uC5EC\uBD80
+2. **GIVEN-WHEN-THEN**: \uC2DC\uB098\uB9AC\uC624 \uD615\uC2DD \uC900\uC218 \uC5EC\uBD80
+3. **\uBA54\uD0C0\uB370\uC774\uD130**: YAML frontmatter \uD544\uC218 \uD544\uB4DC \uD655\uC778
+4. **\uAD6C\uC870**: \uD544\uC218 \uC139\uC158 \uC874\uC7AC \uC5EC\uBD80
+
+## \uC0AC\uC6A9\uBC95
+
+\`\`\`bash
+# \uC804\uCCB4 \uC2A4\uD399 \uAC80\uC99D
+sdd validate
+
+# \uD2B9\uC815 \uD30C\uC77C \uAC80\uC99D
+sdd validate .sdd/specs/user-auth/spec.md
+
+# \uC5C4\uACA9 \uBAA8\uB4DC (\uACBD\uACE0\uB3C4 \uC5D0\uB7EC\uB85C \uCC98\uB9AC)
+sdd validate --strict
+\`\`\`
+
+## \uC624\uB958 \uD574\uACB0
+
+\uAC80\uC99D \uC2E4\uD328 \uC2DC \uD574\uB2F9 \uD30C\uC77C\uC744 \uC5F4\uC5B4 \uC624\uB958\uB97C \uC218\uC815\uD558\uC138\uC694.
+\uAC01 \uC624\uB958 \uBA54\uC2DC\uC9C0\uC5D0\uB294 \uD574\uACB0 \uBC29\uBC95\uC774 \uD3EC\uD568\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.
+`
+    },
+    {
+      name: "sdd-status",
+      content: `\uD604\uC7AC SDD \uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC\uB97C \uD655\uC778\uD569\uB2C8\uB2E4.
+
+## \uC9C0\uC2DC\uC0AC\uD56D
+
+\`sdd status\` \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD558\uC5EC \uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC\uB97C \uD655\uC778\uD558\uC138\uC694.
+
+## \uD655\uC778 \uD56D\uBAA9
+
+- \uD504\uB85C\uC81D\uD2B8 \uAD6C\uC870 (constitution.md, AGENTS.md \uC874\uC7AC \uC5EC\uBD80)
+- \uAE30\uB2A5 \uBAA9\uB85D \uBC0F \uC0C1\uD0DC
+- \uD604\uC7AC Git \uBE0C\uB79C\uCE58
+- \uB2E4\uC74C \uB2E8\uACC4 \uC81C\uC548
+
+## \uCD94\uAC00 \uBA85\uB839\uC5B4
+
+\`\`\`bash
+# \uD504\uB85C\uC81D\uD2B8 \uC694\uC57D
+sdd list
+
+# \uAE30\uB2A5 \uBAA9\uB85D
+sdd list features
+
+# \uC2A4\uD399 \uD30C\uC77C \uBAA9\uB85D
+sdd list specs
+
+# JSON \uD615\uC2DD \uCD9C\uB825
+sdd status --json
+\`\`\`
+`
+    },
+    {
+      name: "sdd-change",
+      content: `\uAE30\uC874 \uC2A4\uD399\uC5D0 \uB300\uD55C \uBCC0\uACBD\uC744 \uC81C\uC548\uD569\uB2C8\uB2E4.
+
+## \uC9C0\uC2DC\uC0AC\uD56D
+
+1. \uBCC0\uACBD\uC774 \uD544\uC694\uD55C \uC2A4\uD399\uC744 \uD655\uC778\uD558\uC138\uC694
+2. \`.sdd/changes/\` \uB514\uB809\uD1A0\uB9AC\uC5D0 \uBCC0\uACBD \uC81C\uC548\uC11C\uB97C \uC791\uC131\uD558\uC138\uC694
+3. \uBCC0\uACBD \uC720\uD615(ADDED, MODIFIED, REMOVED)\uC744 \uBA85\uC2DC\uD558\uC138\uC694
+
+## \uBCC0\uACBD \uC81C\uC548\uC11C \uAD6C\uC870
+
+\`\`\`markdown
+---
+id: CHG-001
+status: draft
+created: YYYY-MM-DD
+---
+
+# \uBCC0\uACBD \uC81C\uC548: [\uC81C\uBAA9]
+
+## \uBC30\uACBD
+\uC65C \uC774 \uBCC0\uACBD\uC774 \uD544\uC694\uD55C\uAC00?
+
+## \uC601\uD5A5 \uBC94\uC704
+### \uC601\uD5A5\uBC1B\uB294 \uC2A4\uD399
+- \`specs/user-auth/spec.md\`
+
+### \uBCC0\uACBD \uC720\uD615
+- [x] \uC218\uC815 (MODIFIED)
+
+## \uBCC0\uACBD \uB0B4\uC6A9
+
+### MODIFIED
+
+#### Before
+\`\`\`markdown
+\uAE30\uC874 \uB0B4\uC6A9
+\`\`\`
+
+#### After
+\`\`\`markdown
+\uBCC0\uACBD\uB41C \uB0B4\uC6A9
+\`\`\`
+\`\`\`
+
+\uAC80\uD1A0 \uD6C4 \uC2B9\uC778\uB418\uBA74 \uC2A4\uD399\uC5D0 \uBC18\uC601\uD558\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) => {
@@ -461,7 +724,9 @@ async function runInit(options) {
     ".sdd/specs",
     ".sdd/changes",
     ".sdd/archive",
-    ".sdd/templates"
+    ".sdd/templates",
+    ".claude",
+    ".claude/commands"
   ];
   for (const dir of directories) {
     const result = await ensureDir(path2.join(cwd, dir));
@@ -472,6 +737,7 @@ async function runInit(options) {
   }
   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:");
@@ -482,10 +748,21 @@ async function runInit(options) {
   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-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 validate`\uB85C \uC2A4\uD399\uC744 \uAC80\uC99D\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4");
+  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);
@@ -709,6 +986,15 @@ graph LR
   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
+    );
+  }
+}
 
 // src/cli/commands/validate.ts
 import path4 from "path";