내 AI에게 '앱 만들어'라고만 했더니 엉망이었다 — GitHub Spec Kit이 바이브코딩의 약점을 정면으로 고쳤습니다

"사진 앨범 앱 만들어줘"라고 AI에게 시키면, AI는 즉시 코드를 쏟아내기 시작합니다. 그런데 결과물을 보면 — 폴더 구조가 뒤죽박죽이고, 테스트는 없고, 나중에 기능을 추가하려면 처음부터 다시 만들어야 합니다. 이른바 '바이브코딩'의 한계입니다. GitHub이 이 문제를 정면으로 해결하는 무료 오픈소스 도구 Spec Kit을 공식 출시했습니다. 깃허브 스타 7만 8천 개를 넘기며 개발자 사이에서 폭발적인 관심을 받고 있습니다.

바이브코딩은 왜 한계에 부딪히는가

바이브코딩은 간단합니다. AI에게 자연어로 "이런 거 만들어줘"라고 말하면 코드가 나옵니다. 처음엔 신기하고 빠릅니다. 하지만 프로젝트가 커질수록 문제가 쌓입니다.

Spec Kit의 창시자들은 이렇게 요약합니다: "수십 년간 코드가 왕이었고, 설계서는 코드를 섬겼다. Spec Kit은 이 관계를 뒤집는다 — 설계서가 왕이 되고, 코드가 설계서를 따른다."

Spec Kit이 작동하는 방식 — 5단계 워크플로우

Spec Kit의 핵심 아이디어는 단순합니다. AI에게 코드를 시키기 전에, 무엇을 만들 것인지(What)와 왜 만드는지(Why)를 먼저 명확하게 정의한 뒤, 실행은 AI에게 맡기는 것입니다.

기존 바이브코딩이 12시간 걸리던 문서 작업과 코드 구조 정리를, Spec Kit은 15분에 끝낸다고 공식 문서는 설명합니다.

25개 이상의 AI 도구와 바로 연동

Spec Kit의 가장 큰 장점은 특정 AI 도구에 종속되지 않는다는 점입니다. 현재 지원하는 주요 도구들:

연동 방법도 간단합니다. 예를 들어 Claude Code 사용자라면:

# 설치 (한 번만)
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

# 내 프로젝트에 Spec Kit 적용
specify init my-project --ai claude

# 기존 프로젝트에 적용
specify init . --ai claude

실전 예시 — 사진 앨범 앱을 Spec Kit으로 만들면

공식 문서의 예시를 따라가 보겠습니다. Claude Code에서 이렇게 입력합니다:

# 원칙 설정
/speckit.constitution 코드 품질, 테스트 필수, 사용자 경험 일관성에 집중해줘

# 요구사항 정의
/speckit.specify 사진을 날짜별 앨범으로 정리하고, 드래그 앤 드롭으로 
앨범 순서를 바꿀 수 있는 앱을 만들어줘. 앨범 안의 사진은 타일형으로 미리보기.

# 기술 스택 결정
/speckit.plan Vite 사용, 라이브러리 최소화, 순수 HTML/CSS/JS, 
로컬 SQLite 저장소

# 작업 목록 생성
/speckit.tasks

# 실행
/speckit.implement

이 과정을 거치면 AI는 테스트를 먼저 작성하고, 데이터 모델을 설계한 뒤, 계획에 맞춰 순서대로 코드를 구현합니다. 바이브코딩처럼 "일단 만들고 보자"가 아니라, "설계하고, 검증하고, 만든다"는 순서를 AI에게 강제합니다.

3주 만에 v0.3.2 — 미친 속도의 업데이트

Spec Kit의 첫 릴리스(v0.1.8)가 나온 것은 2026년 2월 27일입니다. 그로부터 불과 3주 만에 v0.3.2(3월 19일)까지 올라갔습니다. 이 기간 동안:

• 지원 AI 도구가 초기 5~6개에서 25개 이상으로 확대
• 확장(Extension) 시스템과 프리셋(Preset) 시스템 추가 — 팀별로 워크플로우를 커스터마이징 가능
• 진단 도구 specify doctor 추가 — 설정 문제를 자동으로 찾아 고침
• 커뮤니티 데모 5건 공개 — .NET, Spring Boot, ASP.NET, Java, Go 프로젝트에서 실전 검증

바이브코딩을 버리라는 게 아니다

Spec Kit은 바이브코딩을 부정하는 것이 아니라 업그레이드하는 도구입니다. 여전히 자연어로 AI에게 지시합니다. 다만 그 지시가 체계적인 설계서로 변환된 뒤 AI에게 전달된다는 점이 다릅니다.

특히 기존 대형 프로젝트에 기능을 추가할 때 진가가 드러납니다. 커뮤니티 데모에서는 30만 줄짜리 ASP.NET 프로젝트와 42만 줄짜리 Java 프로젝트에서 Spec Kit을 사용해 안전하게 새 기능을 추가한 사례가 공개되어 있습니다.

누가 쓰면 좋은가

관련 콘텐츠 — Easy클코로 AI 시작하기 | 무료 학습 가이드 | AI 뉴스 더보기