gotalab/cc-sdd

단 한 번의 명령으로 에이전트 기반 SDLC (Software Development Life Cycle) 워크플로우를 에이전트 기술 (Agent Skills)로 설치합니다: 탐색 (discovery), 요구사항 (requirements), 설계 (design), 작업 (tasks), 그리고 작업별 독립적 검토 (independent review)를 포함한 자율적 구현 (autonomous implementation)이 포함됩니다. 8개의 AI 코딩 에이전트에서 작동하며, 각 에이전트마다 동일한 17가지 기술 세트가 적용됩니다.

👻 Kiro에서 영감을 받음. Kiro IDE와 유사한 명세 기반 (spec-driven) 에이전트 SDLC 스타일을 따릅니다. 기존 Kiro 명세는 호환 및 이식이 가능합니다.

cc-sdd v3.0은 에이전트 기술 (Agent Skills)과 장기 실행 자율 구현 (long-running autonomous implementation)을 중심으로 재설계되었습니다.

탐색 (Discovery)은 새로운 작업을 다음 중 하나로 경로를 지정합니다: 기존 명세 확장, 명세 없이 직접 구현, 새로운 명세 생성, 여러 명세로 분해, 또는 혼합 분해. 이는 새로운 진입점인 /kiro-discovery를 통해 수행되며, brief.md를 작성하고 필요 시 roadmap.md를 작성하여 범위를 다시 설명하지 않고도 워크스트림 (workstream)을 재개할 수 있습니다.

각 작업은 기능 플래그 (feature flag) 뒤에서 TDD (테스트 주도 개발, RED → GREEN)를 실행하는 새로운 구현체 (implementer), 독립적인 검토자 (independent reviewer), 그리고 구현체가 차단되거나 검토자가 두 번 거절할 경우 깨끗한 컨텍스트에서 근본 원인을 조사하는 자동 디버그 패스 (auto-debug pass)를 할당받습니다. 이전 작업의 학습 내용은 장기 실행 자율 구현을 위해 /kiro-impl을 통해 tasks.md 내의 ## Implementation Notes로 전달됩니다. 반복당 1개의 작업을 수행하며, 중단 후 재실행해도 안전합니다.

경계 우선 명세 규율 (Boundary-first spec discipline). design.md에는 이제 작업 경계를 결정하는 파일 구조 계획 (File Structure Plan)이 포함됩니다. 작업에는 _Boundary:_ 및 _Depends:_ 주석이 포함됩니다. 검토 및 검증은 단순한 스타일 이슈뿐만 아니라 경계 위반 여부를 확인합니다. 로드맵을 여러 명세로 병렬화하고, 명세 간 검토 (cross-spec review)를 통해 모순, 중복된 책임, 인터페이스 불일치를 잡아냅니다. 다중 명세 이니셔티브를 위해 /kiro-spec-batch를 사용합니다.

8개의 코딩 에이전트에 걸친 에이전트 기술 (Agent Skills). 설치당 17개의 기술이 포함되며, 필요에 따라 로드됩니다 (점진적 공개, progressive disclosure). Claude Code와 Codex는 안정적이며, Cursor, Copilot, Windsurf, OpenCode, Gemini CLI, Antigravity는 베타 버전입니다. 외부 의존성은 없으며, 하위 에이전트 (subagents)는 각 플랫폼의 네이티브 프리미티브 (native primitive)를 통해 생성됩니다.

전체 스킬 모드 (skills-mode) 워크플로우 및 /kiro-impl

내부 구조: 스킬 참조 (Skill Reference).

v1.x 또는 v2.x에서 업그레이드하시나요? 마이그레이션 가이드 (Migration Guide)를 참조하세요.

cc-sdd는 스펙 (spec)을 에이전트에게 전달되는 마스터 명령 문서가 아니라, 시스템 구성 요소 간의 계약 (contract)으로 취급합니다. 코드가 여전히 신뢰할 수 있는 유일한 원천 (source of truth)으로 남습니다. 스펙은 코드 구성 요소 간의 경계를 명확하게 하여, 인간과 에이전트가 지속적인 동기화 없이 병렬로 작업할 수 있게 합니다.

우리의 가설: 적절한 세분화 수준에서의 명시적인 계약은 팀 규모의 AI 주도 개발 (AI-driven development)을 느리게 만드는 것이 아니라 더 빠르게 만듭니다. 에이전트가 스펙을 작성하고, 인간이 단계별 게이트 (phase gates)에서 계약을 승인하며, 최종적으로 배포되는 것은 코드입니다.

경계는 오버헤드 (overhead)가 아닙니다. 경계는 외부를 보호하면서 내부에서 자유롭게 움직일 수 있게 해주는 장치입니다.

전체 논거, 트레이드오프 (trade-offs), 그리고 사용 시점 및 미사용 시점: 왜 cc-sdd인가? 철학적 노트.

cd your-project
npx cc-sdd@latest

