claude-sdd

claude-sdd — 스펙 주도 개발 (SDD) 라이프사이클

English

스펙 주도 개발(SDD) 방법론을 통해 전체 개발 라이프사이클을 관리하는 Claude Code 플러그인입니다. Agent Teams를 활용한 병렬 구현을 지원합니다.

왜 SDD인가?

문제	SDD 해결 방안
모호한 요구사항이 재작업을 유발	Confluence, Jira, Figma, 인터뷰를 통한 구조화된 요구사항 수집
단일 정보 소스 부재	스펙 문서 + 준수 체크리스트를 git으로 관리
팀원 간 품질 편차	스펙 검증을 통한 자동화된 품질 게이트
진행 상황 파악 어려움	체크리스트 기반 진행률 추적 (0%~100%)
순차 처리로 인한 병목	Agent Teams의 워크 패키지 병렬 실행

SDD 라이프사이클

/claude-sdd:sdd-init  -->  /claude-sdd:sdd-intake  -->  /claude-sdd:sdd-spec  -->  /claude-sdd:sdd-plan
   |                      |                        |                      |
   v                      v                        v                      v
 프로젝트             요구사항                  기술 스펙              태스크
 설정                 수집                      작성                   분해

/claude-sdd:sdd-build  -->  /claude-sdd:sdd-review  -->  /claude-sdd:sdd-integrate
   |                |                 |
   v                v                 v
 Agent Teams     품질               PR &
 구현            게이트             문서화

7단계

단계	명령어	산출물
1. 초기화	/claude-sdd:sdd-init new|legacy	sdd-config.yaml, CLAUDE.md 규칙
2. 요구사항 수집	/claude-sdd:sdd-intake	01-requirements.md
3. 스펙 작성	/claude-sdd:sdd-spec	02-*.md ~ 06-spec-checklist.md
4. 계획 수립	/claude-sdd:sdd-plan	07-task-plan.md, 워크 패키지
4.5. 팀 배정	/claude-sdd:sdd-assign	wp-*-member.md
5. 구현	/claude-sdd:sdd-build	구현 코드 + 테스트
6. 리뷰	/claude-sdd:sdd-review	08-review-report.md
7. 통합	/claude-sdd:sdd-integrate	스펙 추적 가능한 PR
8. 변경	/claude-sdd:sdd-change	변경 영향 분석 + 델타 빌드 + 회귀 검증

/claude-sdd:sdd-next를 사용하면 현재 단계를 자동 감지하고 이어서 진행합니다.

설치

빠른 시작 (npx)

npx github:joypop-lguplus/claude-sdd install

CLI 명령어

npx github:joypop-lguplus/claude-sdd check    # 상태 확인
npx github:joypop-lguplus/claude-sdd install   # 자동 설치
npx github:joypop-lguplus/claude-sdd doctor    # 정밀 진단

수동 설치 / 로컬 개발

git clone https://github.com/joypop-lguplus/claude-sdd.git
cd claude-sdd
claude --plugin-dir .

구성 요소

스킬 (슬래시 명령어)

명령어	설명
/claude-sdd:sdd-next	현재 단계를 자동 감지하고 라이프사이클 진행
/claude-sdd:sdd-godmode	심층 인터뷰 + 전체 파이프라인 자동 실행
/claude-sdd:sdd-init	SDD 프로젝트 초기화
/claude-sdd:sdd-intake	요구사항 수집 (Confluence, Jira, Figma, 파일, 인터뷰)
/claude-sdd:sdd-spec	기술 스펙 생성
/claude-sdd:sdd-plan	태스크 분해 (워크 패키지)
/claude-sdd:sdd-assign	워크 패키지에 팀 멤버 배정
/claude-sdd:sdd-build	품질 루프를 통한 구현 (--tdd로 TDD 모드 지원)
/claude-sdd:sdd-review	품질 게이트 검증
/claude-sdd:sdd-integrate	통합, PR 생성, 문서화
/claude-sdd:sdd-change	변경 관리: 영향 분석, 체크리스트 갱신, TDD 델타 빌드
/claude-sdd:sdd-publish	SDD 산출물을 Confluence에 퍼블리싱 + Mermaid 다이어그램 PNG 첨부
/claude-sdd:sdd-status	진행 상황 대시보드
/claude-sdd:sdd-lint	코드 분석: 진단, 검색, 심볼, 포맷

