sdd-tool 1.2.5 → 1.2.6

package/dist/cli/index.js

@@ -1627,12 +1627,16 @@ var startCommand = {
 
 1. \uBA3C\uC800 \uD504\uB85C\uC81D\uD2B8 \uAD6C\uC870\uB97C \uBD84\uC11D\uD558\uC138\uC694:
    - .sdd/ \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC \uC5EC\uBD80 \uD655\uC778
+   - .sdd/specs/ \uB514\uB809\uD1A0\uB9AC \uB0B4 \uC2A4\uD399 \uD30C\uC77C \uC874\uC7AC \uC5EC\uBD80 \uD655\uC778
+   - src/ \uB610\uB294 lib/ \uB4F1 \uAE30\uC874 \uCF54\uB4DC \uC874\uC7AC \uC5EC\uBD80 \uD655\uC778 (\uBE0C\uB77C\uC6B4\uD544\uB4DC \uD310\uBCC4)
    - .git/ \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC \uC5EC\uBD80 \uD655\uC778
    - .git/hooks/ \uB514\uB809\uD1A0\uB9AC\uC758 SDD \uD6C5 \uC124\uCE58 \uC5EC\uBD80 \uD655\uC778
    - .github/workflows/ \uB514\uB809\uD1A0\uB9AC\uC758 SDD \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC874\uC7AC \uC5EC\uBD80 \uD655\uC778
 
 2. \uBD84\uC11D \uACB0\uACFC\uC5D0 \uB530\uB77C \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC548\uB0B4\uD558\uC138\uC694:
    - SDD \uBBF8\uCD08\uAE30\uD654: \`sdd init\` \uC2E4\uD589 \uAD8C\uC7A5
+   - **\uAE30\uC874 \uCF54\uB4DC\uAC00 \uC788\uACE0 \uC2A4\uD399\uC774 \uC5C6\uC74C (\uBE0C\uB77C\uC6B4\uD544\uB4DC)**: \`/sdd.reverse\` \uC2E4\uD589 \uAD8C\uC7A5
+   - \uC2A4\uD399 \uC5C6\uC74C (\uADF8\uB9B0\uD544\uB4DC): \`/sdd.new\` \uC2E4\uD589 \uAD8C\uC7A5
    - Git Hooks \uBBF8\uC124\uCE58: Git \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC124\uC815 \uAD8C\uC7A5
    - CI/CD \uBBF8\uC124\uC815: GitHub Actions \uC124\uC815 \uAD8C\uC7A5
 
@@ -1696,7 +1700,23 @@ sdd start --workflow validate
 \uD504\uB85C\uC81D\uD2B8\uAC00 \uCD08\uAE30\uD654\uB418\uC9C0 \uC54A\uC740 \uACBD\uC6B0:
 1. \`sdd init\`\uC73C\uB85C \uD504\uB85C\uC81D\uD2B8\uB97C \uCD08\uAE30\uD654\uD558\uC138\uC694 (Git/CI-CD \uC124\uC815 \uD3EC\uD568)
 2. \`/sdd.constitution\`\uC73C\uB85C \uD504\uB85C\uC81D\uD2B8 \uC6D0\uCE59\uC744 \uC815\uC758\uD558\uC138\uC694
-3. \`/sdd.new\`\uB85C \uCCAB \uAE30\uB2A5 \uBA85\uC138\uB97C \uC791\uC131\uD558\uC138\uC694
+3. \uB2E4\uC74C \uB2E8\uACC4 \uC120\uD0DD:
+   - **\uADF8\uB9B0\uD544\uB4DC** (\uC0C8 \uD504\uB85C\uC81D\uD2B8): \`/sdd.new\`\uB85C \uCCAB \uAE30\uB2A5 \uBA85\uC138\uB97C \uC791\uC131\uD558\uC138\uC694
+   - **\uBE0C\uB77C\uC6B4\uD544\uB4DC** (\uAE30\uC874 \uCF54\uB4DC): \`/sdd.reverse\`\uB85C \uAE30\uC874 \uCF54\uB4DC\uC5D0\uC11C \uC2A4\uD399\uC744 \uCD94\uCD9C\uD558\uC138\uC694
+
+## \uBE0C\uB77C\uC6B4\uD544\uB4DC \uD504\uB85C\uC81D\uD2B8 (\uAE30\uC874 \uCF54\uB4DC\uBCA0\uC774\uC2A4)
+
+\uAE30\uC874 \uCF54\uB4DC\uAC00 \uC788\uB294 \uD504\uB85C\uC81D\uD2B8\uC5D0\uC11C SDD\uB97C \uB3C4\uC785\uD560 \uB54C:
+
+1. **\uC2A4\uD399 \uC5ED\uCD94\uCD9C**: \`/sdd.reverse scan\`\uC73C\uB85C \uD504\uB85C\uC81D\uD2B8 \uAD6C\uC870 \uBD84\uC11D
+2. **\uC2A4\uD399 \uCD94\uCD9C**: \`/sdd.reverse extract\`\uB85C \uCF54\uB4DC\uC5D0\uC11C \uC2A4\uD399 \uCD08\uC548 \uC0DD\uC131
+3. **\uB9AC\uBDF0 \uBC0F \uD655\uC815**: \`/sdd.reverse review\` \u2192 \`/sdd.reverse finalize\`
+4. \uC774\uD6C4 \uC0C8 \uAE30\uB2A5\uC740 \`/sdd.new\`\uB85C \uC791\uC131
+
+**\uBE0C\uB77C\uC6B4\uD544\uB4DC \uD310\uBCC4 \uAE30\uC900**:
+- src/, lib/, app/ \uB4F1 \uC18C\uC2A4 \uB514\uB809\uD1A0\uB9AC\uAC00 \uC874\uC7AC
+- .sdd/specs/ \uC5D0 \uC2A4\uD399 \uD30C\uC77C\uC774 \uC5C6\uAC70\uB098 \uC801\uC74C
+- package.json, requirements.txt \uB4F1 \uD504\uB85C\uC81D\uD2B8 \uC124\uC815 \uD30C\uC77C \uC874\uC7AC
 
 ## Git \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC0C1\uC138
 
@@ -2549,75 +2569,121 @@ var reverseCommand = {
 \uAE30\uC874 \uCF54\uB4DC\uB97C \uBD84\uC11D\uD558\uC5EC SDD \uC2A4\uD399 \uCD08\uC548\uC744 \uC790\uB3D9 \uC0DD\uC131\uD569\uB2C8\uB2E4.
 \uB9AC\uBDF0\uC640 \uC2B9\uC778 \uACFC\uC815\uC744 \uD1B5\uD574 \uC815\uC2DD \uC2A4\uD399\uC73C\uB85C \uD655\uC815\uD569\uB2C8\uB2E4.
 
+## \uC911\uC694 \uC9C0\uC2DC\uC0AC\uD56D
+
+**\uBC18\uB4DC\uC2DC CLI \uBA85\uB839\uC5B4\uB97C \uC0AC\uC6A9\uD558\uC138\uC694!**
+- \uC2A4\uD399 \uD30C\uC77C\uC744 \uC9C1\uC811 \uC791\uC131\uD558\uC9C0 \uB9C8\uC138\uC694
+- \`sdd reverse <subcommand>\` CLI\uB97C \uC2E4\uD589\uD558\uC138\uC694
+- \uCD08\uC548\uC740 \`.sdd/.reverse-drafts/\`\uC5D0 \uC800\uC7A5\uB429\uB2C8\uB2E4 (\uC9C1\uC811 \uAC74\uB4DC\uB9AC\uC9C0 \uB9C8\uC138\uC694)
+- \`.sdd/specs/\`\uC5D0\uB294 finalize \uD6C4\uC5D0\uB9CC \uD30C\uC77C\uC774 \uC0DD\uC131\uB429\uB2C8\uB2E4
+
 ## \uD558\uC704 \uBA85\uB839\uC5B4
 
 \`\`\`
-/sdd.reverse scan [path]         # \uD504\uB85C\uC81D\uD2B8 \uAD6C\uC870 \uC2A4\uCE94
-/sdd.reverse extract [path]      # \uCF54\uB4DC\uC5D0\uC11C \uC2A4\uD399 \uCD94\uCD9C
-/sdd.reverse review [spec-id]    # \uCD94\uCD9C\uB41C \uC2A4\uD399 \uB9AC\uBDF0
-/sdd.reverse finalize [spec-id]  # \uC2B9\uC778\uB41C \uC2A4\uD399 \uD655\uC815
+/sdd.reverse scan [path]         # \uD504\uB85C\uC81D\uD2B8 \uAD6C\uC870 \uC2A4\uCE94 (CLI \uC2E4\uD589)
+/sdd.reverse extract [path]      # \uCF54\uB4DC\uC5D0\uC11C \uC2A4\uD399 \uCD94\uCD9C (CLI \uC2E4\uD589)
+/sdd.reverse review [spec-id]    # \uCD94\uCD9C\uB41C \uC2A4\uD399 \uB9AC\uBDF0 (CLI \uC2E4\uD589)
+/sdd.reverse finalize [spec-id]  # \uC2B9\uC778\uB41C \uC2A4\uD399 \uD655\uC815 (CLI \uC2E4\uD589)
 \`\`\`
 
 ## \uC6CC\uD06C\uD50C\uB85C\uC6B0
 
 \`\`\`
-scan \u2192 extract \u2192 review \u2192 finalize
+scan (+ \uB3C4\uBA54\uC778 \uC790\uB3D9 \uC0DD\uC131) \u2192 extract \u2192 review \u2192 finalize
 \`\`\`
 
-### 1. Scan (\uC2A4\uCE94)
+**\uAC01 \uB2E8\uACC4\uB294 \uC21C\uCC28\uC801\uC73C\uB85C \uC9C4\uD589\uD569\uB2C8\uB2E4. \uC774\uC804 \uB2E8\uACC4\uB97C \uAC74\uB108\uB6F0\uC9C0 \uB9C8\uC138\uC694!**
+
+### 1. Scan (\uC2A4\uCE94 + \uB3C4\uBA54\uC778 \uC0DD\uC131)
 
-\uD504\uB85C\uC81D\uD2B8\uB97C \uBD84\uC11D\uD558\uC5EC \uB514\uB809\uD1A0\uB9AC \uAD6C\uC870, \uC5B8\uC5B4 \uBD84\uD3EC, \uB3C4\uBA54\uC778\uC744 \uCD94\uC815\uD569\uB2C8\uB2E4.
+**Claude \uC9C0\uC2DC:** \`sdd reverse scan\` CLI \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD558\uC138\uC694.
 
 \`\`\`bash
-sdd reverse scan
-sdd reverse scan src/
+sdd reverse scan                    # \uC2A4\uCE94 + \uB3C4\uBA54\uC778 \uC790\uB3D9 \uC0DD\uC131
+sdd reverse scan src/               # \uD2B9\uC815 \uACBD\uB85C \uC2A4\uCE94
+sdd reverse scan --no-create-domains  # \uB3C4\uBA54\uC778 \uC0DD\uC131 \uC5C6\uC774 \uC2A4\uCE94\uB9CC
 \`\`\`
 
+**\uC218\uD589 \uC791\uC5C5:**
+- \uD504\uB85C\uC81D\uD2B8 \uAD6C\uC870 \uBD84\uC11D (src/, lib/, packages/ \uB4F1)
+- \uC5B8\uC5B4 \uBD84\uD3EC \uD655\uC778
+- \uB3C4\uBA54\uC778 \uC790\uB3D9 \uC0DD\uC131 (.sdd/domains.yml\uC5D0 \uCD94\uAC00)
+- \uC2A4\uCE94 \uBA54\uD0C0\uB370\uC774\uD130 \uC800\uC7A5 (.sdd/.reverse-meta.json)
+
+**\uC644\uB8CC \uD6C4 \uC548\uB0B4:** "\uC2A4\uCE94\uC774 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \`/sdd.reverse extract\`\uB85C \uCF54\uB4DC\uC5D0\uC11C \uC2A4\uD399\uC744 \uCD94\uCD9C\uD558\uC138\uC694."
+
 ### 2. Extract (\uCD94\uCD9C)
 
-\uC2A4\uCE94 \uACB0\uACFC\uB97C \uAE30\uBC18\uC73C\uB85C \uCF54\uB4DC\uC5D0\uC11C \uC2A4\uD399 \uCD08\uC548\uC744 \uCD94\uCD9C\uD569\uB2C8\uB2E4.
+**Claude \uC9C0\uC2DC:** \`sdd reverse extract\` CLI \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD558\uC138\uC694.
+**\uC8FC\uC758:** \uC2A4\uD399 \uD30C\uC77C\uC744 \uC9C1\uC811 \uC791\uC131\uD558\uC9C0 \uB9C8\uC138\uC694! CLI\uAC00 \`.sdd/.reverse-drafts/\`\uC5D0 \uCD08\uC548\uC744 \uC0DD\uC131\uD569\uB2C8\uB2E4.
 
 \`\`\`bash
-sdd reverse extract
-sdd reverse extract --domain auth
-sdd reverse extract --depth deep
+sdd reverse extract                 # \uC804\uCCB4 \uCD94\uCD9C
+sdd reverse extract --domain auth   # \uD2B9\uC815 \uB3C4\uBA54\uC778\uB9CC
+sdd reverse extract --depth deep    # \uAE4A\uC740 \uBD84\uC11D
 \`\`\`
 
-**\uC635\uC158:**
-- \`--domain <name>\`: \uD2B9\uC815 \uB3C4\uBA54\uC778\uB9CC \uCD94\uCD9C
-- \`--depth <level>\`: \uBD84\uC11D \uAE4A\uC774 (shallow, medium, deep)
-- \`--min-confidence <n>\`: \uCD5C\uC18C \uC2E0\uB8B0\uB3C4 \uD544\uD130
+**\uC218\uD589 \uC791\uC5C5:**
+- \uCF54\uB4DC \uC2EC\uBCFC \uBD84\uC11D
+- \uC2A4\uD399 \uCD08\uC548 \uC0DD\uC131 \u2192 \`.sdd/.reverse-drafts/<domain>/<name>.json\`
+- \uC0C1\uD0DC: \`pending\` (\uC544\uC9C1 \uC2B9\uC778\uB418\uC9C0 \uC54A\uC74C)
+
+**\uC644\uB8CC \uD6C4 \uC548\uB0B4:** "\uCD94\uCD9C\uC774 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \`/sdd.reverse review\`\uB85C \uC2A4\uD399\uC744 \uB9AC\uBDF0\uD558\uC138\uC694."
 
 ### 3. Review (\uB9AC\uBDF0)
 
-\uCD94\uCD9C\uB41C \uC2A4\uD399 \uCD08\uC548\uC744 \uB9AC\uBDF0\uD558\uACE0 \uC2B9\uC778/\uAC70\uBD80\uD569\uB2C8\uB2E4.
+**Claude \uC9C0\uC2DC:** \`sdd reverse review\` CLI \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD558\uC138\uC694.
 
 \`\`\`bash
-sdd reverse review              # \uB9AC\uBDF0 \uB300\uAE30 \uBAA9\uB85D
-sdd reverse review auth/login   # \uD2B9\uC815 \uC2A4\uD399 \uC0C1\uC138
+sdd reverse review                      # \uB9AC\uBDF0 \uB300\uAE30 \uBAA9\uB85D \uD655\uC778
+sdd reverse review auth/login           # \uD2B9\uC815 \uC2A4\uD399 \uC0C1\uC138 \uBCF4\uAE30
+sdd reverse review auth/login --approve # \uC2A4\uD399 \uC2B9\uC778
+sdd reverse review auth/login --reject  # \uC2A4\uD399 \uAC70\uBD80
 \`\`\`
 
+**\uC218\uD589 \uC791\uC5C5:**
+- \uCD94\uCD9C\uB41C \uCD08\uC548 \uAC80\uD1A0
+- \`--approve\`\uB85C \uC2B9\uC778, \`--reject\`\uB85C \uAC70\uBD80
+
+**\uC644\uB8CC \uD6C4 \uC548\uB0B4:** "\uB9AC\uBDF0\uAC00 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \`/sdd.reverse finalize\`\uB85C \uC2B9\uC778\uB41C \uC2A4\uD399\uC744 \uD655\uC815\uD558\uC138\uC694."
+
 ### 4. Finalize (\uD655\uC815)
 
-\uC2B9\uC778\uB41C \uC2A4\uD399\uC744 \uC815\uC2DD SDD \uC2A4\uD399\uC73C\uB85C \uBCC0\uD658\uD569\uB2C8\uB2E4.
+**Claude \uC9C0\uC2DC:** \`sdd reverse finalize\` CLI \uBA85\uB839\uC5B4\uB97C \uC2E4\uD589\uD558\uC138\uC694.
+**\uC8FC\uC758:** finalize \uD6C4\uC5D0\uB9CC \`.sdd/specs/\`\uC5D0 \uC2A4\uD399\uC774 \uC0DD\uC131\uB429\uB2C8\uB2E4!
 
 \`\`\`bash
-sdd reverse finalize --all      # \uBAA8\uB4E0 \uC2B9\uC778 \uC2A4\uD399 \uD655\uC815
-sdd reverse finalize auth/login # \uD2B9\uC815 \uC2A4\uD399 \uD655\uC815
+sdd reverse finalize --all        # \uBAA8\uB4E0 \uC2B9\uC778 \uC2A4\uD399 \uD655\uC815
+sdd reverse finalize auth/login   # \uD2B9\uC815 \uC2A4\uD399 \uD655\uC815
+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
+- \uCD08\uC548 \uD30C\uC77C \uC0AD\uC81C
+
+**\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
 
-| \uD30C\uC77C | \uC124\uBA85 |
-|------|------|
-| \`.sdd/.reverse-meta.json\` | \uC2A4\uCE94 \uACB0\uACFC \uBA54\uD0C0\uB370\uC774\uD130 |
-| \`.sdd/.reverse-drafts/\` | \uC2A4\uD399 \uCD08\uC548 \uB514\uB809\uD1A0\uB9AC |
-| \`.sdd/specs/\` | \uD655\uC815\uB41C \uC2A4\uD399 \uB514\uB809\uD1A0\uB9AC |
+**\uC8FC\uC758:** CLI\uAC00 \uC0DD\uC131\uD558\uB294 \uD30C\uC77C \uD615\uC2DD\uC744 \uC815\uD655\uD788 \uB530\uB974\uC138\uC694!
+
+| \uD30C\uC77C | \uC124\uBA85 | \uC0DD\uC131 \uC2DC\uC810 |
+|------|------|----------|
+| \`.sdd/domains.yml\` | \uB3C4\uBA54\uC778 \uC124\uC815 (YAML \uD615\uC2DD, JSON \uC544\uB2D8!) | scan |
+| \`.sdd/domains/<domain>/domain.md\` | \uB3C4\uBA54\uC778\uBCC4 \uBB38\uC11C | scan |
+| \`.sdd/.reverse-meta.json\` | \uC2A4\uCE94/\uCD94\uCD9C \uBA54\uD0C0\uB370\uC774\uD130 | scan, extract |
+| \`.sdd/.reverse-drafts/\` | \uC2A4\uD399 \uCD08\uC548 \uB514\uB809\uD1A0\uB9AC | extract |
+| \`.sdd/specs/<feature-id>/spec.md\` | \uD655\uC815\uB41C \uC2A4\uD399 | finalize |
+
+**\uD30C\uC77C\uC744 \uC9C1\uC811 \uC0DD\uC131\uD558\uC9C0 \uB9C8\uC138\uC694!** \uBAA8\uB4E0 \uD30C\uC77C\uC740 CLI \uBA85\uB839\uC5B4\uB85C \uC0DD\uC131\uB429\uB2C8\uB2E4.
 
 ## \uB2E4\uC74C \uB2E8\uACC4
 
 - \uD655\uC815 \uD6C4: \`/sdd.validate\`\uB85C \uC2A4\uD399 \uAC80\uC99D
-- \uB3C4\uBA54\uC778 \uC815\uB9AC: \`/sdd.domain\`\uC73C\uB85C \uB3C4\uBA54\uC778 \uAD6C\uC870\uD654
+- \uB3C4\uBA54\uC778 \uC218\uC815: \`/sdd.domain\`\uC73C\uB85C \uB3C4\uBA54\uC778 \uC0C1\uC138 \uC870\uC815 (\uC774\uB984 \uBCC0\uACBD, \uC758\uC874\uC131 \uCD94\uAC00 \uB4F1)
+- \uC0C8 \uAE30\uB2A5: \`/sdd.new\`\uB85C \uC0C8 \uC2A4\uD399 \uC791\uC131
 `
 };
 
