검증 리포트
본 핸드북의 방법론·참고문헌·용어·프레임워크의 정합성을 검증한 과정과 결과 정리
이 핸드북에 수록된 방법론, 참고문헌, 프레임워크 인용이 정확한지 검증한 과정과 결과를 정리합니다.
검증 기준일
최초 2026년 2월 1일, 최신 업데이트 2026년 5월 7일 기준으로 검증을 수행했습니다. 본 핸드북은 방법론/전략 중심이지만, AI 에이전트 프로토콜, Agentic AI 보안, Claude Code/Codex 운영 예시처럼 변동 가능성이 큰 정보는 기준일과 함께 다시 점검했습니다.
검증 방법론
세 단계로 나누어 콘텐츠 정합성을 점검했습니다.
1단계: 내부 교차검증
전체 12개 챕터의 용어, 프레임워크, 흐름을 상호 대조하여 다음을 점검했습니다.
- 용어 일관성: 같은 개념이 여러 챕터에서 동일하게 정의되는지 (예: Thin Slice, 판정 기준, 학습 루프)
- 프레임워크 정합성: 가설 템플릿(6줄)이 Ch2/Ch7/Ch12에서 동일한지
- 챕터 간 링크: 내부 참조가 올바른 챕터를 가리키는지
- 흐름 논리: 가설 → 실험 → 계측 → 판정의 루프가 논리적으로 연결되는지
2단계: 참고문헌 검증
각 챕터에서 인용한 참고문헌의 저자, 서명, 핵심 개념이 정확한지 확인했습니다.
| 참고문헌 | 인용 챕터 | 검증 항목 | 결과 |
|---|---|---|---|
| Eric Ries, The Lean Startup | Ch1, Ch4, Ch11 | Build-Measure-Learn 루프, Pivot or Persevere | 정확 |
| Ash Maurya, Running Lean | Ch1, Ch2 | Lean Canvas, Problem-Solution Fit | 정확 |
| Rob Fitzpatrick, The Mom Test | Ch1, Ch2, Ch3 | 고객 인터뷰 편향 제거 기법 | 정확 |
| Marty Cagan, Inspired | Ch1, Ch5 | Product Discovery vs Delivery 분리 | 정확 |
| Marty Cagan, Empowered | Ch11 | 결과(outcome) 책임 조직 구조 | 정확 |
| Teresa Torres, Continuous Discovery Habits | Ch2 | 주간 고객 접촉 습관 | 정확 |
| Jeff Gothelf & Josh Seiden, Lean UX | Ch3 | 가설 주도 디자인 | 정확 |
| David J. Bland & Alexander Osterwalder, Testing Business Ideas | Ch3, Ch4 | 44가지 실험 기법 카탈로그 | 정확 |
| Cindy Alvarez, Lean Customer Development | Ch4 | Concierge/WoZ 고객 개발 | 정확 |
| Jake Knapp, Sprint | Ch7 | 5일 디자인 스프린트 | 정확 |
| Gabriel Weinberg & Justin Mares, Traction | Ch10 | 19가지 채널, Bullseye 프레임워크 | 정확 |
| April Dunford, Obviously Awesome | Ch10 | 포지셔닝 프레임워크 | 정확 |
| Sean Ellis & Morgan Brown, Hacking Growth | Ch10 | 성장 실험 루프 | 정확 |
| Annie Duke, Thinking in Bets | Ch11 | 불확실성 속 의사결정 | 정확 |
| Dave McClure, Pirate Metrics (AARRR) | Ch8 | 5단계 사용자 메트릭 | 정확 |
| Kerry Rodden et al., Google HEART Framework | Ch8 | 사용자 경험 계측 프레임워크 | 정확 |
| Anthropic, Subagents | Ch1, Ch5 | 역할 분리, 컨텍스트 분리 | 정확 (2026-05-07 재점검) |
| Anthropic, Effective Harnesses for Long-Running Agents | Ch5, Ch6 | 초기화+코딩 에이전트 패턴, 진행 파일 | 정확 (2026-05-07 재점검) |
| Anthropic, Hooks reference | Ch5, Ch9, Ch12 | hooks schema, matcher 형식, 이벤트 구조 | 정확 (2026-05-07 재점검) |
| Anthropic, Manage Claude's memory | Ch6, Ch12 | CLAUDE.md, CLAUDE.local.md, 계층 적용 범위 | 정확 (2026-05-07 재점검) |
| Anthropic, GitHub Actions | Ch5, Ch9 | CI 연동 방식 | 정확 (2026-05-07 재점검) |
| Anthropic, Pricing | Ch5 | Claude 모델 가격 | 정확 (2026-05-07 재점검) |
| Google Cloud, AI Business Trends 2026 | Ch1, Ch10 | AI 에이전트의 비즈니스/GTM 적용 흐름 | 정확 (2026-05-07 재점검) |
| Google, A developer's guide to AI agent protocols | Ch3, Ch5 | MCP, A2A 등 프로토콜 역할 구분 | 정확 (2026-05-07 재점검) |
| OpenAI, Using tools in the Agents SDK | Ch5, Ch12 | specialist-as-tool, guardrails, MCP 연결 | 정확 (2026-05-07 재점검) |
| BCG, Product Teams Can Make AI Sales Agents Smarter | Ch4, Ch8, Ch10 | 세일즈 에이전트와 제품팀 신호 연결 | 정확 (2026-05-07 재점검) |
| Five Eyes / ACSC, Careful adoption of agentic AI services | Ch9 | 최소 권한, 승인, 모니터링, containment | 정확 (2026-05-07 재점검) |
| arXiv, Using Generative Agents to Validate Product Concepts | Ch2, Ch11 | 합성 사용자 기반 제품 발견의 가능성과 한계 | 정확 (2026-05-07 재점검) |
3단계: 방법론 검증
핸드북의 핵심 방법론이 원출처의 정의와 일치하는지 확인했습니다.
| 방법론/개념 | 핸드북 정의 | 원출처 정의 | 판정 |
|---|---|---|---|
| Thin Slice | 한 사용자 여정을 끝까지 통과시키는 최소 기능 | "Walking skeleton" (Alistair Cockburn) + "Tracer bullet" (Pragmatic Programmer)의 변형 | 일치 (용어 변형) |
| Fake Door | 기능이 있는 것처럼 보여주고 반응 측정 | Testing Business Ideas의 "Fake Door" 실험 | 정확 일치 |
| Wizard-of-Oz | 사용자는 자동이라고 믿지만 내부 수동 처리 | The Lean Startup의 "Wizard of Oz MVP" | 정확 일치 |
| Concierge | 소수 고객에게 직접 서비스 제공 | The Lean Startup의 "Concierge MVP" | 정확 일치 |
| Build-Measure-Learn | 가설→실험→계측→학습 루프 | Eric Ries의 원형 루프 | 일치 (24~72h로 압축한 변형) |
| AARRR (Pirate Metrics) | 퍼널 기반 사용자 메트릭 | Dave McClure의 5단계 모델 | 정확 일치 |
| Spec-Driven Development | 스펙을 먼저 쓰고 AI가 구현하는 워크플로우 | GitHub SDD Toolkit, SpecKit 등 2025~2026 커뮤니티 합의 | 정확 일치 (2026-02-28 추가) |
| MCP (Model Context Protocol) | AI와 외부 도구를 연결하는 프로토콜 | Anthropic 공개, Linux Foundation(AAIF) 거버넌스 | 정확 일치 (2026-02-28 추가) |
| A2A (Agent2Agent) | 에이전트 간 작업/상태/메시지를 연결하는 프로토콜 | Google 개발자 가이드의 에이전트 상호운용 설명 | 정확 일치 (2026-05-07 추가) |
| Specialist-as-tool | specialist agent를 manager agent의 도구로 노출 | OpenAI Agents SDK 도구 사용 가이드 | 정확 일치 (2026-05-07 추가) |
| Agentic GTM | 메시지/채널/가격/세일즈 신호를 MVP 판정에 연결 | Google Cloud/BCG의 AI agent 비즈니스 적용 흐름 + 기존 GTM 실험 프레임워크 | 핸드북 적용 개념 (2026-05-07 추가) |
| Controlled autonomy | 에이전트 행동을 최소 권한·승인·관찰·롤백으로 통제 | Five Eyes/ACSC agentic AI 완화 지침 | 정확 일치 (2026-05-07 추가) |
검증 결과 요약
내부 교차검증, 참고문헌 검증, 방법론 검증을 통해 핵심 개념과 챕터 흐름에 중대한 정의 불일치가 없음을 확인했습니다. 2026-05-07 재점검에서는 Claude Code 기능 중심 설명을 제품/GTM 학습 루프 중심으로 재정렬하고, 에이전트 프로토콜·보안·세일즈 신호·합성 사용자 한계를 추가했습니다.
검증 결과
현재 버전은 챕터 간 개념 정합성과 핵심 내부 링크를 다시 점검한 상태입니다. 다만 AI 에이전트 프로토콜, Claude Code/Codex 기능, 가격, 설정 schema처럼 시한성이 큰 정보는 배포 시점마다 공식 문서를 다시 확인하는 것을 전제로 합니다.
발견된 개선 사항과 수정 내역
검증 과정에서 발견된 콘텐츠 품질 개선 사항과 수정 내역입니다.
개선 1: 참고문헌 부재
| 항목 | 내용 |
|---|---|
| 문제 | 원본 12개 챕터에 참고문헌(References) 섹션이 없었음 |
| 영향 | 독자가 원출처를 추적하기 어려움, 방법론의 신뢰성 근거 부족 |
| 수정 | 전 챕터에 관련 참고문헌 섹션 추가 |
| 해결일 | 2026-02-01 |
개선 2: 실전 예시 부족
| 항목 | 내용 |
|---|---|
| 문제 | 이론/템플릿은 체계적이나, 실제 적용 예시가 부족 |
| 영향 | 독자가 "어떻게 채워 넣는지" 파악하기 어려움 |
| 수정 | Ch2에 B2B SaaS 예시, Ch3에 실험 브리프 작성 예시, Ch4에 실전 예시, Ch6에 CONTEXT.md 예시 추가 |
| 해결일 | 2026-02-01 |
개선 3: 안티패턴/실패 가이드 부족
| 항목 | 내용 |
|---|---|
| 문제 | "이렇게 하라"는 있지만 "이렇게 하면 안 된다"가 부족 |
| 영향 | 흔한 실수를 사전에 방지하기 어려움 |
| 수정 | Ch1에 안티패턴 5가지, Ch7에 비상 플랜, Ch11에 의사결정 함정 테이블 추가 |
| 해결일 | 2026-02-01 |
개선 4: 계측 챕터 깊이 부족
| 항목 | 내용 |
|---|---|
| 문제 | Ch8(계측)이 이벤트 목록 수준에 머물러, 실제 분석 방법이 부족 |
| 영향 | 독자가 SQL로 퍼널/리텐션을 분석하는 방법을 알기 어려움 |
| 수정 | 이벤트 스펙 표 예시, 퍼널/리텐션/오류 SQL 예시 3종, 도구 선택 가이드 추가 |
| 해결일 | 2026-02-01 |
개선 5: GTM 챕터 분량 부족
| 항목 | 내용 |
|---|---|
| 문제 | Ch10(출시 & 성장)이 다른 챕터 대비 분량과 깊이가 부족 |
| 영향 | 채널 선택, 카피 작성, 랜딩 설계에 대한 실무 가이드 부족 |
| 수정 | 카피 5가지 각도 표, 채널 비교표, 랜딩 필수 요소, A/B 테스트 팁 추가 |
| 해결일 | 2026-02-01 |
개선 6: 품질 챕터 구체성 부족
| 항목 | 내용 |
|---|---|
| 문제 | Ch9(품질·보안·신뢰)의 QA 체크리스트와 PII 가이드가 추상적 |
| 영향 | "10개 실패 시나리오"를 만들라고 하면서 구체적 예시가 없었음 |
| 수정 | 실패 시나리오 10종 상세 테이블, PII 점검 6항목, AI 결과물 신뢰 가드레일 추가 |
| 해결일 | 2026-02-01 |
개선 7: 최신 Claude Code 기능 미반영
| 항목 | 내용 |
|---|---|
| 문제 | 2025~2026 Claude Code 핵심 기능(Hooks, 서브에이전트, Skills, 헤드리스 모드, MCP)이 반영되지 않음 |
| 영향 | 독자가 "역할 분리"를 프롬프트 수준으로만 이해하게 되어, 실제 가능한 자동화/병렬화를 활용하지 못함 |
| 수정 | Ch5에 서브에이전트, Hooks, 모델 선택 가이드, SDD, 헤드리스 모드 + CI/CD 섹션 추가 |
| 해결일 | 2026-02-28 |
개선 8: 컨텍스트 팩의 CLAUDE.md 연동 부재
| 항목 | 내용 |
|---|---|
| 문제 | 컨텍스트 팩을 "별도 파일"로 안내하고 있었으나, CLAUDE.md 자동 로드 메커니즘 미설명 |
| 영향 | 매 세션마다 "읽어줘"를 수동으로 하거나, CLAUDE.md 계층 구조를 모르고 플랫하게 관리 |
| 수정 | Ch6에 CLAUDE.md 계층 구조, Hooks vs CLAUDE.md 구분, Skills/커맨드 자동화, 세션 간 컨텍스트 관리 섹션 추가 |
| 해결일 | 2026-02-28 |
개선 9: Spec-Driven Development 트렌드 미반영
| 항목 | 내용 |
|---|---|
| 문제 | "바이브코딩"에서 SDD로의 전환 트렌드가 반영되지 않았음 |
| 영향 | 독자가 "대충 말하면 AI가 알아서" 패턴에 머물러, MVP 품질과 유지보수성이 떨어짐 |
| 수정 | Ch1에 2026년 트렌드 섹션, Ch5에 SDD 워크플로우(Plan→스펙→구현+자동검증) 추가 |
| 해결일 | 2026-02-28 |
개선 10: 자동화 도구 및 CI/CD 가이드 부재
| 항목 | 내용 |
|---|---|
| 문제 | Day 1부터 가능한 CI/CD 자동화(claude-code-action, 헤드리스 모드)와 Hooks 기반 품질 가드레일 미안내 |
| 영향 | 수동 코드 리뷰와 테스트에 의존하여 MVP 속도가 저하됨 |
| 수정 | Ch5에 CI/CD 섹션, Ch7에 Day 1 자동화 기반 설정, Ch9에 AI 코드 리뷰 자동화, Ch12에 Hooks/Skills 템플릿 추가 |
| 해결일 | 2026-02-28 |
개선 11: Claude Code 예시/가격/링크 최신화
| 항목 | 내용 |
|---|---|
| 문제 | Hooks JSON, CLAUDE.md 설명, 가격 표, 내부 링크 일부가 2026-03-06 기준 공식 문서와 어긋나거나 누락되어 있었음 |
| 영향 | 복사 실행 실패, 잘못된 비용 판단, 연관 문서 탐색 저하 |
| 수정 | Ch1/Ch3/Ch5/Ch6/Ch9/Ch12의 시한성 문구를 보수적으로 재작성하고 Hooks 예시를 공식 schema로 수정, 링크/참고 자료 보완 |
| 해결일 | 2026-03-06 |
개선 12: 제품/GTM 중심 최신 트렌드 미반영
| 항목 | 내용 |
|---|---|
| 문제 | 2026-03 업데이트가 Claude Code 기능 중심이라, 에이전트가 제품 발견·GTM·세일즈 신호에 미치는 변화가 부족했음 |
| 영향 | 독자가 코드 생성 속도에 집중하고, 메시지/채널/가격/반론/온보딩 신호를 MVP 판정에 충분히 반영하지 못함 |
| 수정 | 전 챕터에 Agentic GTM, 신호 품질, specialist 역할 분리, MCP/A2A/Agents SDK, controlled autonomy를 반영 |
| 해결일 | 2026-05-07 |
챕터별 검증 결과
| 챕터 | 파일 | 2026-02-01 개선 | 2026-02-28 개선 |
|---|---|---|---|
| Ch1. 원리 | principles.mdx | 전통 MVP 비교표, 안티패턴 5가지, 참고 자료 보강 | 2026년 트렌드(SDD, MCP, 역할 분리) 섹션 정리, 시한성 수치 보수화 |
| Ch2. 가설 | hypothesis.mdx | 나쁜/좋은 가설 비교, B2B 예시, 참고 자료 보강 | — |
| Ch3. 실험 설계 | experiment-design.mdx | 실험 브리프 예시, 인터뷰 원칙, 참고 자료 보강 | MCP 서버 활용 팁을 공식 Registry 기준으로 정리 |
| Ch4. 실험 타입 | experiment-types.mdx | 선택 플로우차트, 비용/학습량 비교표, 실전 예시, 참고 자료 보강 | — |
| Ch5. Agentic 운영 | claude-os.mdx | 팀 규모별 역할 배분 가이드, 참고 자료 보강 | 대폭 업데이트: 서브에이전트 역할 분리, SDD 워크플로우, Hooks 가드레일, 모델 선택 가이드, 헤드리스 모드+CI/CD, 가격/설정 최신화 |
| Ch6. 컨텍스트 팩 | context-pack.mdx | 컨텍스트 팩 작성 예시, 참고 자료 보강 | 대폭 업데이트: CLAUDE.md 계층 구조, Hooks vs CLAUDE.md 구분, 커맨드/스킬 자동화, 세션 간 컨텍스트 관리, 루트/로컬 메모 정리 |
| Ch7. 7일 플랜 | sprint-7day.mdx | Gantt 타임라인, 비상 플랜 테이블, 참고 자료 보강 | Day 1에 CLAUDE.md+Hooks 설정, Day 2에 Plan 모드, Day 3에 CI/CD 설정 추가 |
| Ch8. 계측 | analytics.mdx | 이벤트 스펙 표, SQL 3종, 도구 가이드, 참고 자료 보강 | — |
| Ch9. 품질/보안 | quality-safety.mdx | 실패 시나리오 10종, PII 체크리스트, AI 가드레일, 참고 자료 보강 | AI 코드 리뷰 자동화, Hooks 가드레일 예시를 현재 schema 기준으로 수정 |
| Ch10. GTM | go-to-market.mdx | 카피 5각도, 채널 비교, 랜딩 필수 요소, 참고 자료 보강 | — |
| Ch11. 의사결정 | decision.mdx | Go/Pivot/Kill 신호, Pivot 유형 표, 의사결정 함정, 참고 자료 보강 | — |
| Ch12. 템플릿 | templates.mdx | Learning Report, 컨텍스트 팩 템플릿 | CLAUDE.md 형식 정리, Hooks 설정 템플릿을 현재 schema로 수정, 커스텀 스킬 예시 유지 |
| 챕터 | 파일 | 판정 |
|---|---|---|
| — | — | 전 챕터에 개선 사항이 적용되었습니다 |
검증 한계
검증 범위 안내
본 핸드북은 방법론·전략 중심이므로, 법령·세율·정책 같은 시한성 수치 검증은 대상이 아닙니다.
참고문헌은 서명·저자·핵심 개념 수준에서 검증했으며, 페이지 번호까지는 대조하지 않았습니다.
방법론의 실무 효과성은 팀/도메인/시장에 따라 다를 수 있으므로, 프레임워크를 상황에 맞게 조정하는 것을 권장합니다.
SQL 예시는 PostgreSQL 기준이며, 사용하는 DB/분석 도구에 따라 문법 조정이 필요할 수 있습니다.
Claude Code/Codex 기능, 가격, 설정 schema, 에이전트 프로토콜은 2026-05-07 기준이며 빠르게 변할 수 있으므로, 배포 전 공식 문서를 다시 확인하세요.
검증에 사용한 최신 공식 자료
- Anthropic, Subagents
- Anthropic, Hooks reference
- Anthropic, Manage Claude's memory
- Anthropic, GitHub Actions
- Anthropic, Pricing
- Model Context Protocol, Official MCP Registry
- Anthropic, 2026 Agentic Coding Trends Report
- Anthropic, Effective Harnesses for Long-Running Agents
- OpenAI, Using tools in the Agents SDK
- OpenAI, Codex configuration reference
- Google, A developer's guide to AI agent protocols
- Google Cloud, AI Business Trends 2026
- Five Eyes / ACSC, Careful adoption of agentic AI services
- BCG, Product Teams Can Make AI Sales Agents Smarter
업데이트 내역
2026-05-07: 제품/GTM 중심 Agentic MVP 리프레시
배경: AI 에이전트 도구가 단순 코드 생성에서 제품 발견, GTM, 세일즈, 운영 자동화로 확장됨에 따라 핸드북의 중심을 "도구 기능"에서 "시장 신호를 더 빨리 얻는 운영 체계"로 재정렬했습니다.
주요 변경 사항:
| 챕터 | 변경 유형 | 내용 |
|---|---|---|
| 표지/Ch1 | 주요 업데이트 | 2026-05 기준 업데이트, 제품 신호 플라이휠, 표지·원리 삽화 추가 |
| Ch2~Ch4 | 주요 업데이트 | 제품 약속, GTM 신호, Agent-Assisted GTM 실험, 합성 사용자 한계 추가 |
| Ch5~Ch6 | 전면 재정리 | Agentic 운영 체계, Discovery/GTM/Build/Analytics/Risk 역할과 CLAUDE.md/AGENTS.md 병행 |
| Ch7~Ch8 | 주요 업데이트 | 7일 시장 검증 스프린트, 신호 품질 점수, GTM 이벤트 추가 |
| Ch9 | 주요 업데이트 | 최소 권한, 사람 승인, 모니터링, 롤백, containment 가드레일 추가 |
| Ch10~Ch12 | 주요 업데이트 | Agentic GTM 운영, 증거 등급, 권한 매트릭스, 최신 프롬프트 추가 |
| 이미지 | 신규 추가 | /images/agentic-mvp/ 경로에 1600x900 JPG 삽화 6장 추가 |
검증 항목:
| # | 항목 | 검증 결과 | 근거 |
|---|---|---|---|
| 1 | MCP/A2A 역할 구분 | 확인 | Google agent protocol guide, MCP Registry |
| 2 | Agents SDK specialist-as-tool 패턴 | 확인 | OpenAI Agents SDK tools guidance |
| 3 | Agentic GTM/세일즈 신호 | 확인 | Google Cloud AI Business Trends, BCG |
| 4 | Agentic AI 통제·containment | 확인 | Five Eyes / ACSC guidance |
| 5 | 합성 사용자 기반 검증 한계 | 확인 | arXiv product concept validation study |
2026-03-13: Claude Code v2.1.74 + Agentic Trends 반영
배경: Claude Code v2.1.74까지의 변경사항과 Anthropic 2026 Agentic Coding Trends Report를 반영하여 핵심 챕터를 업데이트했습니다.
주요 변경 사항:
| 챕터 | 변경 유형 | 내용 |
|---|---|---|
| Ch1. 원리 | 섹션 추가 | 워크트리 병렬 개발, 멀티에이전트 조율(3~7개 에이전트 팀) 트렌드 반영 |
| Ch5. Agentic 운영 | 주요 업데이트 | 워크트리 기반 병렬 개발(isolation: worktree), /batch 명령, HTTP hooks, effort 단순화, claude-code-action v1.0 GA, Haiku 4.5 가격 추가 |
| Ch6. 컨텍스트 팩 | 섹션 추가 | CLAUDE.md 200줄 이하 운영 가이드라인(92%+ 적용률), /context 진단 명령 |
| Ch9. 품질/보안 | 섹션 추가 | /simplify 3-에이전트 병렬 리뷰, claude-code-action v1.0 GA |
| 표지(index) | Callout 업데이트 | 2026-03-13 업데이트 내용 반영 |
| 검증 리포트 | 내용 갱신 | 2차 검증 결과 + 업데이트 내역 추가 |
2차 검증 항목:
| # | 항목 | 검증 결과 | 근거 |
|---|---|---|---|
| 1 | Claude Code v2.1.74 (2026-03-12) | 확인 | 공식 CHANGELOG, GitHub releases |
| 2 | 워크트리 지원 (isolation: worktree, v2.1.50+) | 확인 | 공식 문서, /batch 명령 |
| 3 | HTTP hooks (v2.1.63+) | 확인 | 공식 Hooks reference |
| 4 | /simplify·/batch 명령 (v2.1.63+) | 확인 | 공식 릴리즈 노트 |
| 5 | claude-code-action v1.0 GA | 확인 | GitHub anthropics/claude-code-action@v1 |
| 6 | effort 수준 단순화 (low/medium/high, v2.1.70+) | 확인 | 릴리즈 노트 |
| 7 | CLAUDE.md 200줄 이하 92%+ 적용률 | 확인 | Anthropic 공식 문서 |
2026-03-06: 정합성/운영 가이드 재정비
배경: Agentic MVP 핸드북 전반을 다시 리뷰하면서, Claude Code 관련 설정 예시와 가격표, 내부 링크,
참고 자료 누락을 정리했습니다.
주요 변경 사항:
| 챕터 | 변경 유형 | 내용 |
|---|---|---|
| Ch1. 원리 | 문구 조정 | 시한성 수치 제거, 2026년 트렌드 설명을 보수적 표현으로 정리 |
| Ch3. 실험 설계 | 문구 조정 | MCP 관련 과장된 수치 제거, Registry 기준 안내로 수정 |
| Ch5. Agentic 운영 | 예시/수치 수정 | Hooks schema 최신화, 가격 표 최신화, CI 자동화 효익 표현을 정량치 대신 운영 관점으로 수정 |
| Ch6. 컨텍스트 팩 | 구조 수정 | CLAUDE.md / CLAUDE.local.md / 디렉터리별 메모 적용 범위를 명확화 |
| Ch9. 품질/보안 | 예시 수정 | Hooks 예시를 현재 schema 기준으로 교체, 자동화 효과 서술 정리 |
| Ch12. 템플릿 | 템플릿 수정 | CLAUDE.md 설명과 Hooks 템플릿을 현재 schema 기준으로 정리 |
| 표지(index) | 링크 수정 | 연관 핸드북 링크 문법 수정 |
| 검증 리포트 | 내용 갱신 | 결과 요약/근거 자료/업데이트 내역을 현재 상태에 맞게 정리 |
2026-02-28: 최신 Claude Code AI 트렌드 반영
배경: 2025~2026년 Agentic AI 개발 생태계가 급변함에 따라, 핸드북에 반영되지 않은 핵심 기능과 방법론을 점검하고 업데이트했습니다.
주요 변경 사항:
| 챕터 | 변경 유형 | 내용 |
|---|---|---|
| Ch1. 원리 | 섹션 추가 | "2026년: 에이전트가 팀원이 되는 시대" — SDD, MCP 생태계, 에이전트 자율성 트렌드 |
| Ch3. 실험 설계 | Callout 추가 | MCP 서버로 실험 도구 연동 팁 |
| Ch5. Agentic 운영 | 대폭 업데이트 | 서브에이전트 역할 분리, SDD(Spec-Driven Development) 워크플로우, Hooks 가드레일(PostToolUse/PreToolUse), 모델 선택 가이드(Sonnet 4.6 vs Opus 4.6), 헤드리스 모드 + CI/CD 자동화 |
| Ch6. 컨텍스트 팩 | 대폭 업데이트 | CLAUDE.md 계층 구조(자동 로드), Hooks vs CLAUDE.md 구분, Skills/커맨드 자동화, 세션 간 컨텍스트 관리(진행 파일 패턴) |
| Ch7. 7일 플랜 | 항목 추가 | Day 1에 CLAUDE.md+Hooks 설정, Day 2에 Plan 모드 활용, Day 3에 CI/CD 설정 |
| Ch9. 품질/보안 | 섹션 추가 | AI 기반 코드 리뷰 자동화(claude-code-action), Hooks 가드레일 JSON 예시 |
| Ch12. 템플릿 | 템플릿 추가/수정 | CONTEXT.md → CLAUDE.md 형식 변환, Hooks 설정 템플릿, 커스텀 스킬 예시 |
| 표지(index) | Callout 추가 | 2026년 2월 업데이트 안내, 핵심 요약 문구 현대화 |
| 검증 리포트 | 업데이트 | 참고문헌 3건, 방법론 2건 추가, 개선 사항 4건(#7~#10) 추가, 챕터별 결과 테이블 갱신 |
추가된 참고문헌: Anthropic Subagents, Anthropic Effective Harnesses for Long-Running Agents, Anthropic Manage Claude's memory
추가된 방법론 검증: Spec-Driven Development, MCP (Model Context Protocol)
2026-02-01: 초판 발행 및 1차 개선
초판 12개 챕터 발행. 참고문헌 16건, 실전 예시, 안티패턴, SQL 예시 등 6건의 개선 사항 적용.