16 장 — 16 장. 설계 먼저 선언 + 5 종 체크리스트 ★
16 장

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 ~ 75 줄 (5 종 체크리스트 전체) 로 확장
WEEK 2 ~ 4CLAUDE.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 년 후 어디에 서 있는가? 다음 페이지에서."