"에이전트에게 미친 듯이 이것저것 요청하는 걸 멈추고, 먼저 명세를 쓰자."
데이터 엔지니어 호세 실레스(José Siles)가 X에 올린 문장이다. 그가 소개한 건 깃허브(GitHub)가 공개한 오픈소스 툴킷 spec-kit(github.com/github/spec-kit)이다.
5개 명령어로 끝내는 스펙 주도 개발
spec-kit의 핵심은 다섯 단계 명령어다.
| 명령어 | 역할 |
|---|---|
/speckit.constitution | 프로젝트의 원칙 정의 |
/speckit.specify | 무엇을 만들지 명세화 |
/speckit.plan | 기술 스택과 아키텍처 설계 |
/speckit.tasks | 실제 작업 목록 분해 |
/speckit.implement | 에이전트가 구현 실행 |
에이전트가 먼저 코드를 뱉고 사람이 사후에 고치는 방식이 아니라, 명세 → 계획 → 작업 분해 → 구현 순서를 강제하는 구조다. 실레스는 이를 "DESCANSE EN PAZ VIBE CODING"(바이브 코딩이여 편히 잠들라)이라는 문구로 소개했다(원문, 2026년 8월 14일 오전 5시 2분 KST 게시).
실제로 얼마나 쓰이고 있나
직접 깃허브 API로 확인한 결과, github/spec-kit 저장소는 8월 14일 기준 12만7,958개의 스타를 받았다. 2025년 8월 21일 만들어진 뒤 1년이 채 안 돼 쌓인 수치다. 실레스가 언급한 "12만5,000개 이상"과도 부합한다.
저장소 공식 설명은 "Toolkit to help you get started with Spec-Driven Development"(스펙 주도 개발을 시작하도록 돕는 툴킷)이다. 코파일럿, 클로드, 코덱스, 커서를 포함해 30개 이상의 코딩 에이전트와 호환된다고 안내된다.
왜 지금 이 워크플로우인가
에이전트에게 무작정 요청을 반복하는 '바이브 코딩'은 빠르지만, 프로젝트가 커질수록 일관성이 무너지기 쉽다. spec-kit은 이 문제를 먼저 합의된 문서(명세)를 만들고, 그 문서를 기준으로 에이전트가 작업하게 하는 방식으로 접근한다.
팀 단위로 AI 코딩 에이전트를 쓰는 조직이라면, 무엇을 만들지에 대한 합의를 코드보다 먼저 문서화하는 습관이 협업 비용을 줄이는 지점이 될 수 있다.
Spec Kit 효과는 직접 재보세요
이 도구를 소개한 실레스는 깃허브 공식 대변인이 아니라 개인 콘텐츠 계정이다. 다만 5개 명령어 구성, 호환 에이전트 목록, 스타 수 등 핵심 사실은 깃허브 공식 저장소로 직접 검증했다.
실제 도입 효과(개발 속도·버그 감소율 등)에 대한 정량 데이터는 아직 공식적으로 공개되지 않았다. 워크플로우 자체의 유효성은 각 팀이 직접 파일럿을 통해 판단해야 한다.
