16 장. 설계 먼저 선언 + 5 종 체크리스트 ★
"바이브 코딩이 실패하는 이유는 AI 가 코드를 못 써서가 아니라, *설계되지 않은 빈칸 을 AI 가 대신 결정하게 만들기 때문이다."
도입 — 결단의 자리
15 장의 시연을 눈으로 봤다. 그 다음에 학생 머리에 자연스럽게 떠오르는 한 가지 질문.
*"그러면 나는 내일부터 무엇을 해야 하나?"
16 장이 그 질문에 답한다. 5 종 체크리스트 + 3 줄 적기 + 오늘 저녁부터 시작. 이 셋이 합쳐서 행동 단계 (3 장 알렉스 4 단계의 4 단계) 의 입구 가 된다.
이 장은 결단 의 자리다. 1 ~ 15 장이 왜 와 무엇으로 였다면, 16 장은 결단. 그래서 짧고 강하다.
표어 회귀 — "여기까지가 왜 와 무엇으로 였습니다. 이 장은 결단 입니다."
핵심 명제 — 두 줄로 기록한다
이 책 전체의 결론을 두 줄 로 기록한다.
"바이브 코딩이 실패하는 이유는 AI 가 코드를 못 써서가 아니라, 설계되지 않은 빈칸 을 AI 가 대신 결정하게 만들기 때문이다."*
"좋은 팀은 코드를 먼저 쓰지 않고, 성공 조건을 먼저 쓴 뒤 AI 에게 구현을 맡깁니다."*
이 두 줄이 책 전체의 압축본 이다. 4 장의 7 사고 가 첫 줄 의 증거고, 15 장의 시연 이 둘째 줄 의 시연.
특히 첫 줄의 한 단어 — "설계되지 않은 빈칸" — 이 핵심이다. AI 가 자기 마음대로 결정한 게 아니다. *우리가 빈칸을 남겨 두니 — AI 가 그 빈칸을 채우는 일 을 자기 책임으로 받아들여서 * 그렇게 한 것이다.
해결책은 AI 를 막는 게 아니라 — 빈칸을 없애는 것. 그게 5 종 체크리스트 다.
AI 역할 재정의
먼저 흔한 오해 한 가지를 정정한다.
| 일반적 오해 | 정확한 이해 |
|---|---|
| AI = 설계자 + 구현자 | AI = 설계를 실행하는 가속기. |
*설계자가 AI 가 아니다. *설계자는 여러분. * AI 는 그 설계를 실행하는 도구. *둘의 분리가 흔히 흐려진다.
이걸 공식 으로 기록한다.
빈칸 + AI = AI 가 빈칸을 *임의 채움* = 의도와 다른 결과
설계 팩 + AI = AI 가 설계대로 *실행* = 예측 가능한 결과
4 장의 7 사고 가 모두 첫 공식 의 결과. 15 장 시연 이 둘째 공식 의 결과.
이 공식 차이가 3 분 (CLAUDE.md 작성) 에 있다. 3 분의 빈칸 채우기 가 3 시간의 디버깅 지옥을 차단 (7 장 ROI 메시지 회수). 경제적으로 항상 이긴다.
★ 5 종 체크리스트 — 즉시 적용 가능
이 책의 *가장 실용적인 한 표 * 다. 5 줄로 기록된다.
✅ 1. Goal Spec
이번 턴에서 *무엇을 끝내야 하는가?*
(모호한 "만들어줘" 가 아닌 *명확한 목표*)
✅ 2. Non-goals / Constraints
*무엇은 절대 하지 말아야 하는가?*
(금지 목록 = CLAUDE.md 의 핵심)
✅ 3. Acceptance Criteria
*어떤 상태가 되면 완료인가?*
(완료 조건이 없으면 AI 가 임의 결정)
✅ 4. Verification
*어떤 테스트·체크로 확인할 것인가?*
(검증 루프 = Boris 의 가장 중요한 팁)
✅ 5. Memory / Rules
*이 프로젝트에서 반복적으로 지켜야 할 관례는?*
(CLAUDE.md = 영구 기억)
이 5 줄이 모든 빈칸을 메운다. 각 줄이 하나의 빈칸 종류 에 대응.
| 줄 | 메우는 빈칸 |
|---|---|
| 1 | 목표 모호 — AI 가 목표 임의 해석 차단 |
| 2 | 금지 사항 부재 — AI 가 위험 행동 시도 차단 |
| 3 | 완료 조건 모호 — AI 가 너무 빨리 끝내거나 너무 늦게 끝냄 차단 |
| 4 | 검증 부재 — AI 가 작동 안 하는 코드를 작동한다고 보고함 차단 |
| 5 | 프로젝트 컨벤션 없음 — AI 가 매번 다른 패턴으로 짜는 것 차단 |
5 종이 *완벽히 분리된 서로 다른 종류의 빈칸 * 을 메운다. *어느 한 줄도 빠지면 그 종류의 사고가 일어난다.
여러분이 학기 프로젝트에서 3 주째에 막힌 경험 이 있다면 — 5 종 중 어떤 줄이 빠졌는지 를 지금 회고해 보라. 거의 항상 — 5 종 중 최소 2 줄 이 빠져 있었다. 그 빠진 줄이 프로젝트가 무너진 자리*.
설계의 재정의 — 워터폴 오해 차단
"설계 우선" 이라고 하면 옛날 워터폴 두꺼운 명세서 가 떠오를 수 있다. 그게 아니다. 이 책에서 말하는 설계 의 정확한 정의를 기록한다.
이 책에서 말하는 설계는 두꺼운 워터폴 문서가 아닙니다.
대신 설계 = 실행 가능한 설계 팩 *. 다음 6 항목의 묶음.
설계 팩 (Design Pack):
- 목표 + 비목표
- 아키텍처 제약
- 완료 조건
- 검증 방법
- 권한 경계
- 저장소 규칙 파일 (CLAUDE.md)
이게 *5 종 체크리스트의 확장 버전 * 이다. 5 종 + 권한 경계 + CLAUDE.md = 6 종 설계 팩. 모두 마크다운 한 페이지 안에 들어간다. 워터폴 200 페이지가 아니다.
핵심 정의 한 줄.
설계 = AI 에게 의사결정을 맡기는 영역 과 내가 통제하는 영역 을 나누는 것.
이 정의가 *11 장의 경험 외재화 * 와 *13 장의 Class Diagram * 과 *14 장의 CLAUDE.md * 를 한 줄로 묶는다.
오늘 저녁부터 — 3 줄 적기 행동 트리거
5 종 체크리스트 전부를 적는 게 처음에는 부담 이다. 그래서 3 줄 압축본 을 기록한다.
"완성됐을 때 *어떤 상태* 여야 하는가?" (= Goal + AC)
"*절대 하면 안 되는 것* 이 있는가?" (= Non-goals)
"*어떻게 확인* 할 것인가?" (= Verification)
이 세 줄이 설계다.
이 세 줄이 있으면 결과가 달라진다.
5 종 중 3 종 (Goal + Non-goals + Verification) 이 최소 골격. 이 3 줄이 빠진 작업은 시작하지 않는다*. 이게 행동 단계의 첫 규율 이다.
이 3 줄을 어디에 적는가?
| 단계 | 어디에 |
|---|---|
| DAY 1 (오늘 저녁) | 진행 중인 과제의 README.md 또는 노트 한 줄 |
| DAY 2 ~ 7 | 5 줄 (5 종 체크리스트 전체) 로 확장 |
| WEEK 2 ~ 4 | CLAUDE.md 로 정착 (50 줄 이내) |
| 이번 학기 끝 | 모든 과제 에 3 줄 적기 습관 정착 |
이 4 주 경로가 *14 장의 3 단계 진입 가이드 * 와 정확히 일치. 짧게 시작 → 자연스럽게 확장 → 습관화. 절대 처음부터 100 줄 쓰지 마라 (14 장 분석 마비 경고).
알렉스 양이 질을 만든다 회수
3 장 끝에서 만났던 알렉스의 한 줄.
"지식의 양보다 실행의 횟수 가 실력을 결정한다 — 양이 질을 만든다."
이 한 줄이 16 장에서 행동의 형태 로 다시 기록된다. 3 줄을 한 번 적는 것이 아니다. 매 과제마다 반복 * 한다. 한 학기에 과제 10 개 면 3 줄 적기 10 회. 한 학기 후에 — 3 줄 적기가 손에 익는다.
손에 익는 순간 — *그 다음부터 5 줄, 10 줄, CLAUDE.md 로 자연스럽게 확장 * 된다. *11 장의 경험 외재화 * 가 시작되는 자리.
이 책이 권하는 유일한 행동 은 — 3 줄 적기 100 회 반복. 그게 끝. 100 회면 손 이 외운다. 그 외운 손 이 입사 후 첫 6 개월 의 베테랑 5 년 차 격차를 압축 한다.
그러면 무엇을 하지 마라 인가
5 종의 2 번 항목 (Non-goals) 가 Boris Cherny 가 가장 강조한 자리 다 (10 장 회수). Don't 75% / Do 25% 의 황금 비율.
학생들이 자주 묻는 — "무엇을 하지 말라고 적어야 하나요?" 답을 5 가지 카테고리 로 기록한다.
| 카테고리 | 예시 |
|---|---|
| 데이터 위험 | "프로덕션 DB 자동 실행 금지" / "마이그레이션 파일 승인 없이 수정 금지" |
| 개인정보 | "전화번호 / 주민번호 출력 금지" / "사용자 입력 그대로 SQL 금지" |
| 불변 영역 | "auth/ 폴더 건드리지 않음 " / "기존 API 계약 변경 금지 " |
| 실패 패턴 | *"임의 추측 금지 — 모르면 정직하게 답변 " / "테스트 없이 프로덕션 코드 금지" |
| 컨벤션 위반 | "console.log 디버깅 코드 남기지 않음 " / "매직 넘버 사용 금지" |
이 5 카테고리에서 각 1 ~ 2 줄씩 골라 적으면 — Don't 한 영역만 5 ~ 10 줄. 그게 CLAUDE.md 의 황금 비율의 75% 자리 다.
여러분이 *"우리 팀은 이렇게 하면 안 되는데" 하는 경험 * 을 지금부터 메모 하라. 그 메모가 5 년 후 CLAUDE.md 의 본체 가 된다 (11 장 경험 외재화).
16 장 정리 — 행동의 입구
이 장의 결론. 행동 단계의 입구 를 기록한다.
5 종 체크리스트 → 3 줄 적기 → 오늘 저녁 → 100 회 반복.
이 4 단계가 *책 전체에서 유일한 행동 권고 *.
학생을 위한 마지막 메시지 한 줄.
책을 닫고 메모장을 펴라. 진행 중인 과제 하나 에 3 줄 부터 적어 봐라. 그 3 줄이 — AI-Native 시대의 첫 걸음.
표어로 닫는다 (16 장의 표어 회귀 멘트).
AI-Native Vibe Coding: No Design, No Code. *— No Design 의 함정에서 벗어나는 3 줄. 그 3 줄이 Design 의 시작. 시작은 오늘 저녁.
다음 17 장에서는 — *이 3 줄 적기 습관이 5 년 후 어디로 데려가는가 * 를 본다. 자율 소프트웨어 팩토리 — 졸업 후 마주칠 미래.
"3 줄에서 시작한 사람이 5 년 후 어디에 서 있는가? 다음 페이지에서."