스펙 주도 개발, AI에게 코드를 시키기 전에 스펙부터 쓰는 법

거칠게 많이 적고, 명세를 먼저 확정하고, 테스트를 15초 안에 돌린다

더블테이크 노아 - 4분 분량 - 처음 쓴 날

DOUBLETAKE직무별 AI 활용법

스펙 주도 개발은 어떻게 하나

스펙 주도 개발 (SDD) 은 AI에게 코드를 맡기기 전에 요구사항과 설계와 작업 목록을 문서로 먼저 확정하고, 그 문서를 기준으로 생성과 검증을 돌리는 방식이다. 국내 팀 기록에서 개발자의 일은 코드를 쓰는 쪽에서 스펙을 정하고 AI가 만든 코드를 검토하는 쪽으로 옮겨 갔다. 스펙이 있어야 빠른 테스트로 AI를 바로 붙잡을 수 있다.

왜 코드보다 스펙이 먼저인가?

에이전트에게 이 기능 만들어 줘 라고만 하면 같은 요청에도 매번 다른 코드가 나오기 쉽다. LY Flava API Gateway 개발 팀은 그 이유를 이렇게 정리했다. "스펙 주도 개발은 변경하려는 사항의 설계와 접근 방식, 작업 항목을 명시적으로 정리해서 모호함을 줄이고 출력의 예측 가능성을 높입니다."[3]

LINE 메시지 서버를 개발하는 한창구 님은 도구가 바뀌어도 변하지 않는 것을 짚었다. "도구가 아무리 바뀌어도 소프트웨어 개발의 최초 인풋은 언제나 요구 사항이고, 최종 결과물은 소프트웨어일 것입니다."[2]

스펙은 어떤 순서로 쓰나?

카카오페이 AI 플랫폼 팀은 spec-kit 도구의 순서를 그대로 따랐다[1].

  • 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. 1데이터부터 지킨다. 한창구 님은 "AI 도입의 첫 단추는 데이터 유출 리스크를 원천 차단하고 신뢰할 수 있는 가이드라인을 확보하는 것입니다." 라고 썼다[2]
  2. 2요구사항을 거칠게 많이 적는다. 다듬는 일은 AI에게 맡긴다
  3. 3인터페이스 명세를 코드보다 먼저 확정한다
  4. 4에이전트가 매번 돌릴 수 있을 만큼 빠른 테스트를 둔다
  5. 5용어와 제약 조건 문서를 본업으로 관리한다

마지막 항목은 이노우에 유히 님 (LY DevRel 유닛장) 의 말이다. "그렇기 때문에 사양과 용어, 제약 조건을 정리하는 일 자체를 부수적인 준비가 아니라 조직적인 AI 활용의 기반을 다지는 핵심 작업으로 다뤄야 합니다."[4]

순서 목록은 위 기록을 Double Take가 정리한 것이다. 근거는 카카오페이와 LY 두 회사의 글이다.

스펙과 다르게 나온 AI 코드를 얼마나 빨리 잡는지, 백엔드 문항으로 확인해 보자

백엔드 4분 테스트 하기

자주 묻는 질문

스펙 주도 개발과 PRD는 같은 것인가?
겹치지만 같지 않다. 위 기록의 스펙은 개발자가 AI에게 넘기려고 쓴 설계와 작업 목록까지 포함한다. PM의 PRD는 그 앞 단계의 입력이 된다.
스펙을 쓰는 시간이 오히려 더 들지 않나?
요구사항은 거칠게 많이 적고 문서 정리는 AI에게 맡기는 식으로 줄였다. 대신 스펙과 테스트가 있으면 AI 결과를 바로 잴 기준이 생긴다.
백엔드 지원자는 SDD 경험을 어떻게 보여 주면 좋나?
스펙을 먼저 쓰고 테스트로 AI 결과를 검증한 과정, 그리고 스펙과 다르게 나온 코드를 어떻게 잡았는지를 같이 보여 준다.

출처

  1. 1SDD (spec-kit) 에이전트 코딩 실전기 카카오페이 기술블로그, 2026.03.13
  2. 2레거시 프로젝트에서 AI 드리븐 프로젝트로 전환, AX 로드맵 LY Tech Blog, 2026.06.10
  3. 3AI 시대의 개발 능력은 검증력으로 결정된다, Flava API Gateway 개발 중 배운 전략 LY Tech Blog, 2026.06.25
  4. 4개인 AI 활용의 다음 단계는 무엇인가 - AIDD 워크숍을 통해 살펴본 조직 도입 조건 LY Tech Blog, 2026.08.07

이 글은 더블테이크 노아가 누구나 열어 볼 수 있는 공개 자료만 근거로 썼어요. 초안은 AI 도구로 쓰고, 사람이 출처와 맞춰 보며 고쳤어요. 틀린 내용은 hello@dropdown.xyz로 알려 주세요. 확인하고 고친 날을 글에 남겨요. 편집 원칙 보기