새 1장에서 5파일+의 정체성을 정의했습니다. 5파일이 9개 표준 도구의 산출물을 흡수하고, 5확장이 표준 미점유 영역을 메운다는 것까지. 새 2장에서 빈 5파일과 git 폴더를 만들었고, 새 3장에서 Claude Code 런타임을 설치했습니다. 이 장은 한 단계 더 들어갑니다. 5파일이 "한 번 만들어지고 끝"이 아니라 "사이클로 돈다"는 의미를 풀어드립니다.

이 "사이클"의 모습이 이 장의 핵심입니다. 다섯 개의 절로 풀어보겠습니다.

먼저 5파일+ 사이클을 한 그림으로 봅니다. 5파일을 만드는 "한 사이클"은 다음 7단계를 거칩니다.

[① SPEC v1 작성]
       ↓
[② 외부 검토 1차] (Claude로 만들고 → Gemini로 검토)
       ↓
[③ SPEC v2 패치]
       ↓
[④ 사용자 직관 점검] (자기가 다시 SPEC을 펼쳐서 빠진 것 점검)
       ↓
[⑤ SPEC v3 → 두 검토자 (Claude + Gemini) → SPEC v4]
       ↓
[⑥ PLAN v1 → v2 작성] (SPEC v4 기반)
       ↓
[⑦ REVIEW.md 작성 → READY: YES → BUILD 시작]

각 단계에서 무슨 일이 일어나는지 짧게 풀어드립니다.

단계 ① — SPEC v1 작성

"무엇을 만들 것인가"를 7항목 (한 줄 정의 / 타겟 사용자 / 핵심 기능 / 비기능 / 제약 / 성공 기준 / 수익화)으로 처음 적습니다.

시간: 약 1~2시간.

단계 ② — 외부 검토 1차

SPEC v1을 다른 AI에게 보여서 "빠진 것 / 약한 것"을 찾습니다.

이 책은 Gemini를 외부 검토자로 사용합니다. 이유: Claude (작성자)와 다른 회사·다른 모델이라 사각지대가 다릅니다. "같은 의료 시스템에서 교육받은 두 의사가 같은 맹점을 가지듯", 같은 AI 회사 모델은 같은 약점을 가집니다.

시간: 약 30분 (검토 요청 + 결과 받기).

단계 ③ — SPEC v2 패치

외부 검토 결과 (보통 5~7건의 발견)를 SPEC v1에 반영해서 v2를 만듭니다.

시간: 약 1시간.

단계 ④ — 사용자 직관 점검

가장 자주 잊혀지는 단계입니다. "외부 검토는 끝났지만 — 내가 다시 한 번 SPEC을 펼쳐서 직관으로 점검"입니다.

왜: 외부 검토자는 사용자의 "시장 직관"이 없습니다. "이 사용자 유형은 정말 베팅을 안 할 사람들인가?", "이 수익화 모델이 정말 한국 시장에 맞는가?" 같은 직관은 사용자만 갖고 있습니다.

시간: 약 30분~1시간. / 산출물: SPEC v3 (사용자 직관이 v2 위에 더해진 버전).

단계 ⑤ — SPEC v3 → 두 검토자 → SPEC v4

SPEC v3에 대해 두 번째 검토를 받습니다. 이때 처음과 다른 패턴:

• Claude 시뮬레이션 검토 (Claude에게 "이 SPEC의 약점을 찾아줘" 요청)
• 외부 Gemini 검토 (실제 외부 모델)

시간: 약 1.5시간 (두 검토 + v4 통합). / 산출물: SPEC v4 (12건 모두 반영 + 통합).

단계 ⑥ — PLAN v1 → v2 작성

SPEC v4를 기반으로 "언제 · 어떤 순서로 · 얼마나"를 PLAN.md에 적습니다.

4가지 골격:

PLAN v1 작성 → 시간 산식 점검 → "+29h 부담 발생" 같은 갭 발견 → 옵션 A·B·C 중 채택 → PLAN v2.

시간: 약 3시간 (v1 작성 + 갭 분석 + v2 패치). / 산출물: PLAN v2.1 (시간 갭 흡수 옵션 채택 후).

단계 ⑦ — REVIEW.md 작성 → READY: YES → BUILD 시작

10가지 체크리스트로 SPEC v4 + PLAN v2.1을 점검합니다. 외부 검토와 다른 자기 검증.

3단계 판정: PASS — 명확히 통과 / WITH-CONDITIONS — 조건부 통과 / FAIL — 미통과

READY 진입 기준: FAIL 0건 + WITH-CONDITIONS ≤ 3건.

5파일+ 사이클의 7단계가 어떻게 "표준 도구의 워크플로우"와 같고 다른지를 보겠습니다.

GSD (TÂCHES) 워크플로우

