2주차 팀 프로젝트를 시작합니다. 실제 서비스 개발에서 가장 중요한 것은 코드가 아니라 Why(왜) → What(무엇을) → How(어떻게)의 순서입니다. 창업자의 관점으로 문제와 범위를 정하고, gstack의 Think → Plan → Build → Review → Test → Ship → Reflect 시퀀스와 AI Native 개발 방식으로 5일 스프린트를 설계합니다.
AI 덕분에 “어떻게 만들까”는 매우 빨라졌습니다. 그래서 “무엇을, 왜 만들까”를 잘못 정하면 틀린 제품을 더 빨리 만들게 됩니다.
## C-012 · Phase 4 · /qa-only
- 질문: 출석 시나리오 6개 테스트
- 핵심 지적: 중복 클릭 시 2건 저장
- 팀 판단: 수용 → FR-003 수정
- 거절: "로그인 추가" 제안 → Out 범위
- 증거: BUG-004, TEST-007 재검증 PASS
5분 발표 구조
판단 · 증거 1분에는 AI 제안을 거절 · 수정한 사례를 꼭 하나 이상 보여 주세요.
Week 2 · 5-day sprint
2주차 스프린트: 6페이즈를 5일에
Day 6 · 월THINK · PLAN 착수문제 검증, 3문장 정의, 범위표, 역할, 저장소·gstack 세팅/office-hours
Day 7 · 화PLAN · 중간 발표5대 기획 문서, CEO·엔지니어링 리뷰, 테스트 계획/autoplan
Day 8 · 수BUILD · REVIEW핵심 수직 흐름 구현과 통합, 코드 리뷰/freeze · /review
Day 9 · 목TEST · ITERATEPOC 발표, 시나리오 테스트, 피드백을 Spec-First로 반영/qa-only · /qa
Day 10 · 금SHIP · REFLECT문서 최신화, 회고, 최종 발표/document-release · /retro
Day 6 mission
오늘의 산출물과 킥오프 발표
산출물 1 · PROJECT_BRIEF
3문장 정의 + 인터뷰 근거 3건 + /office-hours 결과 요약
산출물 2 · 범위 · 지표
Must/Should/Out 범위표 + 숫자로 된 성공 지표 2개 이상
산출물 3 · 역할표
사람 × AI 역할, 최종 승인자, 브랜치 규칙
산출물 4 · 스프린트 세팅
저장소, AGENTS.md, gstack 설치, 5일 백로그
팀별 3분 킥오프: 정의 → 범위 → 지표 → 역할 → 내일 할 일
AI를 열기 전에 팀 초안을 먼저 쓴다
실제 개인정보·비밀 키를 문서와 코드에 넣지 않는다
모든 AI 결과의 수용·수정·거절 이유를 기록한다
Takeaway
Why와 What은 사람이, How는 사람과 AI가 함께.
AI Native 개발자는 코드를 가장 빨리 치는 사람이 아니라, 올바른 문제를 고르고 AI 팀을 지휘해 증거로 완성하는 사람입니다.
고르는 힘절실한 사용자의 진짜 문제를 고른다
지휘하는 힘페이즈마다 맞는 AI 역할을 부르고 범위를 잠근다
증명하는 책임테스트와 기록으로 완료를 증명한다
1 / 24
LECTURE NOTE
Hands-on Lab
오늘의 킥오프 실습 흐름
6개 페이즈의 상세 수행 순서와 완료 체크리스트는 Project Day 상세 실습과제 가이드에서 확인하세요. 오늘은 Phase 1(아이디어)을 끝내고 Phase 2(기획 문서)를 시작합니다.
STEP 01 · 60분 · WHY
문제 찾기 & 인터뷰
팀 아이디어를 발산한 뒤 1개를 골라, 사용자 3명에게 과거 행동 중심으로 5분 인터뷰합니다.
INTERVIEW × 3
STEP 02 · 60분 · WHAT · 핵심
3문장 · 범위 · 지표
팀 초안을 먼저 쓰고 /office-hours로 전제를 점검한 뒤 PROJECT_BRIEF를 확정합니다.
PROJECT_BRIEF.md
STEP 03 · 60분 · HOW
역할 & 스프린트
사람 × AI 역할표, 브랜치 규칙, 5일 백로그를 만들고 저장소에 AGENTS.md와 gstack을 설치합니다.
TEAM.md · BACKLOG
STEP 04 · 40분 · SHARE
3분 킥오프 발표
정의 → 범위(Out 포함) → 지표 → 역할 → 내일 할 일. 멘토 피드백으로 범위를 줄이고 기록합니다.
CONVERSATION.md
gstack 명령 치트시트 — 언제, 무엇을 위해 부르나
모든 명령의 결과는 그대로 채택하지 않고, 팀 판단과 함께 오른쪽 문서에 반영한 뒤 CONVERSATION.md에 기록합니다.
명령
단계 · 역할
언제 부르나
결과를 반영할 곳
/office-hours
Think · CEO 오피스아워
3문장 정의 초안 직후. 6가지 질문으로 전제 점검
PROJECT_BRIEF.md (문제·사용자·범위)
/plan-ceo-review
Plan · 범위 리뷰
SITE_SPEC 초안 후. 5일 프로젝트는 Hold Scope / Reduction
범위표, SITE_SPEC 기능 목록
/plan-eng-review
Plan · 엔지니어링 리뷰
5대 문서 완성 후, 변경 요청 시(Spec-First)
DATA_MODEL, USER_FLOWS 예외, 테스트 계획
/plan-design-review
Plan · 디자인 리뷰 (선택)
화면 설계를 항목별 점수로 구체화할 때
SITE_SPEC 디자인 원칙
/autoplan
Plan · 리뷰 일괄 실행 (선택)
시간이 부족할 때. 사람이 결정할 항목만 받기
[미결정] 항목 목록
/freeze · /guard
Build · 안전장치
구현 시작 전. 수정 범위를 한 폴더로 제한
구현 로그 (허용 범위)
/design-consultation
Build · 디자인 시스템 (선택)
색·타이포·간격 기준이 없을 때
SITE_SPEC, README
/review
Review · 코드 리뷰
핵심 흐름이 동작한 뒤, 변경 구현 후
구현 로그, 수정 커밋
/qa-only → /investigate → /qa
Test · QA
보고만 → 근본 원인 조사 → 수정·재검증·회귀
TEST_PLAN.md, BUG_LOG.md
/document-release
Ship · 문서 최신화
최종 발표 전. 문서를 최종 코드에 맞춤
README.md, 5대 기획 문서
/retro
Reflect · 회고
스프린트 종료 시
RETROSPECTIVE.md, 발표 회고
킥오프 템플릿 키트 — 복사해서 바로 쓰기
각 블록의 복사 버튼으로 내용을 복사해 팀 저장소에 파일로 저장하세요. [대괄호] 부분을 팀에 맞게 고칩니다.
WHY · WHAT
PROJECT_BRIEF.md
오늘의 핵심 산출물. Phase 2의 모든 문서가 이 파일을 입력으로 씁니다.
# [서비스 이름] — PROJECT_BRIEF
## 1. 3문장 정의
1. 목적: [누가] [무엇을] 할 수 있게 하는 서비스다.
2. [사용자 A]: [시작] → [행동] → [결과]
3. [사용자 B]: [시작] → [행동] → [결과]
## 2. 문제의 증거 (인터뷰·관찰)
| # | 대상 | 최근 겪은 상황 | 지금 해결 방법 | 불편한 점 |
|---|---|---|---|---|
| I-1 | | | | |
| I-2 | | | | |
| I-3 | | | | |
## 3. 핵심 사용자 (가장 절실한 한 사람)
- 누구:
- 언제·어디서:
- 지금 참고 있는 방식(Status quo):
## 4. 범위
- Must (없으면 데모 불가):
- Should (시간 되면):
- Out (이번엔 안 만듦 + 이유):
## 5. 성공 지표 (숫자로)
- [사용자 A]가 [N초/N단계] 안에 [행동] 완료
- [오류·중복] [N]건 이하
## 6. 위험과 열린 질문
- [가정]:
- [질문]:
## 7. AI 리뷰 반영 (/office-hours)
- 수용:
- 수정:
- 거절 + 이유:
WHY
5분 사용자 인터뷰 노트
The Mom Test 원칙: 아이디어가 아니라 상대의 과거 행동을 묻습니다.
# INTERVIEW I-[번호]
- 대상: [역할, 상황] · 날짜: [ ] · 인터뷰어: [ ]
## 질문 (아이디어 설명 금지)
1. 마지막으로 [문제 상황]을 겪은 게 언제예요?
2. 그때 어떻게 해결했어요? 순서대로 말해 줄래요?
3. 그 과정에서 가장 시간이 오래 걸리거나 짜증 난 건?
4. 그걸 해결하려고 써 본 도구나 방법이 있나요?
5. 그 문제가 해결되면 무엇이 달라지나요?
## 기록 (사실 / 해석 분리)
- 사실(들은 그대로):
- 해석(우리 생각):
- 놀라운 점(Observation & surprise):
## 판정
- 이 사람은 문제를 [매우 / 조금 / 거의 안] 겪는다
- 근거:
HOW · AI NATIVE
TEAM.md — 사람 × AI 역할표
역할마다 최종 승인자를 한 명으로 정합니다.
# TEAM — 역할과 협업 규칙
| 역할 | 담당자 | 책임지는 결정 | 짝이 되는 AI |
|---|---|---|---|
| PO · 기획 | [이름] | Why/What, 범위 승인, 변경 요청 판단 | /office-hours, /plan-ceo-review |
| 디자인 · UX | [이름] | 사용자 흐름, 화면 기준 | /design-consultation, /plan-design-review |
| 개발 리드 | [이름] | 구조·데이터, 코드 머지 | Codex · Antigravity, /plan-eng-review, /review |
| QA · 릴리스 | [이름] | 테스트 판정, 데모 준비 | /qa-only, /qa, /document-release |
## 협업 규칙
- main 직접 커밋 금지 · feature/[REQ-ID]-[요약] 브랜치
- REQ 하나 = 계획 하나 = 커밋 하나
- 하루 1회 이상 통합, 매일 17:00 데모
- AI 결과는 승인자가 diff를 보고 머지
- AI 사용 기록은 CONVERSATION.md에 남김
## 데일리 스크럼 (10분)
- 어제 끝낸 REQ / 오늘 끝낼 REQ / 막힌 것
HOW
SPRINT_BACKLOG.md — 5일 계획
매일 저녁 “데모 가능한 흐름”이 하나씩 늘어나도록 배치합니다.
# SPRINT BACKLOG — Week 2
| Day | 페이즈 | 목표 (저녁 데모) | REQ / 산출물 | gstack | 담당 |
|---|---|---|---|---|---|
| 6 월 | Think · Plan | Brief 확정, 킥오프 발표 | PROJECT_BRIEF, TEAM | /office-hours | |
| 7 화 | Plan | 5대 문서 + 중간 발표 | SITE_SPEC, USER_FLOWS, DATA_MODEL, IMPLEMENTATION_PLAN | /autoplan | |
| 8 수 | Build · Review | 핵심 흐름 1개 동작 | FR-001 ~ FR-00_ | /freeze, /review | |
| 9 목 | Test · Iterate | POC 발표, 결함 수정 | TEST_PLAN, BUG_LOG, CHANGE_REQUEST | /qa-only, /qa | |
| 10 금 | Ship · Reflect | 최종 발표 | README, RETROSPECTIVE | /document-release, /retro | |
## 완료 정의 (모든 REQ 공통)
- 수용 기준(Given-When-Then)이 브라우저에서 재현됨
- 콘솔 에러 0건, 모바일·PC 레이아웃 정상
- 리뷰 후 머지, CONVERSATION.md 기록
기록
CONVERSATION.md — 결정 이력
채팅 복사가 아니라 질문 → 핵심 제안 → 팀 판단 → 이유 → 증거.
# CONVERSATION — AI 대화와 결정 이력
## C-001 · Phase 1 · /office-hours
- 도구: gstack /office-hours (Codex)
- 질문 요약:
- 핵심 제안·지적:
- 팀 판단: 수용 / 수정 / 거절
- 이유:
- 반영 위치: PROJECT_BRIEF.md §[ ]
- 증거: [인터뷰 I-2, 테스트 ID 등]
## C-002 · Phase 2 · /plan-eng-review
- ...
ITERATE
CHANGE_REQUEST.md — 변경 요청
POC 피드백(Day 9)부터 사용합니다. 코드보다 먼저 작성합니다.
# CR-001 — [변경 요청 한 문장]
- 요청자 · 날짜:
- 이유 (사용자 가치):
- 진짜 의미 합의: [예: 실시간 = 5초 polling]
- 완료 기준 (Given-When-Then):
## 영향 분석
| 영역 | 영향 | 수정할 문서/파일 |
|---|---|---|
| 화면 | | |
| 흐름 | | |
| 데이터 | | |
| 테스트 | | |
| 일정 | | |
## 결정
- 이번 스프린트 반영 / 다음 버전 백로그
- 승인자:
- 순서: 문서 수정 → /plan-eng-review → 승인 → 코드 → /review → /qa
프롬프트
페이즈별 gstack · AI 프롬프트 모음
[대괄호]를 채워 Codex 또는 Antigravity 채팅에 붙여 넣으세요.
[THINK] /office-hours
우리는 [사용자]의 [문제]를 해결하는 서비스를 5일 안에 만들려고 해.
아래 3문장 정의와 인터뷰 기록을 기준으로 질문해 주고,
가장 위험한 가정과 가장 좁은 시작 범위를 짚어 줘.
[3문장 정의 + 인터뷰 요약 붙여넣기]
[PLAN] /plan-ceo-review
SITE_SPEC.md를 Hold Scope 모드로 리뷰해 줘. 5일 안에 데모할 수 없는
기능은 Out으로 옮길 후보로 제시하고, 빠진 핵심 가치가 있는지 알려 줘.
[PLAN] /plan-eng-review
5대 기획 문서를 검토해 문서 간 모순, 숨은 가정, 예외 흐름 누락을 표로 정리하고
요구사항 ID(FR-xxx)별 테스트 계획을 만들어 줘.
[BUILD] 구현 요청 (Codex · Antigravity)
5대 기획 문서를 먼저 읽고 FR-[ ]의 구현 계획만 제안해 줘.
생성·수정할 파일과 이유, 확인할 수용 기준을 보여 주고 승인 후에 구현해.
[REVIEW] /review
website/ 코드를 SITE_SPEC의 요구사항 ID와 수용 기준에 맞춰 리뷰해 줘.
기획서에 없는 기능, 저장 실패·중복 클릭 미처리를 우선 찾아 줘.
[TEST] /qa-only
TEST_PLAN.md의 시나리오를 브라우저에서 실행하고, 코드는 고치지 말고
결함마다 재현 절차와 스크린샷을 남겨 줘.
[REFLECT] /retro
CONVERSATION.md와 작업 이력으로 잘한 점, 어려웠던 점,
AI 제안을 거절·수정한 사례, 다음 버전 개선 1가지를 정리해 줘.
증거가 없는 성과는 추가하지 마.
SHARE
3분 킥오프 발표 스크립트
오늘 마무리 발표용. 멘토는 범위가 크면 이 자리에서 줄여 줍니다.
# 킥오프 발표 (3분)
0:00 문제 (40초)
- "[사용자]는 [상황]에서 [불편]을 겪습니다."
- 인터뷰 근거 한 줄: "I-2: ..."
0:40 What (60초)
- 3문장 정의
- Must 3개 / Out 3개 (+ 왜 뺐는지)
1:40 성공 지표 (30초)
- "[N초] 안에 [행동]", "[오류] 0건"
2:10 How · 팀 (30초)
- 역할표(사람 × AI), 스프린트 Day 7~10 목표
2:40 질문 · 요청 (20초)
- 멘토에게 확인받고 싶은 결정 1가지