기본적으로 영어 문서가 포함된 Claude Code Skills가 설치됩니다. 다른 에이전트나 언어를 선택하려면 다음과 같이 입력하세요:

npx cc-sdd@latest --codex-skills --lang ja # Codex, 일본어
npx cc-sdd@latest --cursor-skills --lang zh-TW # Cursor IDE, 번체 중국어

8개의 AI 코딩 에이전트 (Claude Code 및 Codex는 안정 버전; Cursor, Copilot, Windsurf, OpenCode, Gemini CLI, Antigravity는 베타 버전)와 13개의 언어를 지원합니다. 전체 목록은 지원되는 에이전트 (Supported Agents)를 참조하세요.

그 다음, 에이전트에서 다음을 실행합니다:

/kiro-discovery <idea>

어디서부터 시작해야 할지 모르겠나요? kiro-discovery로 시작하세요. 이 명령어가 요청을 라우팅하고 다음에 실행할 명령어를 알려줍니다.

당신이 하고 싶은 것...	스킬 모드 (Skills mode)
새로운 기능 또는 제품 규모의 아이디어 시작	kiro-discovery → kiro-spec-init → kiro-spec-requirements → kiro-spec-design → kiro-spec-tasks → kiro-impl
...

기존의 /kiro:* 명령 모드 (--claude, --cursor 등)는 여전히 사용할 수 있지만, 사용 중단 예정 (deprecated) 상태입니다. 업그레이드 경로는 마이그레이션 가이드를 참조하세요.

승인된 더 큰 작업 세트(task sets)에 대해서는 kiro-impl을 실행하세요.

태스크별 서브에이전트 생성 (subagent spawn), 독립적인 검토 (independent review), 그리고 실패 시 자동 디버깅 (auto-debug) 기능을 갖춘 자율적 구현 (autonomous implementation)을 시작하려면 kiro-impl을 실행하세요.

예시: 새로운 사진 앨범 (Photo Albums) 기능 구축.

/kiro-discovery 업로드, 태깅, 공유 기능이 포함된 사진 앨범
# discovery는 brief.md (및 다중 사양일 경우 roadmap.md)를 작성하고 다음 명령어를 제안합니다.
/kiro-spec-init photo-albums
...

일반적인 사양 (spec) 출력 결과 (10분 이내):

requirements.md
: 수락 기준 (acceptance criteria)이 포함된 EARS 형식의 요구사항.

design.md
: Mermaid 다이어그램과 파일 구조 계획 (File Structure Plan)이 포함된 아키텍처.

tasks.md
: 경계 (boundaries) 및 의존성 주석 (dependency annotations)이 포함된 구현 태스크.

그 다음 /kiro-impl을 실행하면,

기능 플래그 (feature flags) 뒤에서 TDD (RED → GREEN) 방식, 독립적인 검토자 패스 (independent reviewer pass), 그리고 실패 시 자동 디버깅 (auto-debug)을 통해 태스크들을 자율적으로 실행합니다.

8가지 스킬 변형 (skills variants) 모두 동일한 17가지 스킬 세트를 제공합니다. 차이점은 각 플랫폼 통합 (platform integration)이 실제 환경에서 얼마나 사용되었는지에 있습니다.

에이전트 (Agent)	스킬 모드 (Skills mode)	안정성 (Stability)	레거시 모드 (Legacy mode)
Claude Code	--claude-skills	안정 (Stable)	--claude / --claude-agent (사용 중단됨)
Codex	--codex-skills	안정 (Stable)	--codex (차단됨)
Cursor IDE	--cursor-skills	베타 (Beta)	--cursor (사용 중단됨)
GitHub Copilot	--copilot-skills	베타 (Beta)	--copilot (사용 중단됨)
Windsurf IDE	--windsurf-skills	베타 (Beta)	--windsurf (사용 중단됨)
OpenCode	--opencode-skills	베타 (Beta)	--opencode / --opencode-agent (사용 중단됨)
Gemini CLI	--gemini-skills	베타 (Beta)	--gemini (사용 중단됨)
Antigravity	--antigravity	베타 (Beta, 실험적)	—
Qwen Code	—	—	--qwen

"베타 (Beta)"는 "기능 누락"을 의미하지 않습니다. 17가지 스킬과 템플릿은 8개 플랫폼 모두에서 동일합니다. 이는 플랫폼 통합 (서브에이전트 생성 동작, 사용성 (ergonomics), SKILL.md 로딩)이 Claude Code 및 Codex보다 실제 사용 사례가 적음을 의미하며, 예외 케이스 (edge cases)가 여전히 나타날 수 있음을 뜻합니다. 문제가 발생하면 보고해 주세요.

**외부 리소스 (External resources)**

- Kiro IDE: 강화된 명세 관리 (spec management) 및 팀 협업.
- Kiro의 명세 방법론 (Spec Methodology): 독창적인 명세 주도 개발 (spec-driven development) 방법론.

MIT License