AI
SDD (spec-kit) 에이전트 코딩 실전기
두줄요약
에이전틱 코딩의 환각과 일관성 문제를 줄이기 위해 SDD와 Spec-kit 도입 사례를 공유했습니다. 스펙 정의와 검증 중심의 개발 흐름이 팀 협업에 유리하다고 정리했습니다.
핵심 내용
- 에이전틱 코딩의 생산성 이점과 함께, 프로젝트가 고도화될수록 무분별한 코드 생성과 환각 문제가 커지는 상황 정리
- 카카오페이 AI 플랫폼 팀의 SDD(Spec-Driven Development) 도입 사례와 Spec-kit 기반 개발 흐름 소개
- constitution, specify, clarify, plan, tasks, analyze, implement 단계로 스펙을 먼저 정의하고 검증 중심으로 개발하는 방식 설명
- 개발자의 역할을 코드 작성 중심에서 스펙 검증과 테스트 설계 중심으로 전환하는 흐름 제시
장단점
- 장점: 팀 단위 협업의 일관성, 스펙 문서로 인한 작업 가시성, AI 코드 생성의 맥락 유지
- 장점: 보안·테스팅 같은 기준을 constitution에 명시해 통제 가능
- 단점: 단계 수가 많아 초기 진입장벽이 높고, 문서와 토큰 소모가 큼
적용해볼 점
- 큰 프로젝트에서 AI 코딩을 쓸 때 스펙과 작업 기준을 먼저 정리하는 접근
- 스펙과 실제 코드의 불일치가 생기면 직접 코드 수정보다 스펙 재정의로 맞추는 원칙
- 팀 협업 시 명세, 작업, 검토 흐름을 분리해 일관성을 확보하는 방식