SDD (Spec-Driven Development) 전체 워크플로우 가이드. 처음 시작할 때, 어떤 커맨드를 써야 할지 모를 때, 전체 흐름을 파악할 때 로드.
SDD(Spec-Driven Development)는 스티어링 → 스펙 → 코드 계층으로 작동한다. 진실의 출처는 항상 상위 계층. 코드는 결과물이지 진실이 아니다.
/sdd:steering — 프로젝트 방향 정의 (Bootstrap 모드)/sdd:spec-plan <설명> — 요구사항 + 설계 + 태스크 자동 생성/sdd:spec-impl <feature> — TDD 구현 (@impl 태그 자동 생성 포함)/sdd:spec-delta <feature> — 변경된 스펙 문장 → 수정 필요한 코드 위치 출력@impl 태그로 스펙 문장과 코드가 1:1 매핑됨@impl은 개발 도구가 아니라 유지보수 도구:
| 단계 | 권장 |
|---|---|
| 처음 개발 | 또는 직접 코딩 → 완성 우선 |
spec-impl| 개발 완료 후 | @impl 태그 추가 → 추적 준비 |
| 요구사항 변경 시 | spec-update → spec-delta → 코드 수정 |
개발 중 @impl 태그 누락은 오류가 아님. 완성 후 한 번 정리하면 됨.
/sdd:spec-auto <설명> — 스펙 생성부터 구현까지 완전 자동화[선택] /sdd:spec-research <feature> — 스펙 전 리서치 (외부 프로토콜/API 있을 때 권장)/sdd:spec-req <feature> — 요구사항만 생성/sdd:spec-design <feature> — 설계만 생성/sdd:spec-tasks <feature> — 태스크만 생성/sdd:spec-status — 전체 진행 상황/sdd:briefing — overnight 작업 후 브리핑/sdd:spec-reset [feature] — 아카이브 및 재시작/sdd:steer-trim — 긴 스티어링 파일 압축| 경로 | 용도 |
|---|---|
.agents/skills/project-steering/references/ | 프로젝트 방향 (product, tech, structure) |
.sdd/specs/<feature>/ | 각 feature의 스펙 파일들 |
.sdd/req-counter.json | 전역 REQ ID 카운터 (스펙 간 고유 ID 보장) |
.agents/skills/ | AI가 lazy-load하는 방법론 파일 |
.sdd/logs/ | 자동화 실행 로그 |
.sdd/archive/ | 리셋된 스펙 아카이브 |
.sdd/briefings/ | 브리핑 문서 |
references/hierarchy.mdreferences/command-reference.md→ references/spec-init.json 참조
현재 설계 한계: spec-delta는 같은 스펙 폴더 내 변경만 감지.
다른 스펙 폴더에 걸친 cross-spec 추적은 지원하지 않음.
권장 워크플로우:
requirements.md 직접 수정 → spec-deltaspec-impl"새 버전 스펙"을 만들어서 기존 요구사항을 재작성하지 않는다. 요구사항은 원본 파일에서 직접 관리한다.