스펙 주도 개발, AI에게 코드를 시키기 전에 스펙부터 쓰는 법
거칠게 많이 적고, 명세를 먼저 확정하고, 테스트를 15초 안에 돌린다
더블테이크 노아 - 4분 분량 - 처음 쓴 날
스펙 주도 개발은 어떻게 하나
스펙 주도 개발 (SDD) 은 AI에게 코드를 맡기기 전에 요구사항과 설계와 작업 목록을 문서로 먼저 확정하고, 그 문서를 기준으로 생성과 검증을 돌리는 방식이다. 국내 팀 기록에서 개발자의 일은 코드를 쓰는 쪽에서 스펙을 정하고 AI가 만든 코드를 검토하는 쪽으로 옮겨 갔다. 스펙이 있어야 빠른 테스트로 AI를 바로 붙잡을 수 있다.
왜 코드보다 스펙이 먼저인가?
에이전트에게 이 기능 만들어 줘 라고만 하면 같은 요청에도 매번 다른 코드가 나오기 쉽다. LY Flava API Gateway 개발 팀은 그 이유를 이렇게 정리했다. "스펙 주도 개발은 변경하려는 사항의 설계와 접근 방식, 작업 항목을 명시적으로 정리해서 모호함을 줄이고 출력의 예측 가능성을 높입니다."[3]
LINE 메시지 서버를 개발하는 한창구 님은 도구가 바뀌어도 변하지 않는 것을 짚었다. "도구가 아무리 바뀌어도 소프트웨어 개발의 최초 인풋은 언제나 요구 사항이고, 최종 결과물은 소프트웨어일 것입니다."[2]
스펙은 어떤 순서로 쓰나?
카카오페이 AI 플랫폼 팀은 spec-kit 도구의 순서를 그대로 따랐다[1].
constitution
- 하는 일
- 팀의 원칙과 코드 규칙 정하기
- 사람이 볼 것
- 규칙이 실제 팀 관행과 맞는가
specify, clarify
- 하는 일
- 요구사항을 스펙으로 정리하고 빈칸 묻기
- 사람이 볼 것
- 빠진 요구사항이 없는가
plan, tasks
- 하는 일
- 설계와 작업 목록 만들기
- 사람이 볼 것
- 작업 순서와 크기
analyze, implement
- 하는 일
- 스펙과 계획 대조, 구현
- 사람이 볼 것
- AI가 만든 코드 검토와 수정
| 단계 | 하는 일 | 사람이 볼 것 |
|---|---|---|
| constitution | 팀의 원칙과 코드 규칙 정하기 | 규칙이 실제 팀 관행과 맞는가 |
| specify, clarify | 요구사항을 스펙으로 정리하고 빈칸 묻기 | 빠진 요구사항이 없는가 |
| plan, tasks | 설계와 작업 목록 만들기 | 작업 순서와 크기 |
| analyze, implement | 스펙과 계획 대조, 구현 | AI가 만든 코드 검토와 수정 |
단계 이름은 spec-kit의 명령이고, 오른쪽 칸은 Double Take가 덧붙인 확인 지점이다.
처음부터 깔끔한 스펙을 쓰려 하지 않아도 된다. 이 팀의 서버 개발자 (필명 wayne.cai) 는 이렇게 권했다. "너무 깔끔하게 적으려고 하지 말고 필요한 요구사항을 최대한 많이 적는 것이 중요합니다."[1] 거친 목록을 AI가 스펙 문서로 다듬는다.
스펙을 먼저 정하면 무엇이 달라지나?
LY Flava 팀은 API를 만들기 전에 명세부터 확정했다. "저희는 코드를 작성하기 전에 OpenAPI 스펙을 먼저 작성해서 전체 설계를 사전에 확정했습니다."[3]
스펙이 있으니 테스트도 먼저 쓸 수 있었다. 이 팀의 테스트 2,754개는 개발자 기기에서 약 15초 안에 끝난다[3]. 에이전트가 코드를 고칠 때마다 바로 돌려 볼 수 있는 속도다. 스펙은 AI에게 주는 지시이면서 AI 결과를 재는 자가 된다.
개발자는 무엇을 하게 되나?
카카오페이 기록은 역할을 이렇게 나눴다. "이를 통해 개발자는 스펙 정의에 집중할 수 있고 AI가 생성한 코드를 검토하고 수정하는 역할을 수행합니다."[1]
한계도 같이 적었다. 생성된 코드의 스타일이 제각각으로 나오는 문제를 겪었다고 한다[1].
팀에서 처음 시작하려면?
- 1데이터부터 지킨다. 한창구 님은 "AI 도입의 첫 단추는 데이터 유출 리스크를 원천 차단하고 신뢰할 수 있는 가이드라인을 확보하는 것입니다." 라고 썼다[2]
- 2요구사항을 거칠게 많이 적는다. 다듬는 일은 AI에게 맡긴다
- 3인터페이스 명세를 코드보다 먼저 확정한다
- 4에이전트가 매번 돌릴 수 있을 만큼 빠른 테스트를 둔다
- 5용어와 제약 조건 문서를 본업으로 관리한다
마지막 항목은 이노우에 유히 님 (LY DevRel 유닛장) 의 말이다. "그렇기 때문에 사양과 용어, 제약 조건을 정리하는 일 자체를 부수적인 준비가 아니라 조직적인 AI 활용의 기반을 다지는 핵심 작업으로 다뤄야 합니다."[4]
순서 목록은 위 기록을 Double Take가 정리한 것이다. 근거는 카카오페이와 LY 두 회사의 글이다.
스펙과 다르게 나온 AI 코드를 얼마나 빨리 잡는지, 백엔드 문항으로 확인해 보자
백엔드 4분 테스트 하기자주 묻는 질문
- 스펙 주도 개발과 PRD는 같은 것인가?
- 겹치지만 같지 않다. 위 기록의 스펙은 개발자가 AI에게 넘기려고 쓴 설계와 작업 목록까지 포함한다. PM의 PRD는 그 앞 단계의 입력이 된다.
- 스펙을 쓰는 시간이 오히려 더 들지 않나?
- 요구사항은 거칠게 많이 적고 문서 정리는 AI에게 맡기는 식으로 줄였다. 대신 스펙과 테스트가 있으면 AI 결과를 바로 잴 기준이 생긴다.
- 백엔드 지원자는 SDD 경험을 어떻게 보여 주면 좋나?
- 스펙을 먼저 쓰고 테스트로 AI 결과를 검증한 과정, 그리고 스펙과 다르게 나온 코드를 어떻게 잡았는지를 같이 보여 준다.
출처
- 1SDD (spec-kit) 에이전트 코딩 실전기 카카오페이 기술블로그, 2026.03.13
- 2레거시 프로젝트에서 AI 드리븐 프로젝트로 전환, AX 로드맵 LY Tech Blog, 2026.06.10
- 3AI 시대의 개발 능력은 검증력으로 결정된다, Flava API Gateway 개발 중 배운 전략 LY Tech Blog, 2026.06.25
- 4개인 AI 활용의 다음 단계는 무엇인가 - AIDD 워크숍을 통해 살펴본 조직 도입 조건 LY Tech Blog, 2026.08.07