@@ -21392,6 +21458,68 @@ async function loadReviewList(sddPath) {
     return failure(new Error(`\uB9AC\uBDF0 \uBAA9\uB85D \uB85C\uB4DC \uC2E4\uD328: ${error2}`));
   }
 }
+async function approveSpec(sddPath, specId, comment) {
+  const loadResult = await loadReviewList(sddPath);
+  if (!loadResult.success) {
+    return failure(loadResult.error);
+  }
+  const item = loadResult.data.find((i) => i.specId === specId);
+  if (!item) {
+    return failure(new Error(`\uC2A4\uD399\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${specId}`));
+  }
+  item.status = "approved";
+  item.spec.metadata.status = "approved";
+  item.reviewedAt = /* @__PURE__ */ new Date();
+  if (comment) {
+    item.comments.push({
+      type: "info",
+      message: comment,
+      createdAt: /* @__PURE__ */ new Date()
+    });
+  }
+  const saveResult = await saveReviewItem(sddPath, item);
+  if (!saveResult.success) {
+    return failure(saveResult.error);
+  }
+  return success(item);
+}
+async function rejectSpec(sddPath, specId, reason) {
+  const loadResult = await loadReviewList(sddPath);
+  if (!loadResult.success) {
+    return failure(loadResult.error);
+  }
+  const item = loadResult.data.find((i) => i.specId === specId);
+  if (!item) {
+    return failure(new Error(`\uC2A4\uD399\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${specId}`));
+  }
+  item.status = "rejected";
+  item.spec.metadata.status = "rejected";
+  item.reviewedAt = /* @__PURE__ */ new Date();
+  item.comments.push({
+    type: "error",
+    message: reason,
+    createdAt: /* @__PURE__ */ new Date()
+  });
+  const saveResult = await saveReviewItem(sddPath, item);
+  if (!saveResult.success) {
+    return failure(saveResult.error);
+  }
+  return success(item);
+}
+async function saveReviewItem(sddPath, item) {
+  const [domain, name] = item.specId.split("/");
+  const specDir = path51.join(sddPath, ".reverse-drafts", domain);
+  try {
+    await ensureDir(specDir);
+    const jsonPath = path51.join(specDir, `${name}.json`);
+    await fs33.writeFile(jsonPath, formatSpecAsJson(item.spec), "utf-8");
+    const mdPath = path51.join(specDir, `${name}.md`);
+    await fs33.writeFile(mdPath, formatSpecAsMarkdown(item.spec), "utf-8");
+    return success(void 0);
+  } catch (error2) {
+    return failure(new Error(`\uB9AC\uBDF0 \uD56D\uBAA9 \uC800\uC7A5 \uC2E4\uD328: ${error2}`));
+  }
+}
 function calculateReviewSummary(items) {
   return {
     total: items.length,
@@ -22559,6 +22687,38 @@ async function handleScan(targetPath, options) {
       error(`\uACB0\uACFC \uC800\uC7A5 \uC2E4\uD328: ${error2}`);
     }
   }
+  const shouldCreateDomains = options.createDomains !== false;
+  if (shouldCreateDomains && result.summary.suggestedDomains.length > 0) {
+    const domainService = createDomainService(sddRoot);
+    const existingDomainsResult = await domainService.list();
+    const existingDomainIds = existingDomainsResult.success ? existingDomainsResult.data.map((d) => d.id) : [];
+    let createdCount = 0;
+    let skippedCount = 0;
+    for (const suggested of result.summary.suggestedDomains) {
+      if (existingDomainIds.includes(suggested.name)) {
+        skippedCount++;
+        continue;
+      }
+      const createResult = await domainService.create(suggested.name, {
+        description: `${suggested.name} \uB3C4\uBA54\uC778 (reverse scan\uC73C\uB85C \uC790\uB3D9 \uC0DD\uC131)`,
+        path: suggested.path
+      });
+      if (createResult.success) {
+        createdCount++;
+      }
+    }
+    if (!options.quiet && (createdCount > 0 || skippedCount > 0)) {
+      console.log("");
+      console.log(chalk10.bold("\u{1F4C1} \uB3C4\uBA54\uC778 \uC790\uB3D9 \uC0DD\uC131:"));
+      if (createdCount > 0) {
+        console.log(chalk10.green(`   \u2705 ${createdCount}\uAC1C \uB3C4\uBA54\uC778 \uC0DD\uC131\uB428`));
+      }
+      if (skippedCount > 0) {
+        console.log(chalk10.dim(`   \u23ED\uFE0F  ${skippedCount}\uAC1C \uB3C4\uBA54\uC778 \uC774\uBBF8 \uC874\uC7AC (\uAC74\uB108\uB700)`));
+      }
+      console.log("");
+    }
+  }
   if (!options.skipSerenaCheck) {
     const serenaCheck = await ensureSerenaAvailable("scan", { skipSerenaCheck: true, quiet: true });
     if (!serenaCheck.success && !options.quiet) {
@@ -22566,6 +22726,11 @@ async function handleScan(targetPath, options) {
       console.log(chalk10.dim("   docs/guide/serena-setup.md \uCC38\uC870\n"));
     }
   }
+  if (!options.quiet && !options.json) {
+    console.log(chalk10.bold("\u{1F4A1} \uB2E4\uC74C \uB2E8\uACC4:"));
+    console.log("   sdd reverse extract    # \uCF54\uB4DC\uC5D0\uC11C \uC2A4\uD399 \uCD94\uCD9C");
+    console.log("");
+  }
 }
 async function handleExtract(targetPath, options) {
   const sddRoot = await findSddRoot();
@@ -22670,6 +22835,29 @@ async function handleReview(specId, options) {
       error(`\uC2A4\uD399\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${specId}`);
       process.exit(ExitCode.GENERAL_ERROR);
     }
+    if (options.approve) {
+      const result = await approveSpec(sddPath, item.specId);
+      if (result.success) {
+        success2(`\uC2B9\uC778\uB428: ${item.specId}`);
+        console.log("");
+        console.log(chalk10.bold("\u{1F4A1} \uB2E4\uC74C \uB2E8\uACC4:"));
+        console.log("   sdd reverse finalize --all    # \uC2B9\uC778\uB41C \uC2A4\uD399 \uD655\uC815");
+      } else {
+        error(result.error.message);
+        process.exit(ExitCode.GENERAL_ERROR);
+      }
+      return;
+    }
+    if (options.reject) {
+      const result = await rejectSpec(sddPath, item.specId);
+      if (result.success) {
+        success2(`\uAC70\uBD80\uB428: ${item.specId}`);
+      } else {
+        error(result.error.message);
+        process.exit(ExitCode.GENERAL_ERROR);
+      }
+      return;
+    }
     console.log(formatSpecDetail(item));
     console.log(chalk10.bold("\u{1F4A1} \uC791\uC5C5:"));
     console.log(`   sdd reverse review ${specId} --approve    # \uC2B9\uC778`);
@@ -22791,9 +22979,9 @@ function registerReverseCommand(program2) {
       showReverseHelp();
     }
   });
