📑 이 챕터에서 다룰 내용
이 가이드는 1탄 v1.0의 14개 챕터 + 8개 부록을 1탄 v2로 정정렬하기 위한 변경 패턴 일람입니다. v1.0 docx 본문은 보존하면서 "용어 통일 + reference 박스 + 정리 박스 + 챕터 번호 변경"만 적용합니다.
v1.0 docx를 열고 이 가이드의 (A)·(B)·(C) 순서로 차례로 적용합니다. 총 작업 시간은 약 4~6시간입니다.
가장 먼저 docx 전체에 일괄 변경을 적용합니다. 이게 정정렬 작업의 50%입니다.
| v1.0 | v2 |
|---|---|
| 0장 | 새 2장 |
| 1장 | 새 3장 |
| 2장 | 새 4장 |
| 3장 | 새 5장 |
| … | … |
| 30장 | 새 32장 |
| (없음) | 새 33장 (신설) |
docx의 모든 챕터 제목에서 ^(\d+)장 패턴을 찾아 숫자 +2를 적용합니다.
| 찾기 | 바꾸기 | 비고 |
|---|---|---|
GSD 워크플로우 | 5파일+ 사이클 | 챕터 제목·본문 |
GSD = Get Stuff Done | 5파일+ 사이클 (Spec→Plan→Review→Build→배포 5단계) | 부록 D-3 |
/gsd:plan | (자연어 + /model + /effort) | 본문 슬래시 명령 |
/gsd:execute-phase N | (자연어 + /model claude-sonnet-4-6) | 본문 |
/gsd:verify-work | (자연어로 REVIEW 작성 요청) | 본문 |
5파일 체계 | 5파일+ 체계 | 전체 |
5파일 + GSD | 5파일+ | 전체 |
LogOnTable 앱 | LogOnTable 앱 (1탄 v1.0 사례) 또는 줍줍 / TSV | 새 사례 노출 |
v2에서 "GSD"라는 단어는 TÂCHES의 GSD 도구만 가리킵니다 (Get Shit Done). 우리 자체 사이클은 "5파일+ 사이클"로 표기합니다.
모든 정정렬 챕터 끝 (기존 "📌 이 장의 핵심" 박스 다음) 에 "📘 정리 박스 (참조용)"를 추가합니다. 표준 양식은 다음과 같습니다.
## 📘 새 N장 정리 박스 (참조용) > **핵심 한 줄**: [챕터의 핵심 한 문장] > > **표준 흡수 매핑** (해당 시): > - GSD: [매핑] > - Spec-Kit: [매핑] > - 기타: [매핑] > > **5파일+ 결합** (해당 시): > - SPEC.md / PLAN.md / REVIEW.md / BUILD.md / CLAUDE.md > > **5확장 결합** (해당 시): > - E1~E5 중 어느 것이 이 챕터에서 보조 등장 > > **두 사례** (해당 시): > - 줍줍 적용 > - TSV 적용 > > **다음 장**: 새 (N+1)장 — [다음 챕터 제목].
이 양식을 14개 챕터에 차례로 적용합니다. 챕터당 약 200~400 단어입니다.
각 정정렬 챕터에 1~2개 "표준 도구의 자리" reference 박스를 추가합니다. 챕터 도입부 또는 적절한 절에 삽입합니다.
새 12장 (v1 10장 — Context Engineering)
| 도구 | Context 관리 |
|---|---|
| GSD | STATE.md (결정·차단·세션 메모리) |
| Spec-Kit | constitution + agent-agnostic |
| OpenSpec | AGENTS.md (fallback agent context) |
| Cursor | .cursorrules |
| Cline | .clinerules |
5파일+ 의 Context = CLAUDE.md (200줄) + 4파일 자동 로드.
새 13장 (v1 11장 — 프롬프트 라이브러리 P1~P50)
9개 표준 도구 모두 자체 프롬프트 패턴 보유. 5파일+ 의 P1~P50은 Claude Code 직접 사용에 특화합니다. 표준 도구로 옮긴 후에는:
- GSD: 86 skills 안에 비슷한 패턴 내장
- Spec-Kit: /speckit.* 명령에 패턴 내장
- 5확장 패턴 (E1~E5 결정 트리거) 은 자체 보강
새 15장 (v1 13장 — Channels·Subagents·Hooks)
| 도구 | 자동화 |
|---|---|
| GSD wave | 의존성 자동 분석 + 병렬 wave |
| BMAD | 7~8 페르소나 자체 협업 |
| Cursor | hooks + commands |
| 5파일+ | Subagents (새 23장) + Hooks + 헤드리스 모드 |
새 16장 (v1 14장 — Claude.ai Skills)
- GSD: 86 skills (full mode) / 6 skills (--minimal)
- Claude.ai: 사용자 정의 Skills (이 장)
- 5파일+ 운영용 추천 커스텀: /daily-review, /gate-check 등 7개 (새 10장)
새 17장 (v1 15장 — NotebookLM 심화)
NotebookLM은 외부 문서 (논문·기사·법령) 를 단일 출처로 사용 가능합니다. 줍줍의 "공공데이터 API 4개" + TSV의 "5리그 공식 자료"가 NotebookLM 인덱싱 후보입니다. SPEC §3 기능 정의 단계에서 활용합니다.
새 20장 (v1 18장 — CI/CD·운영·보안)
| 도구 | CI/CD |
|---|---|
| GSD | /gsd-ship 명령에 PR + 배포 자동 |
| Spec-Kit | /speckit.implement 후 별도 배포 |
| 5파일+ | git pre-commit hook + GitHub Actions + Sentry |
5확장 결합:
- E1: CI에서 회색지대 정책 위반 자동 검사
- E2: 1주 누적 시간 자동 알림 (R4 트리거)
- E5: 페르소나 일관성 자동 테스트 (cron 정지 트리거)
새 21장 (v1 19장 — 토큰 최적화)
토큰 최적화의 핵심은 멀티모델 (새 28장) 과 결합됩니다. Sonnet/Haiku 활용으로 -60~80% 비용 절감, cache_control (E5 페르소나 system prompt) 로 -50% 추가 절감 가능합니다.
5확장 E2 1인 페이스: 토큰 비용 폭주 = R4 트리거 한 단계 가속.
새 22장 (v1 20장 — 성장 경로)
성장 경로의 다음 단계가 새 33장 (자유 창작 준비)입니다. 1탄·2탄·3탄 완독 시 새 프로젝트 자유 시작. 권7 (표준+확장 컴패니언) 에서 다룹니다.
새 24장 (v1 22장 — Memories + Checkpointing)
AutoMemory + Checkpointing은 Claude Code 내장 자동화입니다. 5파일+ 의 CLAUDE.md (200줄 헌법) 와 보완 관계입니다:
- CLAUDE.md = 명시적 규칙 (인간이 의식적으로 박음)
- AutoMemory = 자동 학습 패턴 (Claude가 발견)
- Checkpointing = 작업 중단 후 복원
둘 다 활용하되 CLAUDE.md가 우선 (명시 > 자동).
새 25장 (v1 23장 — ECC 플러그인)
ECC (Extra Cautious Claude) 1,282 보안 규칙은 5확장 E1 회색지대 결정과 보완 관계입니다:
- ECC = 코드 보안 자동 점검
- E1 회색지대 = 사업·법적 안전 위치 결정 (코드 외)
둘 다 필요합니다. ECC만으로는 사업 결정 안전성 검증이 불가능합니다.
새 26장 (v1 24장 — Obsidian + 제텔카스텐)
Obsidian 제텔카스텐 = 외부 지식 보존 시스템. E4 LogOnTable = 프로젝트 결정 트레이스 보존.
두 시스템이 다른 영역입니다. 결정 트레이스는 BUILD.md, 외부 지식은 Obsidian. 혼합하지 마세요.
새 27장 (v1 25장 — Managed Agents)
- Agent Teams (새 23장): 동일 프로젝트 내 병렬 (
/delegate) - Managed Agents (이 장): 다른 프로젝트·다른 사용자 위임
5파일+ 운영 매뉴얼에서는 Agent Teams 우선입니다. Managed Agents는 권7 자유 창작 단계에서 다룹니다.
새 29장 (v1 27장 — Observability)
Observability = 운영 중 시스템 모니터링.
- E2 1인 페이스: 운영자 비상 알림 → 자동 휴식 트리거
- E5 콘텐츠 SSOT: 자동 일관성 테스트 fail 시 cron 정지
Sentry + Slack MCP (새 14장) + 헤드리스 모드 (새 10장) 결합입니다.
새 30장 (v1 28장 — 확장·협업·완성)
1탄 마무리 챕터입니다. 새 31~32장은 기존 프로젝트 적용 + 팀 협업, 새 33장은 자유 창작 준비.
1탄 졸업 시점 = 5파일+ 사이클 + 5확장 + 9개 표준 풍경이 손에 들려 있는 상태입니다.
새 31~32장 (v1 29~30장 — 기존 프로젝트 적용 + 팀 협업)
기존 프로젝트 (brownfield) 적용 시 OpenSpec을 추천합니다. 팀 협업 5명+ 시 BMAD-METHOD 또는 Spec-Kit을 추천합니다. 새 33장 33-3 의사결정 트리를 참조하세요.
부록 A — 서브에이전트 빠른 참조 카드 (정정렬)
- 챕터 번호: 21장 → 새 23장
- 5파일+ 결합 1줄 추가: "E5 콘텐츠 SSOT 적용 프로젝트는 Agent Teams 적합도 가장 높음"
부록 B — Memories + Checkpointing 빠른 참조 (정정렬)
- 챕터 번호: 22장 → 새 24장
- CLAUDE.md (새 11장) 와의 보완 관계 1줄 추가
부록 D — Glossary (전면 재작성 필요)
가장 큰 변경입니다. v1.0의 "GSD = Get Stuff Done" 정의가 완전히 변경됩니다.
| 구분 | 내용 |
|---|---|
| v1.0 부록 D-3 | GSD = Get Stuff Done. Spec→Plan→Review→Build→배포 5단계 워크플로우. |
| v2 부록 D-3 (변경) | GSD = Get Shit Done. TÂCHES 가 만든 솔로 자동화 SDD 도구 (58k★, npx 설치). 우리 책의 "5파일+ 사이클" 과는 다른 도구. acronym 충돌 회피 + 시장 GSD 인정. |
- "5파일+": 5파일 + 5확장 (E1~E5)
- "E1 회색지대 결정"
- "E2 1인 12개월 페이스"
- "E3 두 검토자 사각지대"
- "E4 LogOnTable 실황"
- "E5 콘텐츠 SSOT"
- "Position C" (TSV 사례)
- "Spec-Kit / OpenSpec / BMAD / Taskmaster / Intent / Kiro" (9개 표준 도구)
부록 E — 모델별 비용 비교 (정정렬)
- 챕터 번호: 26장 → 새 28장
- 새 28장 5명 비교 우위 표 그대로 사용
- OpenRouter 설정 추가
부록 F — 자주 발생하는 에러 50가지 (정정렬)
- 5파일+ 용어 통일만 적용
부록 O·P — 1탄 정정 사항 (정정렬)
- 챕터 번호 +2 일괄 적용
부록 Q — 1탄 도식 모음 (정정렬)
- 5파일 도식 → 5파일+ 도식 (5확장 추가)
- GSD 워크플로우 도식 → 5파일+ 사이클 도식 + 9개 표준 도구 풍경 도식 추가
부록 H — 5확장 분리 정리 (신설, 별도 파일 작성 완료)
파일: 1탄v2_부록H.md (23KB) 그대로 docx에 삽입합니다.
챕터 번호 +2 일괄 적용 후 용어 통일 일괄 적용 (GSD → 5파일+ 등)
14개 정정렬 챕터 끝에 표준 양식 적용. 챕터당 약 10분.
도입부 또는 적절한 절에 박스 삽입. 챕터당 약 5~10분.
부록 D 전면 재작성 (가장 큰 변경), 나머지 7개 부록 정정렬.
1탄v2_33장.md (15KB) → 부록 직전 위치 삽입. 1탄v2_부록H.md (23KB) → 부록 G 다음 위치 삽입.
pandoc으로 모든 .md → .docx 통합. 폴리시 스크립트 적용 (Heading 스타일 + 페이지 브레이크 + 폰트).
약 6~7시간 분산 작업을 권장합니다. 한 번에 몰아서 하지 마세요.
서문 (정정렬) 새 0장 — SDD 표준 풍경 (신설, 22KB) 새 1장 — 5파일+ 정체성 (신설, 33KB) 새 2장 — 프로젝트 시작 30분 (정정렬, 11KB) 새 3장 — Claude Code 설치 (정정렬, 8KB) 새 4장 — 5파일+ 사이클 (전면 재작성, 21KB) 새 5장 — SPEC.md + E1 (보강, 24KB) 새 6장 — PLAN.md + E2 (보강, 17KB) 새 7장 — Phase 분리 (정정렬, 8KB) 새 8장 — REVIEW.md + E3 (보강, 18KB) 새 9장 — BUILD.md + E4 (정정렬+신설, 14KB) 새 10장 — 슬래시 명령 (전면 재작성, 17KB) 새 11장 — CLAUDE.md + E5 (보강, 20KB) 새 12장 — Context Engineering (정정렬) 새 13장 — 프롬프트 라이브러리 (정정렬) 새 14장 — MCP 통합 (풀 본문 재작성, 16KB) 새 15장 — Channels·Subagents·Hooks (정정렬) 새 16장 — Claude.ai Skills (정정렬) 새 17장 — NotebookLM 심화 (정정렬) 새 18장 — 수익화 전략 (풀 본문 재작성, 15KB) 새 19장 — 배포 (풀 본문 재작성, 13KB) 새 20장 — CI/CD·운영·보안 (정정렬) 새 21장 — 토큰 최적화 (정정렬) 새 22장 — 성장 경로 (정정렬) 새 23장 — Agent Teams (풀 본문 재작성, 15KB) 새 24장 — Memories + Checkpointing (정정렬) 새 25장 — ECC 플러그인 (정정렬) 새 26장 — Obsidian + 제텔카스텐 (정정렬) 새 27장 — Managed Agents (정정렬) 새 28장 — 멀티모델 오케스트레이션 (풀 본문 재작성, 14KB) 새 29장 — Observability (정정렬) 새 30장 — 확장·협업·완성 (정정렬) 새 31장 — 기존 프로젝트 Claude Code 적용 (정정렬) 새 32장 — 팀과 함께 만들기 (정정렬) 새 33장 — 자유 창작 준비 (신설, 15KB) 부록 A — 서브에이전트 빠른 참조 (정정렬) 부록 B — Memories + Checkpointing 참조 (정정렬) 부록 D — Glossary (전면 재작성) 부록 E — 모델별 비용 비교 (정정렬) 부록 F — 자주 발생하는 에러 50가지 (정정렬) 부록 H — 5확장 분리 정리 (신설, 23KB) 부록 O — 1탄 정정 사항 (정정렬) 부록 P — 1탄 도식 모음 (정정렬) 부록 Q — 추가 도식 (정정렬)
총 32장 + 부록 9개 (v1.0 30장 + 부록 8개에서 +2장 +1부록).
docx 변환 완료 후 다음 항목을 점검합니다.
- ☐ 챕터 번호 0~33 모두 +2 적용됐는가
- ☐ "GSD" 단어가 TÂCHES 도구만 가리키는가 (자체 사이클은 "5파일+")
- ☐ 14개 정정렬 챕터 모두 정리 박스 있는가
- ☐ 14개 정정렬 챕터 모두 reference 박스 있는가
- ☐ 부록 D-3 GSD 정의가 v2 형태로 변경됐는가
- ☐ 부록 H (신설) 삽입됐는가
- ☐ 새 33장 (신설) 삽입됐는가
- ☐ 줍줍·TSV 두 사례가 본문에 자연 등장하는가
- ☐ 5확장 E1~E5 모두 등장 챕터에 명시됐는가
- ☐ /clear 후 새 세션에서 5파일 + 5확장 위치 답할 수 있는가
- ☐ 비개발자 동업자가 정독 가능한 톤인가
10개 모두 ✅ 시 1탄 v2 완성입니다.
이 가이드 적용 완료 시 1탄 v2 작업이 종료됩니다. 다음 단계로 진행합니다.
즉시 진행 가능
줍줍 10주 출시 매뉴얼 (v1 G0~G14 게이트형 → 줍줍 사례 재작성)
이미 작성된 권1 v2 제0~1장과 1탄 v2 새 0~1장 일치성 확인
중기 작업
줍줍 → TSV 톤 일치 (코드 분량 정당화 + 운영 매뉴얼 정체성)
TSV 12개월 여정
표준 + 확장 컴패니언
이 모든 작업이 1탄 v2의 정체성 위에서 작동하므로, 1탄 v2 완성이 시리즈 전체의 토대입니다.
- 1️⃣ (A) 일괄 변경: 챕터 번호 +2 + 용어 통일 (GSD → 5파일+) + 정리 박스 14개 추가
- 2️⃣ (B) reference 박스: 챕터별 "표준 도구의 자리" 박스 14개 (새 12·13·15~17·20~22·24~27·29~32장)
- 3️⃣ (C) 부록 변경: 부록 D GSD 정의 전면 재작성 + 5확장·9도구 추가 항목 + 부록 H 신설
- 4️⃣ 총 작업 시간: 약 6~7시간 분산 권장
- 5️⃣ 완성 기준: 10개 점검표 모두 ✅
- 6️⃣ 1탄 v2: 총 32장 + 부록 9개 (v1.0 대비 +2장 +1부록)
- 7️⃣ 1탄 v2 완성 = 시리즈 전체의 토대