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 CHANGED
@@ -3,10 +3,13 @@
3
3
  **Spec-Driven Development CLI** - AI와 함께하는 명세 기반 개발 도구
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/sdd-tool)](https://www.npmjs.com/package/sdd-tool)
6
+ [![CI](https://github.com/JakeB-5/sdd-tool/actions/workflows/ci.yml/badge.svg)](https://github.com/JakeB-5/sdd-tool/actions/workflows/ci.yml)
6
7
  [![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)
7
8
  [![TypeScript](https://img.shields.io/badge/typescript-5.x-blue)](https://www.typescriptlang.org/)
8
9
  [![License](https://img.shields.io/badge/license-MIT-green)](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. 프로젝트 초기화 (슬래시 커맨드 26개 자동 생성)
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
- ## 슬래시 커맨드 (26개)
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/ # 슬래시 커맨드 (26개)
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) 파일을 참고해주세요.