테마
SDD 시스템 전체 구조
세 가지 핵심 구성 요소
SDD 시스템은 Skill, SubAgent, Command 세 가지 구성 요소로 이루어진다. 각각의 역할을 비유로 이해해보자.
| 구성 요소 | 비유 | 역할 |
|---|---|---|
| Skill | 문서 양식 | "이 형식대로 쓰세요" — PRD, Tech Spec 등의 템플릿 |
| SubAgent | 전문가/담당자 | "이 양식을 쓸 줄 아는 사람" — 10년차 PM, 시니어 개발자 |
| Command | 트리거 버튼 | "이 버튼을 누르면 시작" — Plan, Build 같은 명령어 |
실행 체인: Command → Agent → Skill
사용자가 커맨드를 입력하면, 정해진 순서로 실행된다.
이 체인이 SDD의 기본 동작 단위다. Command가 Agent를 호출하고, Agent가 Skill을 사용해서 결과물을 생성한다.
SDD 파이프라인: 5단계 워크플로우
전체 SDD 워크플로우는 다섯 단계로 구성된다. 각 단계에는 전제 조건이 있어서 순서를 건너뛸 수 없다.
각 단계 상세
| 단계 | 커맨드 | 에이전트 | 스킬 | 전제 조건 | 출력물 |
|---|---|---|---|---|---|
| Init | sdd.init | — | — | 없음 | 폴더 구조, 빈 문서 |
| Plan | sdd.plan | Planner | PRDWriter | 없음 | PRD.md |
| Design | sdd.design | Architect | TechSpecWriter | PRD 필요 | TechSpec.md |
| Build | sdd.build | Developer | CodeGenerator | PRD + Spec 필요 | 소스 코드 |
| Review | sdd.review | Reviewer | SpecValidator | 모든 문서 필요 | 검증 리포트 |
전제 조건 강제의 의미
이 전제 조건 체계가 SDD의 핵심이다. Design 단계에서 PRD가 없으면 자동으로 Plan 단계부터 시작하도록 유도한다. Build 단계에서 PRD나 Spec이 없으면 진행되지 않는다.
이렇게 하면 문서 없이 코드를 만드는 상황을 시스템적으로 방지할 수 있다. 스펙이 먼저 존재해야만 코드가 생성되는 구조가 자동으로 보장된다.
강의에서 만드는 것들
이 SDD 시스템을 구축하면 최종적으로 아래 구성 요소를 갖게 된다.
이 세 가지가 조합되면 자동화된 개발 파이프라인이 완성된다.