SDD (spec-kit) 에이전트 코딩 실전기
Summary
"바이브 코딩은 이제 그만!" 카카오페이가 AI 에이전트를 길들이는 법, SDD 실전 가이드
무분별한 AI 코드 생성을 막고 엔터프라이즈급 일관성을 유지하는 Spec-kit 활용 전략
AI 에이전트에게 단순히 프롬프트를 던지는 '바이브 코딩'의 시대가 저물고 있습니다. 본 아티클은 카카오페이 AI 플랫폼 팀이 겪은 시행착오를 바탕으로, 스펙을 먼저 정의하고 AI를 체계적으로 제어하는 SDD 방법론과 Spec-kit의 실무 적용기를 상세히 다룹니다. 개발자의 역할이 '코더'에서 '설계 및 검증자'로 진화하는 과정을 생생하게 확인해 보세요.
- 01LLM의 환각과 코드 파편화 문제를 해결하는 SDD(Spec-Driven Development) 방법론 제시
- 02Constitution부터 Implement까지 이어지는 Spec-kit의 6단계 워크플로우 상세 분석
- 03Figma MCP 연동을 통해 디자인 스펙을 코드로 직접 변환하는 자동화 사례 공유
- 04바이브 코딩의 한계를 극복하고 팀 단위의 일관된 코드 스타일을 유지하는 비결
- 05AI 시대 개발자의 본질적인 역할 변화에 대한 통찰력 있는 인사이트 제공
RECOMMENDATION
AI 에이전트 도입 후 코드 리뷰 비용이 늘어난 팀이나, 대규모 프로젝트에서 AI를 체계적으로 활용하고 싶은 시니어 엔지니어 및 팀 리더에게 강력히 추천합니다.
The Problem
기존의 에이전틱 코딩 방식은 프로젝트가 고도화됨에 따라 무분별한 코드 생성과 AI 환각 현상으로 인해 코드의 일관성이 무너지는 문제를 야기했다. 특히 대화가 길어질수록 AI가 이전 문맥을 상실하여 스타일이 파편화되고, 개발자가 생성된 코드를 검토 및 수정하는 데 소요되는 시간이 늘어나는 한계가 존재했다.
The Solution
스펙 중심의 개발 방법론인 SDD(Spec-Driven Development)와 이를 지원하는 도구인 Spec-kit을 도입하여 헌법(Constitution), 상세 스펙(Specify), 계획(Plan), 작업(Tasks), 분석(Analyze), 실행(Implement)으로 이어지는 단계적 파이프라인을 구축했다. 이를 통해 개발자가 스펙 정의에 집중하고 AI가 생성한 코드를 체계적으로 제어할 수 있는 환경을 조성했다.
The Result
개발자가 코드를 직접 작성하는 시간보다 스펙을 설계하고 검증하는 데 집중하게 함으로써 엔터프라이즈 환경에서 필수적인 일관성을 확보하고 팀 단위 협업 효율을 높였다. 바이브 코딩의 고질적인 문제였던 맥락 상실을 해결했으며, MCP 연동을 통해 피그마 등 외부 설계 도구와의 통합 개발 프로세스를 구축하는 성과를 거두었다.
Trade-off
단계별 프로세스가 세분화되어 있어 숙련도가 낮은 개발자에게는 초기 진입 장벽이 높으며, 간단한 수정 작업에도 전체 파이프라인을 거쳐야 할지 판단이 모호할 수 있다. 또한 단계마다 대량의 개발 문서가 생성되어 LLM 토큰 소모량이 증가하며, 아주 작은 규모의 프로젝트에서는 프로세스 오버헤드가 발생할 수 있다.
Key Concepts
More from 카카오페이
View all posts from 카카오페이
2025 TAM CONNECT: 카카오페이 x 토스, 기술지원의 미래를 함께 그리다
Technical Account ManagementTAMOperational Excellence1개월 전
공통 컴포넌트를 건강하게 기르기 위한 고민
ReactComponent LifecycleHeadless UI3개월 전
2026년 카페개페, AI와 함께한 현장 스케치
카카오페이DevRel개발자페스티벌3개월 전
수억 건의 데이터, 맛있게 쪼개 먹는 방법 (with. Partitioning)
Spring BatchPartitioningMongoDB3개월 전
그때는 맞고 지금은 틀리다. Yarn Berry에서 pnpm으로 패키지 매니저 전환기
pnpmYarn BerryZero-installs4개월 전