메뉴
Spec-Driven Development 워크플로우 단계별 실행. /sdd [0-6|status|quick|non-func] [기능명]
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | sdd |
| description | Spec-Driven Development 워크플로우 단계별 실행. /sdd [0-6|status|quick|non-func] [기능명] |
Spec-Driven Development 워크플로우. 일반(Functional) 플로우는 0→6 순회, 소규모·비기능적 변경은 예외 플로우로 단축.
/sdd # 현황 확인 (= /sdd status)
/sdd status # 현재 브랜치/파일 기반 진행 단계 자동 감지
/sdd 0 # TARGET 선택 → README.md 등록
/sdd 1 <기능명> # PRD 작성
/sdd 2 <기능명> # 기능 설계 작성
/sdd 3 <기능명> # Task (역할별)
/sdd 4 <기능명> # Development (역할별)
/sdd 5 <기능명> # 구현 + 테스트
/sdd 6 <기능명> # 자동 검증 + 문서 정리 + PR
/sdd quick <기능명> # 소규모: PRD+FD → 5 → 6 (Task/Dev 생략)
/sdd non-func <기능명> # 비기능적: FD → 5 → 6 (PRD/Task/Dev 생략, FD도 완료 후 삭제)
| 단계 | 입력 | 산출 | 자동 호출 |
|---|---|---|---|
| 0 | README TARGET | 선택 + 상태 등록 | /bs-to-target (브레인스토밍 기원 시 선행) |
| 1 | 사업 문서 | docs/specs/prd/{name}.md | - |
| 2 | PRD | docs/specs/functional-design/{name}.md | - |
| 3 | FD | docs/specs/target/functional/tasks/{name}.md | - |
| 4 | Task | docs/specs/target/functional/development/{name}-{role}.md | - |
| 5 | Dev | 구현 + 테스트 | pnpm typecheck, pnpm test |
| 6 | 구현 완료 | PR | /pre-pr → 자동 검증 → 문서 정리 → /commit → /pr |
docs/specs/README.md TARGET 표 파싱 → 미착수 항목만 추출 (FUNCTIONAL/PERFORMANCE/BUGFIX/DX 각각)docs/business/6_roadmap/roadmap.md, STATUS.md로 우선순위 배경 확인/bs-to-target 선행 안내 (TARGET 미등록인 경우)docs/specs/templates/{prd|functional_design|task|development}.md.claude/rules/specs.md "문서 유형별 핵심 내용" 자기 검증 체크리스트 확인rules/specs.md 분리 규칙(-flows, -api 접미사) 적용pnpm typecheck, pnpm test 통과 확인순서 주의:
/pre-pr을 가장 먼저 실행한다. 자동 검증(lint/typecheck/build/test) 출력으로 메인 컨텍스트가 오염되면 reviewer 에이전트 호출 품질이 떨어지기 때문.
/pre-pr 호출 (영역별 병렬 위임은 rules/code-review.md 매트릭스 기준)
pnpm lint:fix && pnpm prettier:fixpnpm typecheck && pnpm build && pnpm test/pre-pr 재호출specs-lifecycle.md 6단계 규정):
docs/specs/target/functional/tasks/{name}.md 삭제docs/specs/target/functional/development/{name}-*.md 삭제docs/specs/functional-design/{name}.md → 도메인 메인 문서에 병합 (개선 시) + 축약 규칙 적용
docs/specs/README.md TARGET 표: 완료된 행 표에서 제거 + 카운트 헤더 "+N건 완료" 갱신 (rules/specs-lifecycle.md "TARGET 표 완료 항목 처리")docs/specs/README.md 상단 "Current Functional" 설명 반영README.md: 구현 현황 반영 (해당 시).claude/rules/*.md: 패턴/정책 변경 시 갱신/commit → /pr 체인
/pre-pr 재호출 후 다시 대기 게이트/commit → /pr 체인 실행조건 (CLAUDE.md Plan Mode 기준 "불필요" 케이스):
플로우: 1 → 2 → 5 → 6
조건 (specs-lifecycle.md "비기능적 요구사항"):
플로우: 2 → 5 → 6
CLAUDE.md, rules/api.md 등 패턴/환경변수 갱신 필수feature/<name>, fix/<name>, dc-choi/<name> 접두 제거docs/specs/prd/{name}.md → PRDdocs/specs/functional-design/{name}.md → FDdocs/specs/target/functional/tasks/{name}.md → Taskdocs/specs/target/functional/development/{name}-*.md → Dev (역할별)git log origin/main..HEAD)로 구현 여부 힌트기능: account-name-unique
[ ✓ ] PRD docs/specs/prd/account-name-unique.md
[ ✓ ] FD docs/specs/functional-design/auth-account-extended.md (병합됨)
[ ✗ ] Task
[ ✗ ] Development
[ - ] 구현 커밋 없음
다음 단계: /sdd 3 account-name-unique
.claude/rules/code-review.md의 에이전트 위임 매트릭스를 그대로 준수. 중복 기술 금지. 영역별 병렬 호출은 /pre-pr 스킬이 전담한다.
/bs-to-target: 브레인스토밍 결과를 TARGET에 등록 (0단계 선행)/pre-pr: reviewer 6종 병렬 호출 (6단계 게이트)/commit, /pr: 커밋 및 PR 생성 (6단계 체인).claude/rules/specs.md (계층/템플릿/분리), .claude/rules/specs-lifecycle.md (검증·정리·예외·비기능)docs/specs/templates/매일 21:00 DB 운영 메일 본문 paste + GA4/Clarity MCP 자동 조회로 정량 스냅샷을 만들어 STATUS 갱신 근거를 제공한다. /biz-pulse 로 호출.
사업 문서 7개 + STATUS 간 용어·수치·가정 충돌 자동 감지. /biz-audit [문서1] [문서2] 형식으로 호출.
사업 에이전트 워크플로우 실행. /biz [status|market|bm|gtm|risk|metrics|roadmap|pricing|content|audit|handoff]
브레인스토밍 에이전트들이 공유하는 토론 규칙과 출력 형식. 모든 에이전트가 이 규칙을 따른다.
Claude Design(claude.ai/design)으로 시안 제작 → 2단 컨펌 → Claude Code 구현 플로우를 5단계로 진행한다. /design-draft [기능명]으로 호출. 새 페이지·주요 컴포넌트·출력물 비주얼이 필요할 때.
PR 생성 전 변경 파일 영역을 분석해 관련 reviewer 에이전트를 병렬 호출하고 심각도별 결과를 집계한다. /pre-pr 로 호출.