소책자 9챕터 종합 — 설계 없이 코드 없다
별칭: 소책자 기획 · 9챕터 구조 · 책자 목차
요약
본 카드는 강의와 함께 출간될 소책자의 9 챕터 골격 을 박아 두는 종합 카드이다. 책 전체는 3 부 × 3 장 구조를 따른다 — Part 1 에서는 바이브 코딩 실패의 청구서 를 7 사고 사례와 함께 제시하고, Part 2 에서는 에이전틱 엔지니어링이라는 패러다임 시프트 가 어떻게 일어났는지 5 패턴 진화 (Prompt → Context → Vibe → Harness → Agentic) 로 추적하며, Part 3 에서는 도구 설계 철학 을 Hashimoto 의 4 단계 하네스 (Commands·Rules·Skills·Hooks) 로 기록한다. 각 챕터는 핵심 주장 1 문장 + 1 차 출처 + 강의 활용 포인트 라는 일관된 형식으로 작성되며, 챕터 본문은 본 위키의 섹션별 카드와 1:1 매칭되어 그 카드를 Ground Truth 로 삼아 작성 된다.
자매 카드 — synthesis/booklet-toc-17-chapters 와의 역할 구분 (2026-05-02):
카드 절단면 주 사용 시점 본 카드 (9 챕터) 주제 색인 — 실패 청구서 / 패러다임 시프트 / 도구 철학 책 다 읽고 재검색 / 주제별 깊이 재진입 17 장 + 부록 집필 골격 — 강의 6 섹션 1:1 흐름 처음 한 번 읽을 때 / 강의장에서 동행 두 안 공존. 본 카드는 17 장 안에서 부록 F (주제 색인) 자리.
상세
Part 1. 바이브 코딩의 환상과 숨겨진 청구서 (실패 사례 분석)
설계 없는 코딩이 초기 속도를 주지만, 결국 기술 부채와 운영 참사로 번진다는 구조적 한계.
| Ch | 제목 | 핵심 주장 | 매칭 위키 섹션 |
|---|---|---|---|
| 1 | 유포리아에서 혼돈으로: '3개월의 벽' | 계획 단계와 dev/prod 분리가 없으면 바이브 코딩은 운영 사고로 직결 (PocketOS DB 삭제, Replit Lemkin/Masad 사례) | 02 VBC |
| 2 | 시한폭탄: 기술 부채와 보안 재앙 | AI 코드는 인간 대비 논리 오류 1.75×, 보안 취약 2.74×, 중복 4× (GitClear 2.1억 줄) | 02 VBC |
| 3 | 디버깅 불능 세대 | 설계 없이 AI에 위임 시 디버깅 능력 17%+ 하락 (Anthropic RCT) | 02 VBC |
Part 2. 성공하는 AI 코딩의 패러다임 시프트: 에이전틱 엔지니어링
무지성 바이브 코딩의 종말 → Spec 중심·설계 중심의 정량적 성공.
| Ch | 제목 | 핵심 주장 | 매칭 위키 섹션 |
|---|---|---|---|
| 1 | 거인들의 경고: 타이핑이 아닌 판단·설계 | 엔지니어링 본질은 타이핑이 아니라 시스템 아키텍트 역할 (Altman·entity/karpathy 자기 부정) | 01 INT, 04 DSL |
| 2 | SDD의 실증 성과 | concept/spec-driven-development 도입 시 프로그래밍 −56%, PR 리뷰 −31.8% (MIT/MS, DeputyDev) | 04 DSL |
| 3 | 하네스 엔지니어링: 환경 통제로 +13.7점 | 모델 변경 없이 하네스 설계만으로 코딩 벤치마크 52.8 → 66.5 (LangChain) | 03 HRN |
Part 3. 2026 실전 AI 코딩 아키텍처 가이드 (도구 설계 철학)
최상위 도구들이 왜 설계 우선 을 시스템적으로 강제하는가.
| Ch | 제목 | 핵심 주장 | 매칭 위키 섹션 |
|---|---|---|---|
| 1 | 플랜 모드의 당위성 | Claude Code·entity/cursor 가 환각 차단을 위해 Plan Mode를 기본 UX로 강제 | 03 HRN |
| 2 | 규칙 파일의 마법 | CLAUDE.md / .cursorrules / AGENTS.md = 영구 지시어 = 매 세션 리로드되는 설계 문서 | 04 DSL |
| 3 | 오케스트레이션 + 5대 검증 | Goal / Constraints / Acceptance / Verification / Rules — 책상에 붙여놓을 카드 | 06 CLN |
방법론
이 카드의 활용:
- 소책자 집필 시작점: 각 챕터 작성자가 이 카드 → 매칭 위키 섹션 → 원천 source 순으로 drill-down.
- 강의 슬라이드 골격: 9챕터 = 강의 6단원과 1:1 매핑되지 않으므로, 챕터별 핵심 주장을 단원에 흩뿌려 사용.
- 검증 추적: 각 챕터의 출처 가 위키 카드의
source_refs에 남아있어, 강의에서 반박을 받으면 즉시 1차 출처로 환원 가능.
주의사항
- 이 카드는 기획안 그 자체 이지 최종 목차가 아니다. 집필 진행 중 챕터 분할이 변경될 수 있으므로
version갱신과log.md기록 필수. - Part 1의 실패 사례(PocketOS·Replit) 출처는 한 단계 더 깊은 1차 자료가 부족하다 — 본 강의에서 인용 시 추가 검증 권장.
- 9챕터를 강의 6단원에 강제로 1:1 매핑하지 않는다. 책 = 깊이 / 강의 = 흐름 로 역할 구분.
표어 정합
본 카드의 9 챕터 주제 색인 이 강의 표어 "AI-Native Vibe Coding: No Design, No Code" 의 주제별 절단면 이다. 설계 없이는 코딩이 안된다 (Thesis) 가 3 Part × 3 Chapter 로 분해되며, AI 에게 어떻게 일을 시키는가 (Corollary) 가 Part 3 도구 설계 철학에 기록된다.