SDD(Spec-kit)로 해본 에이전트 코딩 실전기

AI 플랫폼을 만들며 에이전틱 코딩의 생산성은 크게 체감했지만, 프로젝트가 복잡해질수록 무분별한 코드 생성과 환각이 문제로 드러났다. 그래서 카카오페이 AI 플랫폼 팀은 개발자의 역할을 코드 작성보다 스펙 정의, 검증, 테스트 설계 쪽으로 옮기는 SDD(Spec-Driven Development) 와 Spec-kit을 도입했다.

Spec-kit은 먼저 constitution으로 팀의 최상위 원칙을 정하고, 이어서 specify로 기능 요구사항을 구체화한다. 필요하면 clarify로 요구사항을 더 명확히 한 뒤, plan에서 개발 계획을 만들고 tasks로 실행 단위 작업을 쪼갠다. 마지막으로 analyze로 스펙, 계획, 작업 간 모순을 점검한 다음 implement 단계로 코드를 생성한다.

설정은 uv tool install specify-cli --from git+https://github.com/github/spec-kit.git로 CLI를 설치한 뒤 specify init <PROJECT_NAME> 또는 specify init --here로 시작한다. 초기화 후에는 한글로 진행하도록 요청하면 constitution.md, spec.md, plan.md, tasks.md 같은 산출물이 차례대로 만들어지고, Figma MCP 같은 외부 컨텍스트도 연결할 수 있다.

실전에서 가장 중요한 점은 마음에 들지 않는 결과를 직접 뜯어고치기보다 다시 specify로 돌아가 스펙을 바로잡는 것이다. 이렇게 해야 스펙, 계획, 코드의 불일치를 줄일 수 있고, 팀 단위로는 다른 개발자가 무엇을 했는지 문서로 추적하기도 쉬워진다.

다만 단계가 많아 처음엔 복잡하고, 간단한 수정에는 오히려 부담이 될 수 있으며, 생성되는 문서와 토큰 사용량도 늘어난다. 그럼에도 보안, 테스트, 일관성처럼 흔들리면 안 되는 요소를 구조적으로 관리할 수 있다는 점에서, 에이전틱 코딩의 다음 단계로 SDD가 유효하다는 결론에 이른다.