📑 이 챕터에서 다룰 내용
권1 제0~4장에서 SPEC.md가 v1 → v2 → v3 → v4까지 진화했고, 5파일+ 사이클의 단계 ①~⑤가 본문에 박혔습니다. 이 짧은 회고 챕터에서 5확장이 어디까지 등장했는지 점검합니다.
| 사전 지식 체크 | 이 장의 목적 | 완료 후 결과물 |
|---|---|---|
| 권1 제0~4장 정독 | Phase 0 Day 1~4의 5확장 등장 점검 + 권1 제6장 (PLAN) 진입 준비 | 5확장 점검표 + 5파일 상태 + 누적 시간 (E2 트리거 거리) |
| 확장 | 본격 등장 챕터 | 상태 | 핵심 데이터 |
|---|---|---|---|
| E1 회색지대 | 권1 제3장 | ✅ 본격 | 4단계 풀 두 결정 (줍줍 표현 + 개인정보) |
| E2 1인 페이스 | 권1 제6장 (PLAN) | ⏳ 다음 챕터 | 누적 시간 추적만 시작 (9h) |
| E3 두 검토자 | 권1 제2·4장 | ✅ 본격 | 12건 4+6+2 패턴 데이터 입증 |
| E4 LogOnTable | 권1 제0~4장 매 entry | ✅ 본격 | BUILD.md 5 트레이스 (Day -1·1·2·3·4) |
| E5 콘텐츠 SSOT | 권1 제7장 (CLAUDE) | ⏳ 권1 마지막 | 측정 메트릭 § 일부만 (Day 4) |
3개 본격 ✅ + 2개 ⏳ 예정. 권1 제6~7장에서 E2·E5가 본격 등장하면 권1에서 5확장 5개 모두 완료됩니다.
jupjup/ ├── SPEC.md (16KB) ✅ v4 — 7항목 + ⚖️ E1 두 결정 + § 측정 메트릭 + 9건 보강 ├── PLAN.md ( 0KB) ⏳ 권1 제6장에서 작성 ├── REVIEW.md ( 0KB) ⏳ 권1 제7장에서 작성 ├── BUILD.md ( 4KB) ✅ Day -1~4 5 entry + LogOnTable 5 트레이스 ├── CLAUDE.md ( 1KB) ⏳ 3 섹션 최소 — 권1 제7장에서 10 섹션 완성 ├── .gitignore └── (BUILD 단계 전 — 코드 없음)
5파일+ 사이클 단계 ①~⑤ 진행 완료. 단계 ⑥ (PLAN) → 단계 ⑦ (REVIEW + READY) 가 권1 마지막 두 챕터입니다.
| Day | 작업 | 시간 |
|---|---|---|
| Day -1 | 이름 결정 + 5파일 빈 껍데기 | 0.5h |
| Day 1 | SPEC v1 작성 (Opus + high) | 1.5h |
| Day 2 | Gemini 1차 + SPEC v2 | 2h |
| Day 3 | E1 4단계 두 결정 + SPEC v3 | 3h |
| Day 4 | 두 검토자 + SPEC v4 | 2.5h |
| 누적 | 9.5h |
누적 시간 추적이 매 BUILD.md entry에 박히면, R4 트리거 (60h/4주) 가 "가설"이 아니라 "실시간 측정값"이 됩니다. 사용자가 의식적으로 "이번 주 너무 많이 했나?"라고 묻지 않아도 BUILD.md가 자동으로 답해줍니다.
R4 트리거 60h/4주까지의 여유: 50.5h — Phase 0이 Day 4 끝 시점에 누적 9.5h로 매우 안전한 상태입니다.
권1 제6장에서 다룰 내용
10주 일정 + 8 게이트 + 12 리스크
시간 갭 정직 계산
3가지 형태 (시간 갭·게이트 휴식·R4)
권1 제7장에서 다룰 내용
15가지 체크 + 3단계 판정
W-C 항목 한 번에 해결
Two-Tab 7 규칙
권1 끝 = Phase 0 끝 = 5파일 모두 완성 + 5확장 5개 모두 본격 등장 + Phase 1.0 BUILD 시작 준비.
- Phase 0 Day 1~4 회고 — E1·E3·E4 본격 ✅ / E2·E5는 권1 제6~7장에서
- SPEC.md (16KB) ✅ v4 완성 / BUILD.md (4KB) ✅ Day -1~4 entry
- 누적 시간 9.5h / R4 트리거 60h 여유 50.5h
- 다음 장: 권1 제6장 — PLAN v2.1 + ⭐ E2 1인 페이스 본격 등장
📑 이 챕터에서 다룰 내용
권1 제5장의 회고에서 SPEC v4가 완성됐고 5파일+ 사이클 단계 ①~⑤가 끝났습니다. 이제 단계 ⑥ — PLAN v1 → v2.1. 이 챕터는 5확장 E2 (1인 12개월 페이스)의 본격 등장 자리입니다.
| 사전 지식 체크 | 이 장의 목적 | 완료 후 결과물 |
|---|---|---|
| SPEC v4 / 1탄 v2 새 6장 + 부록 H-2 인지 | PLAN v1 → v2.1 (10주 일정 + 8 게이트 + 12 리스크 + ⭐ E2 3 형태) | PLAN.md v2.1 (게이트 + 리스크 + 시간 갭 + ★ R4 + 휴식 의식) + git commit |
SPEC.md ✅ (권1 제1~4장) → PLAN.md ◀ 지금 여기 → REVIEW.md (권1 제7장) → BUILD.md ✅ Day -1~4 → CLAUDE.md (권1 제7장)
"이 사람이 6~12개월 동안 무너지지 않을 페이스인가"의 메타 결정입니다. 9개 표준 도구 모두 이 영역을 다루지 않습니다 (작업 분해 Taskmaster + 의존성 GSD wave는 다루지만 운영자 페이스는 사용자 책임).
3가지 형태:
- (a) 시간 갭 정직 계산 (옵션 A/B/C)
- (b) 게이트 + 휴식의 의식
- (c) R4 1인 번아웃 리스크 등록부
/model claude-opus-4-6 /effort high SPEC.md v4를 읽고 PLAN.md를 작성해줘. 줍줍은 10주 (70일) 일정. 기준: 1. Phase 1 = 10주 (70일) 안에 혼자 완성 가능 + 앱스토어 심사 통과 2. Phase 1 의도적 무수익 (SPEC §6 명시) 3. 각 게이트의 DoD 숫자 명시 4. 변경 파일 약 25개 5. 의존성 명시 (예: G2 DB·인증 → G3 두 탭 UI 가능) 6. ⭐ 게이트마다 측정 가능 통과 조건 7. 리스크 등록부 R1~R12 (영향·확률·완화책·트리거) 8. ⭐ E2 1인 페이스 의식 (게이트 휴식 + R4 1인 번아웃) Phase 2 (6개월 후 시작) 는 SPEC §6 의도만 명시 (PLAN에 본격 X).
Claude (Opus) 가 생성한 PLAN v1 — 발췌
# PLAN.md — 줍줍 v1 ## Phase 1: MVP — 정보 수집 + 기여 시스템 + 무료 사용 기간: 10주 (70일, Day 1~70) 변경 파일: 약 25개 가용: 280h (10주 × 28h/주, 1일 4h 평균) DoD: 앱스토어 심사 통과 + 첫 100 사용자 + 후기 8명+ + 1순위 게시
주차별 핵심
| 주차 | Day | 핵심 |
|---|---|---|
| 1 | 1~7 | 공공데이터 API 4개 인증 + 시딩 20개 (G1) |
| 2 | 8~14 | LLM 분류 파이프라인 + Supabase 프로젝트 |
| 3~4 | 15~28 | DB 4 테이블 + 트리거 + 카카오 로그인 + pg_cron (G2) |
| 5~6 | 29~42 | 두 탭 목록·상세 + 단계적 기여 (G3) |
| 7~8 | 43~56 | 통계 시각화 + FCM 알림 + 공유 카드 (G4) |
| 9 | 57~63 | 약관/방침 + 어드민 + QA |
| 10 | 64~70 | 앱스토어 심사 + 1순위 커뮤니티 게시 (G5) |
게이트 5개
| 게이트 | 시점 | 측정 조건 |
|---|---|---|
| G1 | Day 7 (1주차 끝) | API 4개 인증키 정상 + 시딩 20개 (confidence ≥ 0.75) |
| G2 | Day 28 (4주차 끝) | 4 테이블 + 트리거 정상 + 카카오 로그인 + pg_cron 매일 03:00 정상 ★ 운영자 페이스 점검 (E2) |
| G3 | Day 42 (6주차 끝) | 두 탭 목록 + 상세 페이지 정상 + 단계적 기여 흐름 검증 |
| G4 | Day 56 (8주차 끝) | FCM 알림 정상 (D-7 + 신규 매칭 즉시) + 통계 시각화 + 공유 카드 |
| G5 | Day 70 (10주차 끝, FINAL) | 앱스토어 + 플레이스토어 심사 제출 + 1순위 커뮤니티 게시 + 첫 사용자 50명+ |
리스크 등록부 R1~R12
| # | 리스크 | 영향 | 확률 | 완화책 | 트리거 |
|---|---|---|---|---|---|
| R1 | API 응답 품질 저하 | 중 | 중 | confidence 0.7 미만 NULL | fail >5%/주 |
| R2 | 정부 유사 서비스 출시 | 높 | 낮 | 집단 경험 데이터 차별화 | 정부 발표 시 |
| R3 | 애플 심사 거절 | 높 | 중 | IDFA 미수집 + Privacy Manifest | 1차 거절 |
| R4 | 1인 운영 번아웃 | 높 | 중 | ★ 6주차+9주차 휴식 의무 / 토요일 X / 주간 회고 | 누적 60h+/4주 |
| R5 | LLM 분류 오류 | 중 | 중 | 어드민 검수 + 사용자 신고 | 신고 >5건/주 |
| R6 | 통계 조작 시도 | 중 | 낮 | UNIQUE + IP rate limit Redis | 한 IP 5회+/시간 |
| R7 | 외부 API 호출 한도 초과 | 중 | 낮 | API별 일 호출 한도 캐싱 + fallback | data.go.kr 10k+ |
| R8 | 행정구역 코드 변경 | 낮 | 중 | Phase 1.1 이후 자동 재매핑 | 통폐합 발생 |
| R9 | 카카오 토큰 만료 처리 실패 | 중 | 낮 | 자동 refresh + 재로그인 modal | 만료 인지 실패 |
| R10 | FCM 토큰 만료 | 낮 | 중 | NULL + 로그인 시 재등록 | 발송 fail |
| R11 | 후기 신고 폭증 | 중 | 낮 | 24h SLA + admin 알림 | 신고 5건+/일 |
| R12 | DB 백업 실패 | 높 | 낮 | Supabase 자동 일일 백업 | 백업 fail |
PLAN v1 작성 후 SPEC v4의 9개 보강이 PLAN에 미치는 시간 영향 산식을 계산합니다.
[추가 작업 — 9건 즉시 SPEC + 3건 PLAN으로]
- C-1 § 측정 메트릭 + 어드민 분석 페이지: +6h (G3·G4 사이)
- C-2 닉네임 페르소나 풀 20개+ + fallback: +2h (G2 안)
- C-3 운영자 검수 SLA 7일 + 알림: +3h (G2 안)
- C-4 신고 처리 SLA 24h + 알림: +2h (G3 안)
- C-5 1순위 커뮤니티 측정 어드민 폼: +3h (G5 안)
- G-1 LLM JSON fallback: +2h (G1 안)
- G-2 source_url null 처리: +1h (G3 안)
- G-3 is_active 트리거 SQL: +2h (G2 안)
- G-4 카카오 토큰 갱신: +3h (G2 안)
- G-5 FCM 토큰 만료 처리: +2h (G4 안)
- G-6 IP rate limit Redis: +4h (G2 안, Day 8)
- G-7 Apple Privacy Manifest 자동 검증: +2h (G5 안)
- 합계: +32h
[가용 시간 점검]
- PLAN v1 가용: 280h (10주 × 28h)
- v2 기준 필요: 312h
- → 1일 4h 평균이 1일 4.46h로 늘어나야 함
⭐ E2 시간 갭 흡수 옵션 A·B·C
| 옵션 | 내용 | 단점 | 장점 |
|---|---|---|---|
| A — 부가 기능 축소 (-12h) | 통계 시각화 일부 + 공유 카드 디자인 제외 | SPEC v4의 "바이럴 훅" 가치 약화 | 일정 그대로 (10주 70일) |
| B — 어드민 축소 (-8h) | 분석 페이지 일부 제외 (수동 입력만 유지) | 운영 안전망 약화 | 일정 그대로 |
| C — 일정 3일 연장 (+12h 가용) ← 채택 | Phase 1: Day 1~70 → Day 1~73, 가용 280h → 292h, 1일 평균 4h → 4.27h | 첫 사용자 도달 3일 지연 | SPEC v4 9건 보강 모두 적용 + 1순위 커뮤니티 게시 일관 |
"Phase 1의 본질은 '앱스토어 심사 통과 + 1순위 커뮤니티 게시 + 사용자 신뢰 축적'이지 70일이라는 캘린더가 아니다. 검증과 신뢰가 본질이고 캘린더는 도구다."
TSV의 +29h 갭과 정확히 같은 패턴 — 1탄 v2 새 6장 6-4 (a) 절 TSV 사례와 일관됩니다.
(a) 시간 갭 정직 계산 — 옵션 C 채택
위 6-2 절에서 이미 본문에 박혔습니다.
(b) 게이트 + 휴식의 의식 — G2 사례
## G2 — Day 28 (4주차 끝, DB·인증·pg_cron 완성) [기능 통과 조건] [ ] users / benefits / jupjups / reports 4 테이블 생성 [ ] 트리거 3개 (jupjups 집계 / IP rate limit / is_active 자동) [ ] 카카오 로그인 + access·refresh 토큰 자동 갱신 [ ] 닉네임 자동 부여 (형용사 풀 20개+ + fallback) [ ] pg_cron 매일 03:00 정상 (4 API 호출) [ ] 어드민 기초 페이지 (검수 큐 + SLA 표시) [ ] LLM JSON fallback 동작 (JSON parse 실패 → admin 큐) [★ 운영자 페이스 점검 (E2)] [ ] 누적 시간 60h 초과 X (G2 시점 추정 누적 약 50h, 안전) [ ] 토요일 작업 X (G2 직전 1주에 토요일 1번 위반 → 다음 주 회복) [ ] 매주 일요일 30분 회고 + 다음 주 목표 1줄 (4주 모두 작성) [★ 게이트 통과 의식 (E2)] [ ] git tag v0.1-G2-passed [ ] 1일 휴식 (자기 자신과의 약속, Day 29) [ ] 회고 1KB 이상 BUILD.md에 작성
(c) R4 — 리스크 등록부의 "1인 번아웃" 일급 객체
[정의]
운영자 (Junho 1인) 의 신체적·정신적 한계로 인한 프로젝트 중단 위험. 줍줍의 R1~R12 중 가장 영향 큰 리스크 — "이 사람이 무너지면 R1~R10 모두 의미 없음".
[완화책 — 4가지 의식]
- 게이트 통과 시 git tag + 1일 휴식 의무 (G1·G2·G3·G4·G5)
- 주차별 누적 시간 60h 초과 시 다음 주 1일 추가 휴식 의무
- 토요일 작업 금지 (예외: 게이트 마감 임박 → 일요일 대체)
- 매주 일요일 30분 회고 (BUILD.md에 명시 작성, 회고 부재 = R4 신호)
[트리거 — 다음 4가지 중 하나라도 발생 시]
- 누적 시간 60h+/4주
- 회고 부재 2주+ 누적
- 토요일 작업 4주 연속
- "피곤하다" 명시 표현 BUILD.md 회고에 등장
트리거 발생 시 즉시 1일 휴식 + 다음 주 목표 25% 축소 (자동).
git add PLAN.md git commit -m "PLAN v2.1: 73일 + 5게이트 + 12리스크 + ⭐ E2 3형태"
## Phase 0 Day 5
[계획]
- PLAN v1 작성 (Opus + high) + 시간 산식 점검
[실행]
- 10주·5게이트·12리스크·DoD 숫자 모두 명시
- 시간 갭 +32h 발견 (SPEC v4의 9건 보강 영향)
- 옵션 A·B·C 비교 → 옵션 C 채택 (3일 연장, 1일 평균 4.27h)
[LogOnTable 트레이스]
> 결정: 옵션 C 채택 — Day 1~70 → Day 1~73 (3일 연장)
> 근거: "Phase 1의 본질은 심사 통과 + 커뮤니티 게시 + 신뢰 축적,
70일 캘린더는 도구"
> 대안 A: 부가 기능 축소 (-12h, 바이럴 훅 약화)
> 대안 B: 어드민 축소 (-8h, 운영 안전망 약화)
> 부작용: 첫 사용자 도달 3일 지연. SPEC v4의 9건 보강은 모두 적용.
[E2 본격 등장]
- 옵션 A·B·C 비교 = 시간 갭 정직 계산 (E2 (a))
- 게이트 통과 조건에 페이스 점검 추가 (E2 (b))
- R4 1인 번아웃 리스크 등록부 일급 객체 (E2 (c))
[누적 시간] 9.5h (Day 1~4) + 4h (Day 5) = 13.5h
## Phase 0 Day 6 [계획] - PLAN v1 → v2.1 패치 + 12 리스크 본문 보강 [실행] - /model claude-sonnet-4-6 + /effort high - 5 게이트 모두 +α 작업 분배 (G2 +14h / G3 +9h / G5 +5h 등) - R4 본문 4 의식 + 4 트리거 명시 - E2 3형태 모두 PLAN.md 본문에 박음 [누적 시간] 13.5h (Day 1~5) + 3h (Day 6) = 16.5h [회고 1줄] - E2의 3형태가 본격 등장. "운영자 자체"가 R1~R12 안에 일급 객체로 박힌 자리. 6개월 후 동업자가 "왜 R4가 있나" 펼치면 답이 본문에 있음.
- PLAN v2.1 = 73일 (옵션 C) + 5게이트 + 12리스크 + ⭐ E2 3형태 본격
- 5파일+ 사이클 단계 ⑥ PLAN v1 → v2.1 ✅ / 다음: 단계 ⑦ REVIEW + READY (권1 제7장)
- 10주 → 73일 (옵션 C): 가용 280h → 292h, 1일 평균 4h → 4.27h, SPEC v4 9건 보강 모두 적용
- 5게이트: G1(Day 7) API 인증 → G2(Day 28) DB·인증·pg_cron ★페이스 점검 → G3(Day 42) 두 탭 → G4(Day 56) 통계·알림·공유 → G5(Day 73) 심사 + 커뮤니티
- ⭐ E2 3형태 본격: (a) 시간 갭 옵션 C 채택 / (b) 게이트 통과 조건 페이스 점검 / (c) R4 일급 객체 (4 의식 + 4 트리거)
- 5확장 본격 등장: E1 ✅ / E2 ✅ (본 장) / E3 ✅ / E4 ✅ / E5 ⏳ 권1 제7장
- 다음 장: 권1 제7장 — REVIEW READY + CLAUDE.md 10 섹션 + ⭐ E5 본격
⭐ E2 (1인 12개월 페이스) 가 본격 등장했습니다. 시간 갭 옵션 C·게이트 통과 페이스 점검·R4 1인 번아웃 일급 객체. 운영자 자체가 PLAN.md의 본문에 박혔습니다.
다음 장에서 마지막 단계 — REVIEW.md (15가지 체크 + 3단계 판정) + CLAUDE.md 10 섹션 완성 + ⭐ E5 콘텐츠 SSOT (Two-Tab 7 규칙) 본격.