주요 기능

• 프로젝트 규칙 시스템 — 코딩 규칙을 템플릿 기반으로 생성하고, 전체 워크플로우에서 자동 검증 (strict/advisory 모드)

에이전트

에이전트	역할
sdd-requirements-analyst	Confluence/Jira/Figma에서 요구사항 추출
sdd-spec-writer	기술 스펙 및 체크리스트 생성 (Mermaid 다이어그램 포함)
sdd-implementer	워크 패키지 구현 (Agent Teams 멤버, TDD 모드 지원)
sdd-reviewer	스펙 체크리스트 대비 구현 검증 (TDD 준수 확인 포함)
sdd-code-analyzer	네이티브 도구, ast-grep을 활용한 자동 코드 분석
sdd-test-writer	TDD 테스트 작성 (스펙 기반 실패 테스트, 구현 금지)
sdd-change-analyst	변경 영향 분석 (코드 분석, 최소 영향 원칙)

품질 루프

SDD의 핵심은 빌드 단계에서의 리더 주도 품질 루프입니다:

리더 (Opus): 스펙 참조와 함께 워크 패키지 할당
  |
팀 멤버 (teams.model): 스펙 확인 --> 구현 --> 테스트 --> 보고
  |
리더: 체크리스트 검증
  |-- [ ] 미완료 항목 존재 --> 구체적 피드백 + 재작업 (최대 3회)
  |-- 모두 [x] --> 다음 워크 패키지
  |-- 3회 실패 --> 사용자에게 에스컬레이션

TDD 모드 (--tdd)

/claude-sdd:sdd-build --tdd 또는 sdd-config.yaml의 teams.tdd: true로 활성화합니다:

Phase A (Red):   sdd-test-writer가 스펙 기반 실패 테스트 작성
Phase B (Green): sdd-implementer가 테스트 통과 코드 작성 (테스트 수정 금지)
Phase C (Verify): 리더가 전체 테스트 실행, 통과 확인
재작업: 실패 시 Phase B+C 반복 (최대 3회)

변경 관리 (/claude-sdd:sdd-change)

통합 완료 후 변경 요청을 7 Phase로 처리합니다:

Phase 1: 변경 요청 수집 → 09-change-request.md
Phase 2: 영향 분석 (sdd-change-analyst) → 기존 스펙 문서 업데이트
Phase 3: 체크리스트 부분 갱신 (최소 영향 원칙)
Phase 4: 델타 태스크 계획 (CWP-1, CWP-2...)
Phase 5: TDD 델타 빌드 (CHG- + CHG-REG- 테스트)
Phase 6: 리뷰 + 회귀 검증
Phase 7: PR 생성 (변경 추적성 포함)

추가 플래그:

플래그	설명
--from-analysis	분석 보고서(10-analysis-report.md)의 갭에서 CR을 자동 생성 (레거시 프로젝트용)
--lightweight	--from-analysis와 함께 사용. 5개 이하 소규모 갭을 빠르게 처리 (Phase 1-4 자동 설정, Phase 5-7만 실행)

레거시 모드

/claude-sdd:sdd-init legacy로 초기화하면 sdd-config.yaml에 project.type: legacy가 설정됩니다. 레거시 모드에서는 빌드 단계에서 코드 변경 없이 분석 전용 구조 분석만 수행하며, 모든 코드 변경은 /claude-sdd:sdd-change 워크플로우를 통해 처리합니다.

레거시 라이프사이클:

init → intake → spec → plan → assign → build(분석 전용) → change(갭 해소 CRs) → review → integrate