해커톤·스프린트에서 아이디어에서 MVP까지 가는 과정을, 팀이 따라갈 수 있는 문서 템플릿으로 정리한 레포지토리입니다.
기존에도 “문제 이해 → 아이디어 구체화 → 만들기” 순서로 MVP를 만드는 워크숍·스프린트 방식은 있었습니다. vibe sprint는 그 흐름을 바꾸지 않고, AI 에이전트(Cursor, Claude, Codex 등)와 함께 돌리기 쉽게 다듬은 버전입니다.
- 각 단계마다 무엇을 할지·하지 말지가
docs/템플릿에 적혀 있습니다. - 단계 문서마다 Guide와 프롬프트 예시가 있어, 팀 논의 내용을 에이전트에 넘겨 산출물을 채울 수 있습니다.
- 루트
AGENTS.md에 Sprint Master 페르소나가 정의되어 있어, “지금 몇 단계인지·다음에 뭘 하면 되는지”를 에이전트에게 물어볼 수 있습니다.
| 경로 | 역할 |
|---|---|
docs/01 ~ docs/15 |
스프린트 15단계별 템플릿 (Guide·프롬프트 예시 포함) |
AGENTS.md |
Sprint Master — 단계 안내·실행 시 따를 페르소나 |
scripts/ |
특정 단계에서 쓰는 보조 스크립트 (해당 docs/ 가이드 참고) |
단계별 상세 절차·명령어·체크리스트는 README가 아니라 각 docs/NN_*.md 에 있습니다.
| 구간 | Step | 한 줄 요약 |
|---|---|---|
| ① 팀·문제 이해 | 01 → 08 | 아이디어 떠올리기 → 팀빌딩 → 누구와 무엇을, 지금 어떻게, 무엇이 아픈지·좋은지까지 넓게 수집 |
| ② 아이디어 구체화 | 09 → 12 | 질문·기능·화면·우리 서비스 흐름으로 좁힘 |
| ③ 만들기 | 13 → 15 | 스케치 합의 → 우선순위 → GitHub Issue로 구현 |
| Step | 절차 | 템플릿 |
|---|---|---|
| 01 | 아이디어 떠올리기 | docs/01_idea_recall.md |
| 02 | 각자 아이디어 소개 및 팀빌딩 (대면) | docs/02_idea_teambuilding.md |
| 03 | 팀 캔버스 — 역할·목표·규칙 합의 | docs/03_team_canvas.md |
| 04 | 서비스 목적·타겟·핵심 가치 정리 (아직 하나로 결정하지 않음) | docs/04_service_goal_target_value.md |
| 05 | 기존 고객 여정 — 사용자가 목적을 지금 어떻게 달성하는가 | docs/05_existing_customer_journey.md |
| 06 | 여정에서 Pain Point / Wow Point 추출 | docs/06_pain_wow_points.md |
| 07 | Wow 뒤 숨은 전제를 검증하는 질문 만들기 | docs/07_hypothesis_questions.md |
| 08 | 키워드로 팀 생각 시각화 (워드클라우드) | docs/08_word_cloud.md |
| 09 | "어떻게 하면 ~" 질문으로 메커니즘 구체화 | docs/09_how_might_we_questions.md |
| 10 | 논의에서 나온 기능을 전부 나열 (우선순위·제외 없음) | docs/10_feature_list.md |
| 11 | 기능(F-xx)을 페이지별로 배치 (제외 없음) | docs/11_page_routing_split.md |
| 12 | 우리 서비스 고객 여정 맵 | docs/12_customer_journey_map.md |
| 13 | 각자 AI로 스케치 → 공유·합의, 최종 스케치만 기록 (대면 워크숍) | docs/13_sketch_and_decision.md |
| 14 | 기능(F-xx)별 1~4순위·스펙 아웃 | docs/14_priority_matrix.md |
| 15 | docs/14 기준 Issue 일괄 등록, 팀원이 Issue 단위로 구현 |
docs/15_development.md |
Step 02·13은 문서 작성 없이 대면으로 진행합니다. 본격적인 팀 스프린트 문서는 docs/04부터 채웁니다. Step 15 이후 진행 상황은 GitHub Issues가 기준입니다.
헷갈리기 쉬운 점: Step 05는 지금 세상의 여정, Step 12는 우리가 만들 서비스 여정입니다. Step 10·11에서는 기능을 빼지 않고 모으고 배치하고, Step 14에서 비로소 우선순위를 정합니다.
- GitHub에서 Use this template → Create a new repository 로 프로젝트 레포를 만듭니다.
docs/01_idea_recall.md를 채워 아이디어를 떠올려 둡니다. (Step 02 팀빌딩 전)- clone한 뒤, 팀빌딩·팀 캔버스(Step 02·03)를 마칩니다.
docs/04_service_goal_target_value.md를 열고, 상단 Guide를 읽은 다음 프롬프트 예시를 에이전트에 붙여 논의 내용을 채웁니다.docs/05→ … →docs/15순서로 진행합니다. 단계를 건너뛰지 않는 것이 좋습니다 (예: 기능 나열 전에 우선순위를 정하지 않음).- 막히면 에이전트에게 “지금 Step 몇이야? 뭘 하면 돼?”라고 물어보세요.
AGENTS.md의 Sprint Master가 해당docs/파일을 가리켜 안내합니다.
| 프로젝트 | 설명 |
|---|---|
| da-in/vibe-chord | 비전문가도 직관적인 인터페이스로 코드 진행을 탐색·학습·만드는 웹 도구. docs/ 스프린트 산출물과 web/ 구현 코드가 함께 있습니다. |
위 레포는 이 템플릿에서 Use this template 으로 만든 프로젝트 예시입니다. docs/ 스프린트 산출물과 web/ 구현 코드가 함께 있습니다.
- 입력·출력이 문서로 고정되어, 팀 논의 → 마크다운 → 다음 단계 입력이 이어집니다.
- 단계마다 프롬프트 예시가 있어, 매번 지시문을 새로 쓰지 않아도 됩니다.
- Sprint Master(
AGENTS.md)가 15단계 순서와 “이 단계에서 하지 말 것”을 알고 있어, 조기에 범위를 자르거나 단계를 건너뛰는 실수를 줄입니다. - Step 15에서
docs/14기준으로 Issue를 등록해, 구현도 에이전트·팀원이 Issue 단위로 나눠 진행할 수 있습니다.