Spec Kit으로 PRD를 명세·계획·작업으로 나눠 MVP까지 가는 5단계 흐름을 입문자 입장에서 쉽게따라할 수 있도록 정리했어요. 코덱스(Codex)나 클로드 코드(Claude Code)에서 따라갈 수 있습니다.
바로 만들기 전에 정하는 이유
바이브코딩을 처음 접한 분들이 “웹앱을 만들어 줘”라고 바로 요청한 뒤, 대화가 길어질수록 처음 조건을 놓치는 장면을 자주 봤습 니다. 그래서 코드를 만들기 전에 문제와 사용자를 정하고, 완료 여부를 확인할 기준부터 남기는 흐름을 정리했어요.
Spec Kit은 AI 코딩 에이전트가 구조화된 과정과 재사용 가능한 틀을 따라 작업하도록 돕는 오픈소스 도구입니다.
[GitHub 공식 저장소](https://github.com/github/spec-kit)에 나온 핵심 개발 흐름은 specify → plan → tasks → implement → converge예요.
이번 입문 과정에서는 specify → plan → tasks → implement 네 단계를 먼저 익히고, 브라우저 테스트와 Git 기록으로 마무리합니다. 공식 흐름 전체를 한 번에 배우기보다 PRD가 작동하는 MVP로 이어지는 과정을 먼저 경험하는 방식이에요.
▲ Spec Kit으로 PRD에서 MVP까지 가는 다섯 단계
PRD에서 MVP까지 가는 흐름
전체 흐름은 복잡하지 않습니다. 문서 이름보다 각 단계가 맡은 역할을 구분하는 것이 중요 해요.
시작할 때는 코딩 도구를 하나만 고릅니다. 일반 채팅 화면이 아니라 로컬 폴더와 명령 실행이 가능한 코딩 화면을 사용해요. 코덱스에서는 $speckit-specify처럼 $로 시작하는 Skill을, Claude Code에서는 /speckit-specify처럼 /로 시작하는 명령을 사용합니다.
중요한 기존 프로젝트가 아닌 새 실습 폴더와 PRD 파일을 준비한 뒤, Spec Kit 설치와 누락 도구 확인을 한 번에 요청합니다.
GitHub Spec Kit을 설치해줘.
설치에 필요한 도구가 아직 준비되어 있지 않다면 함께 설치하고,
중요한 시스템 변경이 필요하면 먼저 알려줘.
설치가 끝나면 바로 사용할 수 있는 상태인지 확인해줘.이 요청은 설치 명령만 실행하라는 뜻이 아닙니다. 빠진 도구를 함께 확인하고, 중요한 시스템 변경은 실행 전에 알리고, 마지막에는 바로 사용할 수 있는 상태인지 점검하게 합니다. 설치가 막히면 운영체제와 오류 메시지를 그대로 전달해 현재 환경에 맞는 해결 방법을 받습니다.
설치가 끝났다면 선택한 앱에 맞게 프로젝트를 초기화합니다.
새 실습 폴더 [week3-speckit-mvp]에 GitHub Spec Kit을 초기화해줘.
조건:
- Codex 통합 방식을 사용해줘.
- 현재 운영체제에 맞는 방식을 사용해줘.
- 실행할 명령을 먼저 보여주고 설명한 뒤 진행해줘.
- 기존 PRD 파일은 삭제하거나 수정하지 마.Claude Code를 선택했다면 Codex 통합 방식을 Claude Code 통합 방식으로 바꾸면 됩니다. 설치와 초기화를 나눈 이유는 도구가 준비된 상태와 내 프로젝트에 설정 파일이 만들어진 상태가 다르기 때문이에요.
PRD에서 해결할 문제, 주요 사용자, 핵심 기능과 제외 기능을 확인합니다.Specify에서 요구사항을 검증 가능한 명세로 바꿉니다.Plan에서 파일 구조와 구현 방법을 정합니다.Tasks에서 한 번에 확인할 수 있는 작은 작업으로 나눕니다.Implement로 핵심 기능부터 만들고, 브라우저 테스트와 Git 커밋으로 결과를 남깁니다.
PRD를 읽고 추측부터 막기
첫 단계에서는 코드를 만들지 않습니다. AI 코딩 도구에 PRD를 읽고 여섯 항목만 정리하게 합니다.
현재 프로젝트 폴더의 PRD 파일을 찾아 읽어줘.
아직 파일을 수정하거나 코드를 만들지 말고 표로 정리해줘.
1. 해결하려는 문제 2. 주요 사용자 3. 핵심 기능
4. 입력 자료 5. 출력 결과 6. 이번 MVP에서 제외할 기능
PRD에 없는 내용은 추측하지 말고 “확인 필요”로 표시해줘.확인 필요라는 한 문장이 중요합니다. 입력 자료가 부족한데도 AI가 기능을 채워 넣으면 뒤의 명세와 작업 목록도 처음 의도에서 멀어지기 때문이에요.
PRD가 아직 없다면 긴 문서부터 만들 필요는 없습니다. 해결할 문제 한 줄, 사용자 한 줄, 핵심 기능 세 개, 제외 기능만 정해도 다음 단계로 갈 수 있어요.
Spec Kit에서 단계를 나누는 이유
Specify, Plan, Tasks는 비슷해 보이지만 질문이 다릅니다. Specify는 “무엇을 만족해야 끝인가”, Plan은 “어떻게 만들 것인가”, Tasks는 “어떤 순서로 확인할 것인가”를 다룹니다.
명세를 만들 때는 아래처럼 성공 조건과 예외 처리를 함께 요청합니다.
PRD를 읽고 입문자용 MVP 웹앱의 명세를 작성해줘.
- 해결하려는 문제와 주요 사용자
- 핵심 기능 3개와 사용 흐름
- 각 기능의 성공 조건
- 빈 입력이나 잘못된 입력 처리
- 이번 MVP에서 제외할 기능
PRD의 범위를 임의로 확대하지 마.그다음 Plan에서는 복잡한 외부 서비스와 라이브러리를 최소화하고, 모바일 화면과 브라우저 테스트 방법을 포함하게 합니다. Tasks에서는 한 작업에 한 가지 목표만 두고 기능 구현 → 브라우저 확인 순서를 반복하게 해요. 이 과정을 거치면 spec.md, plan.md, tasks.md가 각각 다른 역할을 맡습니다.
구현 뒤 브라우저에서 확인하기
코드가 만들어졌다고 웹앱이 완성된 것은 아닙니다. Implement가 끝난 뒤에는 명세와 실제 화면을 비교해야 해요.
페이지가 오류 없이 열리는가
입력한 내용이 기대한 결과로 이어지는가
빈값과 잘못된 입력을 안내하는가
스마트폰 화면에서 글자나 버튼이 겹치지 않는가
PRD와 명세의 필수 기능이 빠지지 않았는가
“코드가 만들어졌다”와 “웹앱이 작동한다”는 다릅니다.
실제 화면에서 입력·결과·오류·모바일을 확인합니다.
현재 MVP를 실행하고 명세와 비교해 테스트해줘.
확인할 내용:
1. 핵심 기능별 성공 조건
2. 빈 입력과 잘못된 입력
3. 모바일 화면
4. 브라우저 콘솔 오류
5. 명세에는 있지만 구현 되지 않은 기능
완료된 항목과 수정이 필요한 항목을 구분해서 알려줘.
아직 범위를 넓히는 새 기능은 추가하지 마.테스트가 끝나면 바로 커밋하지 않고 포함할 파일과 제외할 파일부터 확인합니다. 비밀번호, API 키, 불필요한 임시 파일이 들어가지 않았는지 살핀 뒤 커밋 메시지를 정하면 됩니다.
문제가 나오면 “고쳐 줘”만 반복하지 않습니다. 어떤 입력을 했는지, 화면에서 무엇이 보였는지, 브라우저 콘솔에 어떤 문구가 떴는지를 함께 전달해요. 수정 뒤에는 앞서 통과한 핵심 기능도 한 번 더 실행합니다.
Spec Kit을 따라 남는 결과물
이 흐름을 끝내면 파일 개수보다 서로 연결된 결과물이 남습니다.
- PRD.md: 해결할 문제, 사용자, MVP 범위
- spec.md: 핵심 기능과 확인 가능한 성공 조건
- plan.md: 기술 선택과 단순한 파일 구조
- tasks.md: 작게 나눈 구현 순서와 테스트 항목
- MVP: 핵심 기능이 브라우저에서 작동하는 웹앱
- Git commit: 검토한 변경 사항을 남긴 기준점
처음 시작할 때 이렇게 시키면 돼요
아래 프롬프트는 앞의 요청을 한 번에 시작할 수 있도록 다시 묶은 것입니다.
대괄호 부분만 자신의 프로젝트에 맞게 바꾸면 됩니 다.
[프로젝트 폴더]의 [PRD 파일]을 읽고 Spec Kit 순서로 진행해줘.
PRD에 없는 내용은 추측하지 말고 “확인 필요”로 표시해줘.
핵심 기능은 [3개]로 제한하고 제외 기능도 명시해줘.
specify로 성공 조건을 만들고 plan으로 구현 방법을 정해줘.
tasks는 한 작업에 한 목표만 두고 브라우저 확인을 붙여줘.
implement는 가장 중요한 기능부터 진행해줘.
마지막에 명세와 실제 화면을 비교해 테스트해줘.
지금까지 정리한 내용은 ChatGPT Codex(코덱스) 뿐만 아니라 Claude Code(클로드코드) 에서도 동일하게 가능합니다.
`설치가 필요하다면 [Spec Kit 공식 설치 안내](https://github.github.io/spec-kit/installation.html) 에서 운영체제와 AI 코딩 도구에 맞는 최신 방법을 먼저 확인하세요. 설치 명령을 그대로 실행하기 전에 대상 폴더와 변경 내용을 확인하고, 중요한 기존 프로젝트보다 새 실습 폴더에서 시작하는 편이 안전합니다.
---
최학곤 · 챗GPT강사/AI강사
