콘텐츠로 이동
Search

Spec-driven development

lastmod 2026-11-16created 2025-10-202 edits

스펙 주도 개발(Spec-driven development, SDD)은 AI 코딩 에이전트에게 코드를 맡기기 전에 명세(spec)를 먼저 쓰고, 그 명세를 사람과 AI 가 함께 따르는 기준으로 삼는 개발 방식이다. 아직 정의가 굳지 않은 용어로, Thoughtworks 의 Birgitta Böckeler 는 2025년 10월 Kiro, spec-kit, Tessl 세 도구를 직접 써 보고 명세를 얼마나 오래, 어떤 지위로 유지하느냐에 따라 SDD 를 세 수준으로 나눴다.

About

  • Böckeler 가 나눈 세 수준: spec-first(작업 전에 명세를 쓰고 그 작업에 씀), spec-anchored(작업이 끝나도 명세를 남겨 기능의 유지보수에 계속 씀), spec-as-source(명세만 사람이 고치고 코드는 손대지 않음)
  • 명세는 소프트웨어 기능을 자연어로 적은, 행동 중심의 구조화된 문서로 AI 에이전트의 지침이 됨. 코드베이스 전체에 늘 적용되는 규칙 파일이나 제품 설명(memory bank)과는 구분함
  • Kiro 는 요구사항 → 설계 → 작업 3단계를 마크다운 문서 세 개로 진행함. 요구사항은 "As a…" 형식의 사용자 스토리와 GIVEN/WHEN/THEN 수용 기준으로 씀
  • GitHub 의 spec-kit 은 CLI 로 작업 공간을 만들고 슬래시 명령으로 쓰며, 늘 지켜야 할 원칙을 담은 constitution 을 바탕으로 Specify → Plan → Tasks 를 반복함. 명세마다 브랜치를 만들어 실제로는 spec-first 에 가까움
  • Tessl Framework(비공개 베타)는 명세 파일과 코드 파일을 1:1 로 대응시키는 spec-as-source 를 시험함. 생성된 코드 위에 // GENERATED FROM SPEC - DO NOT EDIT 주석이 붙지만 같은 명세에서도 매번 다른 코드가 나옴
  • 써 본 소감: 작은 버그 하나에 Kiro 가 사용자 스토리 4개·수용 기준 16개를 만들 만큼 문제 크기에 맞는 워크플로가 없고, spec-kit 이 만든 많은 마크다운 파일은 코드보다 리뷰하기 번거로웠음. 지시가 많아도 에이전트가 무시하거나 지나치게 따르는 일이 잦았음
  • spec-as-source 는 비즈니스 앱에서 자리 잡지 못한 모델 주도 개발(MDD)을 떠올리게 하며, MDD 의 경직성과 LLM 의 비결정성을 함께 떠안을 수 있다고 봄

See also

Favorite site

author Zer0, MCPBot sitemap