k-sdd: 팀용 워크플로를 위한 SDD(스펙주도개발) 오픈소스

Claude Code / Cursor IDE / Gemini CLI / Codex CLI / GitHub Copilot / Qwen Code / Windsurf를 프로토타입 단계에서 프로덕션 사양 기반으로 전환합니다. 요구사항·설계·태스크·프로젝트 메모리를 팀 워크플로우에 맞게 커스터마이즈할 수 있습니다.

Kiro 호환 — Kiro IDE와 유사한 Spec-Driven / AI-DLC 스타일을 제공하며, 기존 Kiro 사양 문서도 그대로 사용할 수 있습니다.

v1.0.0 기능

  • ✅ 리뷰하기 쉬운 설계 문서 — 구조화 포맷과 요약 테이블로 리뷰 시간을 5배 단축
  • ✅ Research 분리 — 조사 메모(Research.md)와 최종 설계(Design.md)를 분리 관리
  • ✅ 품질 게이트 — validate-gap / validate-design / validate-impl 명령으로 코딩 전 통합 문제를 사전 감지
  • ✅ 1회성 커스터마이즈 — 템플릿을 팀 프로세스에 맞게 한 번만 조정하면 모든 에이전트에 동일 적용
  • ✅ 통합 워크플로우 — 7개 에이전트 × 12개 언어에서 동일한 11단계 커맨드 프로세스 공유

설치 방법


  # 기본 설치 (기본값: 영어, Claude Code)
  npx k-sdd@latest
  
  # 언어 옵션 (기본값: --lang en)
  npx k-sdd@latest --lang ko    # 한국어
  npx k-sdd@latest --lang es    # 스페인어
  ...(지원언어: en, ko, zh-TW, zh, es, pt, de, fr, ja, ru, it, ar)
  
  # 에이전트 옵션 (기본값: claude-code / --claude)
  npx k-sdd@latest --claude --lang ko        # Claude Code(11가지 명령, 대응 언어는 임의)
  npx k-sdd@latest --claude-agent --lang ko  # Claude Code Subagents(12가지 명령 + 9 서브에이전트)
  npx k-sdd@latest --cursor --lang ko        # Cursor IDE
  npx k-sdd@latest --gemini --lang ko        # Gemini CLI
  npx k-sdd@latest --codex --lang ko         # Codex CLI
  npx k-sdd@latest --copilot --lang ko       # GitHub Copilot
  npx k-sdd@latest --qwen --lang ko          # Qwen Code
  npx k-sdd@latest --windsurf --lang ko      # Windsurf IDE
  
  # 참고: 참고: @next는 향후 알파/베타 버전용

GitHub Repository

Quick Start

신규 프로젝트인 경우


  # AI 에이전트를 실행하고, 즉시 스펙주도개발(Spec-Driven Development)을 시작
  /kiro:spec-init OAuth로 사용자 인증 시스템 구축           # AI가 구조화된 계획을 생성
  /kiro:spec-requirements auth-system                 # AI가 명확화를 위한 질문
  /kiro:spec-design auth-system                       # 사람이 검증, AI가 설계
  /kiro:spec-tasks auth-system                        # 구현 태스크로 분해
  /kiro:spec-impl auth-system                         # TDD로 실행
  
  ![design.md - System Flow Diagram](https://aivibecoding.kr/design-system_flow.png)
  *설계 단계 `design.md`에서의 시스템 플로우 예시*
  
  ### 기존 프로젝인 경우 (권장)
  ```bash
  # 먼저 프로젝트 컨텍스트를 확립한 뒤 개발을 진행
  /kiro:steering                                      # AI가 기존 프로젝트 컨텍스트를 학습
  
  /kiro:spec-init 기존 인증에 OAuth 추가                  # AI가 확장 계획을 생성
  /kiro:spec-requirements oauth-enhancement           # AI가 명확화를 위한 질문
  /kiro:validate-gap oauth-enhancement                # 옵션: 기존 기능과 요구사항을 분석
  /kiro:spec-design oauth-enhancement                 # 사람이 검증, AI가 설계
  /kiro:validate-design oauth-enhancement             # 옵션: 설계 통합을 검증
  /kiro:spec-tasks oauth-enhancement                  # 구현 태스크로 분해
  /kiro:spec-impl oauth-enhancement                   # TDD로 실행

k-sdd를 선택하는 이유

  • 1. 사양이 단일 정보원(Single Source of Truth): 요구사항, 설계, 태스크, Supporting References까지 한 세트로 정리되어 승인 속도가 빨라집니다.
  • 2. Greenfield / Brownfield 모두 대응: 신규 기능은 minutes 단위로 시작, 기존 시스템은 validate 계열 커맨드와 Project Memory로 안전하게 확장합니다.
  • 3. 여러 에이전트를 동시에 활용: Claude / Cursor / Codex / Gemini / Copilot / Qwen / Windsurf가 동일한 템플릿/룰을 공유합니다.
  • 4. 커스터마이즈는 한 번만: .kiro/settings/templates/와 .kiro/settings/rules/를 수정하면 모든 에이전트에 즉시 반영됩니다.

주요 기능

  • AI-DLC 방식: 사람 승인 포함 AI 네이티브 프로세스입니다. 코어 패턴: AI 실행, 사람 검증
  • 사양 우선 개발(Spec-First): 포괄적 사양을 단일 정보원으로 삼아 라이프사이클 전체를 구동
  • ‘볼트’(스프린트가 아니라): AI-DLC로 주 단위 스프린트를 대체하는 시간/일 단위 집중 사이클입니다. 관리 오버헤드 70%에서 탈출
  • 영속적 프로젝트 메모리: AI가 스티어링 문서를 통해 모든 세션에 걸쳐 포괄적 컨텍스트(아키텍처, 패턴, 룰, 도메인 지식)를 유지
  • 템플릿 유연성: {{KIRO_DIR}}/settings/templates（steering / requirements / design / tasks）를 팀 문서 형식에 맞게 커스터마이즈 가능
  • AI 네이티브 + 사람 게이트: AI 계획 → AI 질문 → 사람 검증 → AI 구현(품질 관리 포함 고속 사이클)
  • 팀 대응: 품질 게이트 포함 12개 언어 대응의 크로스플랫폼 표준 워크플로우

지원 AI 에이전트

  • Claude Code (✅ 완전 지원): 11개 슬래시 커맨드
  • Claude Code Subagents (✅ 완전 지원): 12개 커멘드 + 9개 서브에이전트
  • Cursor IDE (✅ 완전 지원): 11개 커맨드
  • Gemini CLI (✅ 완전 지원): 11개 커맨드
  • Codex CLI (✅ 완전 지원): 11개 프롬프트
  • GitHub Copilot (✅ 완전 지원): 11개 프롬프트
  • Qwen Code (✅ 완전 지원): 11개 커맨드
  • Windsurf IDE (✅ 완전 지원): 11개 워크플로우
All Rights Reserved by JAEWOO, KIM. © 2026 MDRULES Development.