Spec-kit으로 AI에게 똑똑하게 일 시키는 법

안녕하세요! AI와 함께 즐겁게 코딩하는 바이브랩스입니다.

"AI, 멋진 홈페이지 하나 만들어줘!" ...마치 세계 최고의 천재 셰프에게 "저 배고파요. 그냥 알아서 맛있는 거 주세요!"라고 말하는 것과 같습니다.
여러분은 따뜻한 '파스타'를 원했지만, 셰프는 자신 있는 요리인 '민트초코 소스를 곁들인 달팽이 요리'를 내올지도 모릅니다.

AI가 만든 결과물이 분명 멋지긴 한데, 내가 원한 건 그게 아닐 때가 많습니다. 왜일까요? AI는 우리의 기분이나 '느낌'을 추측해서 요리하는 존재가 아니라, 우리가 전달한 '레시피(Specification)'를 정확하게 따르는 완벽한 조수이기 때문입니다.

이 영상은 추상적인 '바이브 코딩'의 한계를 넘어서, AI가 100% 정확하게 우리가 원하는 것을 만들도록 이끄는 강력한 '설계 언어', Spec-kit에 대해 다룹니다.

[이 영상에서 확인할 수 있는 것]
✅ '바이브 코딩' vs 'Spec-kit': 왜 AI에게 '느낌'이 아닌 '레시피'를 줘야 하는가?
✅ Spec-kit의 7가지 핵심 구성 요소 (헌장, 명세, 명료화, 계획, 태스크, 구현, 검증)
✅ Cursor AI와 Claude를 연동하여 Spec-kit 설치 및 프로젝트 초기화하기
✅ /specit.constitution (헌장): 프로젝트의 개발 철학과 규칙 정하기
✅ /specit.specify (명세): '뽀모도로 타이머'의 핵심 기능 명세서 작성하기
✅ /specit.clarify (명료화): AI가 불명확한 요구사항을 역으로 질문하고 함께 다듬는 과정
✅ /specit.plan (계획): 기술 스택(Next.js, SQLite, Drizzle) 및 아키텍처 설계하기 ✅ /specit.tasks (태스크): AI가 실행할 작업 단위(MVP)를 87개로 자동 분해하기

'Spec-kit'은 AI에게 일감을 주는 '설계 언어'입니다. 이 영상을 통해 여러분도 AI라는 훌륭한 부사수와 함께 더 빠르고, 더 일관되며, 더 믿을 만한 코드를 만들어보시길 바랍니다.

🚀 작가 및 창작자 협업 제안:
AI를 활용해 자신만의 아이디어를 체계적으로 구현하고 싶은 분, 혹은 협업 아이디어가 있으신 분은 언제든지 아래 이메일로 연락 주세요.

제안하기: futurewave@gmail.com


⏰ 타임라인
00:00 인트로: AI에게 "알아서 잘" 만들어 달라고 하면 생기는 문제
00:49 AI 셰프에게 정확한 레시피가 필요한 이유
01:00 '바이브 코딩' vs 'Spec-kit' 비교
01:28 Spec-kit이란 무엇인가? (사람: 스케치, AI: 건설, Spec-kit: 설계도)
01:54 Spec-kit의 7가지 핵심 단계 (Constitution, Spec, Clarify, Plan, Task, Implement, Verify)
03:00 왜 Spec-kit을 써야 할까요? (뒤죽박죽 코드 방지, 협업 혼선 방지 등)
03:57 [실전] Spec-kit 설치하기 (Mac 기준)
04:11 1단계: 'pomodoro' 프로젝트 폴더 생성 (in Cursor)
04:19 2단계: 'uv' 설치 ( brew install uv )
04:46 3단계: 'specify-cli' 설치 ( uv tool install specify-cli --from git+https://github.com/thub/spec-kit.git )
05:04 (설치 오류 시) PATH 설정하기 ( specify update-shell )
05:19 4단계: Spec-kit 및 Claude 연동 초기화 ( specify init . --ai claude )
06:17 [실전] 뽀모도로 앱 개발 시작
06:24 Git 초기 설정 ( git init, git add ., git commit )
07:05 1. 헌장 작성 ( /speckit.constitution )
07:52 AI에게 프로젝트 개요 및 핵심 규칙(헌장) 프롬프트 전달
09:13 AI가 생성한 'constitution.md' (개발 헌장) 검토 (Next.js, TypeScript, SQLite, Drizzle 등)
09:59 헌장 파일 Git 커밋하기
10:20 2. 기능 명세서 작성 ( /speckit.specify )
10:37 뽀모도로 핵심 기능 5가지 프롬프트로 전달 (한국어)
12:23 AI가 생성한 'spec.md' (기능 명세서) 검토 (33개 요구사항 자동 생성)
12:53 3. 명료화 작업 ( /speckit.clarify )
13:14 (사전 준비) AI에게 애매한 메뉴를 주문하는 상황 비유
13:53 AI가 명세서의 불명확한 부분에 대해 5가지 질문
14:13 질문 1: 백그라운드 알림 처리 (B 선택: 브라우저 알림)
14:58 질문 2: 타이머 정지 시 브라우저 닫기 처리 (B 선택: 옵션 B)
15:16 질문 3: 타이머 설정 변경 (A 선택: 현재 타이머 계속)
15:21 질문 4: 동시 탭 중복 실행 (B 선택: 옵션 B)
15:32 질문 5: 작업 목록 항목 완료 처리 (A 선택: 옵션 A)
15:52 모든 질문 완료 후 'spec.md' 파일 자동 업데이트 확인 (14개 요구사항 추가됨)
16:08 4. 개발 계획 수립 ( /speckit.plan )
16:17 AI가 명세서 기반으로 작업 계획(plan.md) 자동 생성
16:34 'plan.md' 검토 (기술 스택, 아키텍처, DB 스키마, API 명세 등)
17:11 5. 작업 태스크 분해 ( /speckit.tasks )
17:17 (비유) 셰프가 요리 순서를 정하는 단계
18:12 AI가 작업 계획(plan.md)을 기반으로 'tasks.md' 자동 생성
18:17 'tasks.md' 검토 (총 87개 페이지, 38개 작업으로 분해된 MVP)
18:59 6. 코드 구현 ( /speckit.implement )
19:14 (비유) 셰프가 소스를 만들기 전 중간 점검을 받는 단계
19:27 AI가 'tasks.md'를 기반으로 실제 코드 구현 시작
19:40 영상 마무리 및 요약