-  reverse.command("scan [path]").description("\uD504\uB85C\uC81D\uD2B8 \uAD6C\uC870 \uC2A4\uCE94").option("-d, --depth <n>", "\uBD84\uC11D \uAE4A\uC774", parseInt).option("-i, --include <pattern>", "\uD3EC\uD568 \uD328\uD134 (glob)").option("-e, --exclude <pattern>", "\uC81C\uC678 \uD328\uD134 (glob)").option("-l, --language <lang>", "\uD2B9\uC815 \uC5B8\uC5B4\uB9CC").option("-o, --output <file>", "\uACB0\uACFC \uC800\uC7A5 \uD30C\uC77C").option("-q, --quiet", "\uC870\uC6A9\uD55C \uBAA8\uB4DC").option("--skip-serena-check", "Serena \uCCB4\uD06C \uAC74\uB108\uB6F0\uAE30 (\uAC1C\uBC1C\uC6A9)").action(handleScan);
+  reverse.command("scan [path]").description("\uD504\uB85C\uC81D\uD2B8 \uAD6C\uC870 \uC2A4\uCE94 \uBC0F \uB3C4\uBA54\uC778 \uC790\uB3D9 \uC0DD\uC131").option("-d, --depth <n>", "\uBD84\uC11D \uAE4A\uC774", parseInt).option("-i, --include <pattern>", "\uD3EC\uD568 \uD328\uD134 (glob)").option("-e, --exclude <pattern>", "\uC81C\uC678 \uD328\uD134 (glob)").option("-l, --language <lang>", "\uD2B9\uC815 \uC5B8\uC5B4\uB9CC").option("-o, --output <file>", "\uACB0\uACFC \uC800\uC7A5 \uD30C\uC77C").option("-q, --quiet", "\uC870\uC6A9\uD55C \uBAA8\uB4DC").option("--json", "JSON \uD615\uC2DD \uCD9C\uB825").option("--compare", "\uC774\uC804 \uC2A4\uCE94\uACFC \uBE44\uAD50").option("--no-create-domains", "\uB3C4\uBA54\uC778 \uC790\uB3D9 \uC0DD\uC131 \uBE44\uD65C\uC131\uD654").option("--skip-serena-check", "Serena \uCCB4\uD06C \uAC74\uB108\uB6F0\uAE30 (\uAC1C\uBC1C\uC6A9)").action(handleScan);
   reverse.command("extract [path]").description("\uCF54\uB4DC\uC5D0\uC11C \uC2A4\uD399 \uCD94\uCD9C").option("--depth <level>", "\uCD94\uCD9C \uAE4A\uC774: shallow, medium, deep", "medium").option("--ai", "AI \uAE30\uBC18 \uC758\uB3C4 \uCD94\uB860 \uD65C\uC131\uD654").option("-d, --domain <name>", "\uB3C4\uBA54\uC778 \uC9C0\uC815").option("-o, --output <dir>", "\uCD9C\uB825 \uB514\uB809\uD1A0\uB9AC").option("-q, --quiet", "\uC870\uC6A9\uD55C \uBAA8\uB4DC").option("--skip-serena-check", "Serena \uCCB4\uD06C \uAC74\uB108\uB6F0\uAE30 (\uAC1C\uBC1C\uC6A9)").action(handleExtract);
