왜 ITDA인가?

• 🔀 AI 도구의 파편화 → 7개 에이전트, 하나의 통합 워크플로
• 📝 모호한 요구사항 정의 → 5가지 EARS 형식 패턴
• 🔍 추적성(트레이서빌리티) 상실 → 요구사항→설계→코드→테스트 100% 추적
• ⚠️ 품질 불일치 → 9개 헌법 조항 + Phase-1 게이트
• 🔄 기존 프로젝트의 난제 → 차분 사양 + 변경 관리

Quick Start

  # 30초로 설치 & 초기화
  npx itda-sdd init
  
  # 기존 프로젝트용 - 자동 분석 및 스티어링 문서 생성
  npx itda-sdd onboard
  
  # 완료! AI 에이전트에서 SDD 커맨드를 사용:
  # Claude Code: /sdd-requirements, /sdd-design, /sdd-implement
  # GitHub Copilot: #sdd-requirements, #sdd-design, #sdd-implement

                        

기타 설치 옵션

  # 전역 설치
  npm install -g itda-sdd
  
  # 특정 AI 에이전트용으로 초기화
  itda init --copilot   # GitHub Copilot
  itda init --cursor    # Cursor IDE
  itda init --gemini    # Gemini CLI
  itda init --codex     # Codex CLI
  itda init --qwen      # Qwen Code
  itda init --windsurf  # Windsurf IDE

                        

GitHub Repository

• https://github.com/gaebalai/itda-sdd

리뷰 게이트 엔진(Review Gate Engine)

• 각 개발 단계에서 체계적인 리뷰를 수행하기 위한 새로운 품질 게이트를 도입했습니다.
• Requirements Gate: EARS 형식, 우선순위, 인수 기준 검증 (#sdd-review-requirements)
• Design Gate: C4 모델, ADR, 컴포넌트 설계 검증 (#sdd-review-design)
• Implementation Gate: 코드 품질, 테스트 커버리지, 네이밍 규칙 검증 (#sdd-review-implementation)
• Full Review: 모든 게이트를 순차적으로 실행 (#sdd-review-all)

엔터프라이즈 기능

• 에러 복구: 복구 절차를 포함한 자동 에러 분석
• 롤백 매니저: 파일 / 커밋 / 단계 / 스프린트 단위 롤백
• CI 리포터: GitHub Actions 통합
• Phase -1 게이트: 모든 단계 이전의 헌법 준수 체크
• 스티어링 동기화: 버전 변경 시 스티어링 파일 자동 업데이트
• AI 네이티브 + 사람 게이트: AI 계획 → AI 질문 → 사람 검증 → AI 구현(품질 관리 포함 고속 사이클)

지원 AI 코딩 에이전트

• Claude Code
• Cursor IDE
• Gemini CLI
• Codex CLI
• GitHub Copilot
• Qwen Code
• Windsurf IDE

SDD프레임워크의 장점 통합

• itdda: 20 에이전트 시스템, 스티어링, EARS 형식
• OpenSpec: 차분 사양, 브라운필드 지원
• ag2（AutoGen）: 멀티 에이전트 오케스트레이션
• ai-dev-tasks: 단순성, 점진적 복잡도 관리
• k-sdd: P 라벨 병렬화, 검증 게이트
• spec-kit: 헌법 거버넌스, 테스트 퍼스트

특징

• 🤖 멀티 에이전트 대응: 7개의 AI 코딩 에이전트 지원(Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex CLI, Qwen Code, Windsurf)
• 🔌 MCP 서버 통합: 고도화된 코드 분석을 위한 CodeGraphMCPServer
• 📄 유연한 커맨드 형식: Markdown, TOML, AGENTS.md 형식 지원
• 🎯 27개의 전문 스킬(전 플랫폼 대응): 25개 플랫폼 에이전트 + 5개 오케스트레이터 내장 스킬
• Claude Code: Skills API(25개 스킬 + 5개 내장)
• GitHub Copilot & Cursor: AGENTS.md(공식 지원)
• 기타 4개 에이전트: AGENTS.md(호환 형식)
• 📋 헌법 거버넌스: 9개의 불변 조항 + Phase-1 게이트로 품질 보증
• 📝 EARS 요구사항 생성기: 5가지 EARS 패턴으로 명확한 요구사항 작성
• 🏗️ 설계 문서 생성기: 추적성 포함 C4 모델과 ADR 생성
• 🔄 변경 관리 시스템: 브라운필드 프로젝트용 차분 사양
• 🔍 갭 탐지 시스템: 고립된 요구사항 및 테스트되지 않은 코드를 식별
• 🧭 자동 갱신 프로젝트 메모리: 스티어링 시스템이 아키텍처, 기술 스택, 제품 컨텍스트를 유지
• 🚀 자동 온보딩: itda-onboard가 기존 프로젝트를 분석하고 스티어링 문서를 생성(2~5분)
• 🔄 자동 동기화: itda-sync가 코드베이스 변경을 감지해 스티어링 문서를 최신 상태로 유지
• 🔍 지능형 코드 분석: itda-analyze가 품질 메트릭, 복잡도 분석, 기술 부채 탐지를 제공
• 🤝 팀 협업: itda-share가 메모리 공유, 임포트/익스포트, 멀티 플랫폼 동기화를 제공
• ✅ 헌법 검증(Validation): itda-validate가 9개의 불변 거버넌스 조항과 Phase-1 게이트를 강제
• ✅ 완전한 추적성: 요구사항 → 설계 → 코드 → 테스트 매핑
• 🌐 이중언어 문서: 모든 에이전트 생성 문서는 영어와 한국어로 모두 생성