/gsd-new-project       → 질문 + 연구 + 요구사항 + 로드맵 (자동)
/gsd-discuss-phase 1   → 1단계의 세부 결정 논의
/gsd-plan-phase 1      → 1단계 작업 계획 수립
/gsd-execute-phase 1   → 코드 실행 (병렬 wave)
/gsd-verify-work 1     → 결과 검증
/gsd-ship 1            → PR 생성 + 출시

한 줄 평가: 6개 명령으로 한 phase 완성. 자동화 깊이 가장 깊음. "질문 → 연구 → 요구사항 → 로드맵"이 한 명령 (/gsd-new-project) 안에서 자동 진행.

GitHub Spec-Kit 워크플로우

/speckit.constitution    → 프로젝트 헌법 정의 (한 번)
/speckit.specify         → 명세 작성
/speckit.clarify         → 모호함 객관식 정리
/speckit.analyze         → 명세 일관성 자동 검증
/speckit.checklist       → 검증 체크리스트
/speckit.implement       → 코드 생성

한 줄 평가: 헌법 + 명세 + 분석 + 구현. "NEEDS CLARIFICATION"으로 모호함 자동 표시.

OpenSpec 워크플로우

openspec/changes/{name}/proposal.md 작성
↓
/opsx-explore         → 대화형 elicitation
↓
/opsx:apply           → 구현
↓
openspec/specs/ 머지  → source of truth

한 줄 평가: "전체 명세"가 아니라 "변경 제안 (delta)"만 적음. 가벼움.

BMAD-METHOD 워크플로우

Mary (분석가)         → requirements.md
↓
Preston (PM)          → PRD
↓
Winston (아키텍트)    → architecture.md
↓
Sally (PO)            → story breakdown
↓
Devon (개발자)        → 구현
↓
Quinn (QA)            → test strategy

한 줄 평가: 7~8개 페르소나 협업으로 단계별 산출물. 깊이 가장 깊지만 무거움.

5파일+ 사이클의 자리

5파일+ 사이클은 한 번 도는 게 아닙니다. 프로젝트 진행 내내 같은 사이클이 반복됩니다.

한 사이클의 결과물

7단계가 끝나면 손에 들리는 것:

프로젝트폴더/
├── SPEC.md          (12~24KB) — v4까지 진화 + E1 회색지대
├── PLAN.md          (18~28KB) — v2.1 + E2 1인 페이스
├── REVIEW.md        (12~17KB) — 10가지 체크 + E3 두 검토자 결과
├── BUILD.md         ( 4KB)   — placeholder, BUILD 시작 후 매일 갱신
├── CLAUDE.md        ( 7KB)   — 200줄 + E5 콘텐츠 SSOT 규칙
└── .gitignore + git history (첫 commit)

5파일 합계 약 53~80KB. 줍줍은 53KB, TSV는 80KB.

BUILD 단계의 작은 사이클

[Day N 작업 4시간]
       ↓
[BUILD.md 일자별 로그 5분]  ← E4 LogOnTable 적용
       ↓
[CLAUDE.md 갱신 (필요 시)]  ← E5 적용
       ↓
[git commit]
       ↓
[/clear]
       ↓
[새 세션 — "5파일 읽고 현재 파악"]
       ↓
[Day N+1 작업 4시간]

Phase 단위의 큰 사이클

[Phase 1.0 BUILD 33일]
       ↓
[Phase 1.0 게이트 통과] (Day 33)
       ↓
[Phase 1.1 PLAN 초안] (SPEC v5 등장 가능)
       ↓
[Phase 1.1 외부 검토] (E3 다시 작동)
       ↓
[Phase 1.1 SPEC v5/PLAN v3]
       ↓
[Phase 1.1 REVIEW]
       ↓
[Phase 1.1 BUILD 시작]

매 사이클마다 5확장이 다시 작동

같은 5파일+ 사이클이 "다른 도메인"에 어떻게 적용되는지 두 프로젝트 비교로 보겠습니다.

줍줍 (2탄, B2C 앱, 10주)

TotalSportsView (3탄, 미디어 플랫폼, 12개월)

두 프로젝트 비교

5파일+ 사이클이 작동하는 가장 마법 같은 순간이 있습니다. 새 세션 시작의 한 줄입니다.

SPEC.md, PLAN.md, REVIEW.md, BUILD.md, CLAUDE.md를 읽고
현재 상황을 파악한 뒤 다음 단계를 알려줘.

이 한 줄이 "5파일+ 사이클의 진입점"입니다. Claude Code가 5파일을 읽으면:

• SPEC.md → 무엇을 만드는지 인지
• PLAN.md → 언제 어떤 순서인지 인지
• REVIEW.md → BUILD 진입 준비 상태 인지
• BUILD.md → 지금까지 무엇을 했는지 인지
• CLAUDE.md → 어떤 규칙·금지·완성된 것 인지

→ Claude가 "현재 상황 + 다음 단계"를 즉시 답합니다.

비개발자 동업자께 — 이게 왜 마법인가