sdd-tool 0.7.2 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +64 -4
- package/dist/cli/index.js +2912 -31
- package/dist/cli/index.js.map +1 -1
- package/dist/index.d.ts +2 -0
- package/dist/index.js +3 -1
- package/dist/index.js.map +1 -1
- package/package.json +9 -4
package/README.md
CHANGED
|
@@ -3,10 +3,13 @@
|
|
|
3
3
|
**Spec-Driven Development CLI** - AI와 함께하는 명세 기반 개발 도구
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/sdd-tool)
|
|
6
|
+
[](https://github.com/JakeB-5/sdd-tool/actions/workflows/ci.yml)
|
|
6
7
|
[](https://nodejs.org/)
|
|
7
8
|
[](https://www.typescriptlang.org/)
|
|
8
9
|
[](LICENSE)
|
|
9
10
|
|
|
11
|
+
📚 **[문서 사이트](https://jakeb-5.github.io/sdd-tool/)** | 🚀 **[시작하기](https://jakeb-5.github.io/sdd-tool/guide/getting-started)** | 📋 **[CLI 레퍼런스](https://jakeb-5.github.io/sdd-tool/cli/)**
|
|
12
|
+
|
|
10
13
|
## 개요
|
|
11
14
|
|
|
12
15
|
SDD Tool은 **Claude Code**와 함께 사용하도록 설계된 명세 기반 개발(Spec-Driven Development) CLI입니다. **슬래시 커맨드**를 통해 AI와 대화하며 명세를 작성하고, 코드를 구현합니다.
|
|
@@ -32,7 +35,7 @@ npm install -g sdd-tool
|
|
|
32
35
|
## 빠른 시작
|
|
33
36
|
|
|
34
37
|
```bash
|
|
35
|
-
# 1. 프로젝트 초기화 (슬래시 커맨드
|
|
38
|
+
# 1. 프로젝트 초기화 (슬래시 커맨드 29개 자동 생성)
|
|
36
39
|
sdd init
|
|
37
40
|
|
|
38
41
|
# 2. Claude Code 실행
|
|
@@ -79,7 +82,7 @@ claude
|
|
|
79
82
|
|
|
80
83
|
---
|
|
81
84
|
|
|
82
|
-
## 슬래시 커맨드 (
|
|
85
|
+
## 슬래시 커맨드 (29개)
|
|
83
86
|
|
|
84
87
|
`sdd init` 실행 시 `.claude/commands/`에 자동 생성됩니다.
|
|
85
88
|
|
|
@@ -114,6 +117,9 @@ claude
|
|
|
114
117
|
| `/sdd.search` | 스펙 검색 |
|
|
115
118
|
| `/sdd.status` | 프로젝트 상태 확인 |
|
|
116
119
|
| `/sdd.list` | 항목 목록 조회 |
|
|
120
|
+
| `/sdd.sync` | 스펙-코드 동기화 검증 |
|
|
121
|
+
| `/sdd.diff` | 스펙 변경사항 시각화 |
|
|
122
|
+
| `/sdd.export` | 스펙 내보내기 (HTML, JSON) |
|
|
117
123
|
|
|
118
124
|
### 문서 생성
|
|
119
125
|
|
|
@@ -358,6 +364,34 @@ sdd report # 리포트 생성
|
|
|
358
364
|
sdd search <query> # 스펙 검색
|
|
359
365
|
```
|
|
360
366
|
|
|
367
|
+
### 동기화 및 변경 추적 (v0.8.0)
|
|
368
|
+
|
|
369
|
+
```bash
|
|
370
|
+
sdd sync # 스펙-코드 동기화 검증
|
|
371
|
+
sdd sync user-auth # 특정 스펙만 검증
|
|
372
|
+
sdd sync --ci --threshold 80 # CI 모드 (동기화율 임계값)
|
|
373
|
+
sdd sync --json # JSON 출력
|
|
374
|
+
sdd sync --markdown # 마크다운 리포트
|
|
375
|
+
|
|
376
|
+
sdd diff # 스펙 변경사항 (작업 디렉토리)
|
|
377
|
+
sdd diff --staged # 스테이징된 변경
|
|
378
|
+
sdd diff abc123 def456 # 커밋 간 비교
|
|
379
|
+
sdd diff --stat # 통계 요약
|
|
380
|
+
sdd diff --json # JSON 출력
|
|
381
|
+
```
|
|
382
|
+
|
|
383
|
+
### 스펙 내보내기 (v0.9.0)
|
|
384
|
+
|
|
385
|
+
```bash
|
|
386
|
+
sdd export user-auth # 단일 스펙 HTML 내보내기
|
|
387
|
+
sdd export --all # 전체 스펙 내보내기
|
|
388
|
+
sdd export --format json # JSON 형식
|
|
389
|
+
sdd export --format markdown # 마크다운 병합
|
|
390
|
+
sdd export -o ./docs/specs.html # 출력 경로 지정
|
|
391
|
+
sdd export --theme dark # 다크 테마
|
|
392
|
+
sdd export --no-toc # 목차 제외
|
|
393
|
+
```
|
|
394
|
+
|
|
361
395
|
---
|
|
362
396
|
|
|
363
397
|
## Claude Code 도구 구조
|
|
@@ -377,7 +411,7 @@ your-project/
|
|
|
377
411
|
│ └── archive/ # 완료된 변경
|
|
378
412
|
│
|
|
379
413
|
└── .claude/
|
|
380
|
-
├── commands/ # 슬래시 커맨드 (
|
|
414
|
+
├── commands/ # 슬래시 커맨드 (29개)
|
|
381
415
|
│ ├── sdd.start.md
|
|
382
416
|
│ ├── sdd.new.md
|
|
383
417
|
│ ├── sdd.prepare.md
|
|
@@ -404,8 +438,34 @@ pnpm run build
|
|
|
404
438
|
pnpm test
|
|
405
439
|
```
|
|
406
440
|
|
|
441
|
+
### 문서 개발
|
|
442
|
+
|
|
443
|
+
```bash
|
|
444
|
+
pnpm run docs:dev # 개발 서버
|
|
445
|
+
pnpm run docs:build # 빌드
|
|
446
|
+
pnpm run docs:preview # 미리보기
|
|
447
|
+
```
|
|
448
|
+
|
|
449
|
+
### 테스트 커버리지
|
|
450
|
+
|
|
451
|
+
```bash
|
|
452
|
+
pnpm run test:coverage # 커버리지 리포트
|
|
453
|
+
```
|
|
454
|
+
|
|
455
|
+
---
|
|
456
|
+
|
|
457
|
+
## 기여
|
|
458
|
+
|
|
459
|
+
기여를 환영합니다! [CONTRIBUTING.md](CONTRIBUTING.md)를 참고해주세요.
|
|
460
|
+
|
|
461
|
+
---
|
|
462
|
+
|
|
463
|
+
## 변경 이력
|
|
464
|
+
|
|
465
|
+
자세한 변경 이력은 [CHANGELOG.md](CHANGELOG.md)를 참고해주세요.
|
|
466
|
+
|
|
407
467
|
---
|
|
408
468
|
|
|
409
469
|
## 라이선스
|
|
410
470
|
|
|
411
|
-
MIT License
|
|
471
|
+
MIT License - 자세한 내용은 [LICENSE](LICENSE) 파일을 참고해주세요.
|