gotalab/cc-sdd

cc-sdd – 사양 중심의 장기 실행 AI 코딩 에이전트

개요

• 8개의 서로 다른 AI 코딩 어시스턴트(Claude Code, Codex, Cursor, GitHub Copilot, Devin, OpenCode, Gemini CLI, Antigravity)에 Agent Skills를 설치하는 npm 패키지입니다.
• 이러한 기술은 사양 중심 소프트웨어 개발 수명 주기(SDLC)를 구현하여 AI가 사양을 작성하고, 인간이 계약을 승인한 후 자율적으로 코드를 생성, 테스트, 검토 및 디버깅하도록 합니다.
• 워크플로우는 일련의 명령어(/kiro-discovery, /kiro-spec-init, /kiro-spec-requirements, /kiro-spec-design, /kiro-spec-tasks, /kiro-impl 등)로 나뉘어 있으며, 이 명령어들은 Markdown 아티팩트(brief.md, requirements.md, design.md, tasks.md)를 생성하고 장기 실행 구현 루프를 구동합니다.

존재 이유

• 기존의 AI 보조 코딩은 단일 프롬프트를 모델에 전달하고 출력이 최종 제품이 되기를 기대하는 경우가 많았습니다. cc-sdd는 사양을 "시스템이 무엇을 해야 하는지"와 "어떻게 구축되는지"를 분리하는 계약으로 취급합니다. 이를 통해 여러 에이전트(또는 인간)가 서로 덮어쓰지 않고 병렬로 작업할 수 있습니다.
• 각 작업에 새로운 하위 에이전트를 할당함으로써, 이 도구는 기능 플래그 뒤에서 테스트 주도 개발(RED → GREEN)을 실행하고, 독립적인 검토를 수행하며, 검토가 실패할 경우 자동으로 디버깅합니다. 기본 하위 에이전트를 사용할 수 없는 경우 동일한 프로세스가 인라인으로 실행됩니다.

주요 개념

개념	역할
Discovery (/kiro-discovery)	아이디어를 여러 경로 중 하나로 라우팅합니다: 기존 사양 확장, 새 사양 시작, 여러 사양으로 분해, 또는 사양 없이 직접 구현. brief.md(필요 시 roadmap.md)를 생성합니다.
사양 파일 (requirements.md, design.md, tasks.md)	Kiro 방법론을 따르는 구조화된 Markdown: EARS 스타일 요구 사항, Mermaid 다이어그램, 파일 구조 계획, 작업 주석(_Boundary:_, _Depends:_).
Implementation (/kiro-impl)	각 작업을 격리하여 실행합니다. 기본 하위 에이전트를 사용하는 경우 새로운 구현자와 독립적인 검토자를 생성하며, 검토자가 변경 사항을 거부하면 자동 디버깅 패스를 실행합니다. 결과는 tasks.md에 기록되어 나중에 실행을 재개할 수 있습니다.
Spec-batch (/kiro-spec-batch)	다중 사양 로드맵을 병렬 사양 생성 웨이브로 변환하고, 사양 간 검토를 추가하여 책임 중복이나 인터페이스 불일치를 포착합니다.
Agent Skills	에이전트당 17개의 명령어 세트(예: Claude Code, Codex, Cursor). 동일한 기술 세트가 지원되는 모든 에이전트에서 작동하며, 기본 설치는 Claude Code를 사용합니다.

시작하기

# 프로젝트 폴더에 기본 (Claude Code) 기술 세트 설치
cd my-project
npx cc-sdd@latest

# 선호하는 다른 에이전트나 언어 선택
npx cc-sdd@latest --codex-skills --lang ja   # Codex, 일본어 문서
npx cc-sdd@latest --cursor-skills --lang zh-TW   # Cursor IDE, 번체 중국어

그런 다음 사용하는 AI 어시스턴트 내에서 첫 번째 명령어를 실행합니다:

/kiro-discovery "Photo albums with upload, tagging, and sharing"

도구가 brief.md를 작성하고 다음 명령어(보통 kiro-spec-init)를 알려줍니다. kiro-impl이 구현을 완료할 때까지 명령어 체인을 따르십시오.

지원되는 에이전트 및 안정성

• Claude Code – 안정
• Codex – 안정
• Cursor IDE, GitHub Copilot, Devin, OpenCode, Gemini CLI, Antigravity – 베타
• 레거시 “Cascade/Windsurf” 모드는 존재하지만 더 이상 사용되지 않습니다.

사용자 정의

• 모든 템플릿(요구 사항, 설계, 작업)은 {{KIRO_DIR}}/settings/templates/ 아래에 있습니다.
• AI 생성을 안내하는 규칙(예: 수락 기준 형식, 명명 규칙)은 {{KIRO_DIR}}/settings/rules/에 있습니다.
• 팀은 이를 PRD 프로세스, JIRA 통합, 도메인별 표준 등에 맞게 조정할 수 있습니다.

문서 및 가이드

• Skill Reference – 17가지 기술과 /kiro-impl 하위 에이전트 흐름에 대한 자세한 설명.
• Command Reference – 레거시 /kiro:* 명령어 사용법.
• Customization Guide – 템플릿과 규칙을 조정하기 위한 구체적인 코드 조각.
• Spec-Driven Guide – 아이디어에서 배포된 코드까지의 엔드투엔드 워크스루.
• Why cc-sdd? – 설계 근거 및 이 도구가 적합한 상황.

대상 사용자

• AI 기반의 계약 우선 개발을 대규모로 실험하려는 개발 팀.
• LLM이 무거운 작업을 처리하게 하면서 사양에서 코드로의 명확한 추적을 유지하려는 개인 개발자.
• Kiro 사양 방법론을 이미 사용 중이며 여러 코딩 에이전트에 대한 CLI 기반 브리지를 원하는 조직.

라이선스

• MIT (LICENSE 참조).

---

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.