AI와 협업을 통한 GitHub Spec Kit 을 활용한 명세 기반 개발(Spec-Driven Development, SDD) 프로세스 소개

핵심 내용

• GitHub Spec Kit을 활용한 명세 기반 개발(SDD) 프로세스 소개
• 명세를 유일한 진실 공급원으로 두고, AI 코딩 에이전트의 추측을 줄이는 개발 방식 정리
• Specify → Plan → Tasks → Implement 4단계 워크플로우와 각 단계의 역할 설명
• SDD, BDD, TDD 및 3-File System과의 비교를 통해 적용 범위와 선택 기준 제시

구조와 흐름

• Specify 단계에서 요구사항과 사용자 여정, 수용 조건 중심의 PRD 작성
• Plan 단계에서 기술 스택, API, 데이터 모델, 보안·성능 제약 정의
• Tasks 단계에서 독립적으로 검증 가능한 작은 작업 단위로 분해
• Implement 단계에서 AI가 코드 생성, 개발자는 검토·검증 역할 수행

선택 이유

• 명세와 구현의 불일치 감소
• 프로젝트 변화에 맞춰 살아있는 문서로 명세 진화
• 팀 단위 복잡한 프로젝트와 기존 시스템 확장, 레거시 현대화에 적합

적용해볼 점

• 프로젝트 시작 시 명세를 먼저 고정하고 이후 계획과 작업으로 세분화
• AI 결과물을 직접 수정하기보다 상위 명세와 계획을 조정해 일관성 유지
• 헌법 파일로 테스트, 라이브러리, 보안 규칙 등 공통 원칙 강제