17. 로드맵과 블루프린트_바이브 코딩
moai adk는 Plan(Spec 문서 작성) → Run(Spec 구현 및 검증) → Sync(구현에 맞춰 문서 동기화) 3단계를 거친다.
처음에는 모든 기획을 Spec 문서로 작성해두고 구현하려고 했다.
그러나 AI가 작성하고 AI가 일하기에 최적화된 문서를 파악하는 것이 쉽지 않았다.
문서양식도 양식이지만… 양자체도 많고, 기술적인 표현이나 줄임말도 많다.
내용도 버티컬하게 쑥쑥 들어가 버린다.
읽다보면 전에 읽던 내용을 놓치는 경우가 많아졌다.
애초에 나는 머릿속에 큰 그림이 어느 정도 그려져야 세부를 이해할 수 있다.
그래서 로드맵 문서와 블루프린트 문서를 만들었다.
첨엔 로드맵 문서만 만들었으나.. 이또한 문서 양식이 AI에게 최적화 되다 보니…
굳이 블루프린트를 만들어야 했다.
정리하면 이렇게 간단해 보이지만…실제로는 그렇지 않고.. 하면서 필요에 의해 이리 저리 보강해봤따.
로드맵과 블루프린트 작성 히스토리를 정리해봤다.
(물론 이 모든 과정에서 직접 문서를 작성하는 경우는 없다. 싹다 바이브로~)
+로드맵과 블루프린트 MD 문서도 첨부…하려했으나 wsl 폴더를 윈도우로 옮기는건 넘나 구찮다.....
(바이브 코딩 빌더 랩 미팅시간에 슬적 보여주는 걸로..ㅎㅎ)
‘
‘
‘
이제 하나씩 구현을 해보자 …
바이브 코딩으로 ~~
# 로드맵과 블루프린트 -- 어떻게 만들어졌는가
> 작성일: 2026-04-14
> 대상: 비개발자 보고용
---
## 1. 두 문서란 무엇인가
### 블루프린트 (docs/blueprint.md)
**"무엇을 만들 것인가"**를 정의하는 설계도입니다.
건축에 비유하면, 블루프린트는 "방이 몇 개인지, 어디에 문이 있는지, 어떤 자재를 쓰는지"를 그린 도면입니다. InMyRace 서비스의 전체 구조, 사용자 흐름, 데이터베이스 구조, 기술 스택 등을 담고 있습니다.
### 로드맵 (.moai/roadmap/roadmap.md)
**"어떤 순서로 만들 것인가"**를 정의하는 일정표입니다.
건축에 비유하면, 로드맵은 "먼저 뼈대를 세우고, 다음으로 전기를 깔고, 그 다음 인테리어를 한다"는 공정 순서입니다. 전체 프로젝트를 4단계(Phase)로 나누고, 각 단계에서 해야 할 작업을 구체적인 작업 단위(SPEC)로 정리했습니다.
---
## 2. 만들어진 기간
**2026년 4월 7일 ~ 4월 12일 (약 5일간)**
이 기간 동안 아이디어 구상부터 최종 문서 완성까지 8차례의 반복 작업이 진행되었습니다.
---
## 3. 만들어진 과정 (5단계)
### 1단계: 아이디어 브레인스토밍 (4월 7일)
**파일**: `workshop/brainstorming/1_initial_service_flow_strategy.md`
어떤 서비스를 만들지 핵심 아이디어를 정리했습니다.
주요 내용:
- 러닝 데이터를 분석해서 개인화된 리포트를 제공하는 서비스
- 9단계 사용자 여정(발견-연동-분석-결제-리포트-공유) 정의
- 단일 리포트 단위 판매 모델 채택
- 유료 전략 수립
---
### 2단계: 피드백 수렴 (4월 8일 ~ 9일)
**파일**: `workshop/feedback/` 폴더 (9개 피드백 문서)
초기 아이디어에 대해 다양한 관점에서 검토하고 피드백을 받았습니다.
주요 피드백:
| 피드백 | 내용 |
|--------|------|
| 사전 분석 방향 | AI가 어떤 분석을 수행할지 구체화 필요 |
| 회원가입 간소화 | 가민 연동만으로 자동 가입되게 단순화 |
| 결제 수단 비교 | 토스페이먼츠 vs 페이앱 비교 분석 |
| 종합 분석 | 모든 피드백을 취합해 우선순위 조정 |
---
### 3단계: 초안 작성 (4월 10일)
피드백을 바탕으로 두 문서의 초안을 작성했습니다.
**블루프린트 초안**:
- 사용자 흐름도 작성
- 시스템 아키텍처 설계
- 데이터베이스 구조 정의
- API 엔드포인트 목록 정리
**로드맵 초안**:
- 전체 개발을 4단계로 분리
- 각 단계별 작업 항목(SPEC) 정의
- 작업 간 의존관계 파악
---
### 4단계: 교차 검토 (4월 11일)
**파일**: `workshop/feedback/7_roadmap_blueprint_review.md`
초안이 완성된 후, 로드맵과 블루프린트가 서로 일치하는지 교차 확인했습니다.
발견된 문제점:
- 결제 기능이 Phase 4(마지막 단계)에 배치되어 있었으나, 수익화를 위해 Phase 1로 조정 필요
- 일부 데이터베이스 테이블이 로드맵에 누락되어 있음
- 작업 순서의 의존관계가 불명확한 부분 존재
이 검토 결과를 바탕으로 두 문서를 수정했습니다.
---
### 5단계: 최종 결정 및 완성 (4월 12일)
**파일**: `workshop/feedback/8_final_decision_analysis.md`
모든 검토를 마친 후 최종 결정사항을 정리하고 두 문서를 완성했습니다.
최종 결정사항 5가지:
1. **사업자 등록**: 개인사업자 등록 후 토스페이먼츠 연동
2. **MVP 결제**: 최소 기능으로 결제 시스템 우선 구현
3. **Phase 조정**: 결제 기능을 이른 단계에 배치
4. **테이블 구조**: orders, reports 테이블 명확히 정의
5. **우선순위**: 데이터 수집 > 프로필 분석 > 결제 > 리포트 생성 순
---
## 4. 문서 관계도
```
브레인스토밍 (4/7)
|
v
피드백 수렴 (4/8-9) -----> 9개 피드백 문서
|
v
초안 작성 (4/10) -----> 블루프린트 초안 + 로드맵 초안
|
v
교차 검토 (4/11) -----> 문제점 발견 및 수정
|
v
최종 결정 (4/12) -----> 블루프린트 v1.3 + 로드맵 v2.2
```
---
## 5. 현재 상태
| 항목 | 상태 |
|------|------|
| 블루프린트 | v1.3.0 완성 |
| 로드맵 | v2.2.0 완성, 14개 이상의 작업 단위(SPEC) 정의 |
| 전체 SPEC | 14+ 문서 중 일부 구현 완료, 나머지 계획 상태 |
| 결제 SPEC | SPEC-PAYMENT-001 작성 완료 (구현 전) |
---
## 6. 한 줄 요약
> 5일간 8번의 반복(브레인스토밍 > 피드백 > 초안 > 검토 > 결정)을 거쳐,
> **무엇을 만들지**(블루프린트)와 **어떤 순서로 만들지**(로드맵)를 체계적으로 정리했습니다.