-  reverse.command("review [spec]").description("\uCD94\uCD9C\uB41C \uC2A4\uD399 \uB9AC\uBDF0").option("-a, --all", "\uBAA8\uB4E0 \uC2A4\uD399 \uB9AC\uBDF0").option("-q, --quiet", "\uC870\uC6A9\uD55C \uBAA8\uB4DC").action(handleReview);
+  reverse.command("review [spec]").description("\uCD94\uCD9C\uB41C \uC2A4\uD399 \uB9AC\uBDF0").option("-a, --all", "\uBAA8\uB4E0 \uC2A4\uD399 \uB9AC\uBDF0").option("--approve", "\uC2A4\uD399 \uC2B9\uC778").option("--reject", "\uC2A4\uD399 \uAC70\uBD80").option("-q, --quiet", "\uC870\uC6A9\uD55C \uBAA8\uB4DC").action(handleReview);
   reverse.command("finalize [spec]").description("\uC2B9\uC778\uB41C \uC2A4\uD399 \uC815\uC2DD \uBCC0\uD658").option("-a, --all", "\uBAA8\uB4E0 \uC2B9\uC778 \uC2A4\uD399 \uD655\uC815").option("-d, --domain <name>", "\uD2B9\uC815 \uB3C4\uBA54\uC778 \uD655\uC815").option("-q, --quiet", "\uC870\uC6A9\uD55C \uBAA8\uB4DC").action(handleFinalize);
 }