단원 16 — 설계 먼저 선언 + 5종 체크리스트
Lesson (강의 단원)lectureverifiedFri May 01

단원 16 — 설계 먼저 선언 + 5종 체크리스트

별칭: 설계 먼저 선언 단원 · 5종 체크리스트 단원

#cln#design-first#5-checklist#manifesto#action-trigger

요약

본 강의의 압축 결론. 핵심 명제 — "바이브 코딩이 실패하는 이유는 AI 가 코드를 못 써서가 아니라, 설계되지 않은 빈칸 을 AI 가 대신 결정하게 만들기 때문입니다." + 5종 체크리스트 (Goal/Non-goals/Acceptance/Verification/Memory Rules). 학생이 현장에서 3 줄 적기 의 행동 트리거.

상세

핵심 명제 두 줄

"바이브 코딩이 실패하는 이유는 AI 가 코드를 못 써서가 아니라, 설계되지 않은 빈칸 을 AI 가 대신 결정하게 만들기 때문입니다."

"좋은 팀은 코드를 먼저 쓰지 않고, 성공 조건을 먼저 쓴 뒤 AI 에게 구현을 맡깁니다."

AI 역할 재정의

일반적 오해정확한 이해
AI = 설계자 + 구현자AI = 설계를 실행하는 가속기

실패 / 성공 공식

빈칸 + AI = AI 가 빈칸을 임의 채움 = 의도와 다른 결과
설계 팩 + AI = AI 가 설계대로 실행 = 예측 가능한 결과

concept/five-checklist — 즉시 적용 가능 5종

✅ 1. Goal Spec
   이번 턴에서 *무엇을 끝내야 하는가?*
   (모호한 "만들어줘" 가 아닌 명확한 목표)

✅ 2. Non-goals / Constraints
   *무엇은 절대 하지 말아야 하는가?*
   (금지 목록 = CLAUDE.md 의 핵심)

✅ 3. Acceptance Criteria
   *어떤 상태가 되면 완료인가?*
   (완료 조건이 없으면 AI 가 임의 결정)

✅ 4. Verification
   *어떤 테스트·체크로 확인할 것인가?*
   (검증 루프 = Boris 의 가장 중요한 팁)

✅ 5. Memory / Rules
   *이 프로젝트에서 반복적으로 지켜야 할 관례?*
   (CLAUDE.md = 영구 기억)

설계의 재정의 (워터폴 오해 방지)

"이 강의에서 말하는 설계는 두꺼운 워터폴 문서가 아닙니다."

설계 = 실행 가능한 설계 팩:

  • 목표 + 비목표
  • 아키텍처 제약
  • 완료 조건
  • 검증 방법
  • 권한 경계
  • 저장소 규칙 파일

"설계 = AI 에게 의사결정을 맡기는 영역과 내가 통제하는 영역 을 나누는 것."

오늘 저녁부터 — 3 줄 적기 (행동 트리거)

"완성됐을 때 *어떤 상태* 여야 하는가?"
"*절대 하면 안 되는 것* 이 있는가?"
"*어떻게 확인* 할 것인가?"

이 세 줄이 설계다.
이 세 줄이 있으면 결과가 달라진다.

★ 마지막 1 분 통합 멘트 — Thesis + Corollary 한 문장

"우리는 90 분을 함께했습니다. 정리는 한 문장입니다."

설계 없이는 코딩이 안 됩니다.

그 설계가 곧 AI 에게 어떻게 일을 시키는가 입니다.

CLAUDE.md 를 쓰는 순간, 여러분은 설계자입니다.

— 두 명제는 한 메시지. 첫 줄이 왜 (Thesis), 둘째 줄이 무엇 (Corollary), 셋째 줄이 어떻게 (Action). 이 세 줄을 한 호흡으로 기록한다.

연출 가이드 (강사용):

  • 슬라이드: 검정 배경 + 큰 흰 글씨 3 줄. 다른 텍스트 ❌.
  • 멘트는 천천히, 줄 사이 1 초 호흡. 마지막 셋째 줄에서 청중 응시.
  • 이전 단원 (단원 14 CLAUDE.md = Class Diagram) 이 어떻게 의 형태 를 박았다면, 이 줄은 그 형태가 곧 설계자가 되는 행위 임을 닫는다.

→ 학생이 강의장을 나가며 가져갈 단 한 문장 — 이 세 줄.

방법론

강의 진행 시퀀스 (7분):

  1. ★ 표어 회귀 멘트 (15초): "여기까지가 왜 와 무엇으로 였습니다. 이 단원은 결단 입니다."
  2. 충격 명제 (1분): 두 줄 인용 큰 폰트.
  3. AI 역할 재정의 (1분): 빈칸 + AI = 임의 채움.
  4. 5종 체크리스트 (2분): 한 슬라이드 + 학생들 지금 적기.
  5. 3 줄 적기 트리거 (45초): 오늘 저녁 약속.
  6. 알렉스 case/alex-quantity-quality 회수 (45초): 행동 단계 = 4단계 모델 닫기.
  7. ★ 마지막 1 분 — Thesis + Corollary 한 문장 (1분): 검정 배경 흰 글씨 3 줄. 청중 응시. 강의 끝.

주의사항

  • 워터폴 오해 차단: 두꺼운 문서가 설계가 아님 을 매번 강조.
  • 5 → 3 압축: 청중 부담 시 3 줄 (Goal/Non-goals/Verification) 로 즉시 압축 가능.
  • 오늘 저녁 약속: 학생들이 나중에 가 아닌 오늘 행동하게 — 시간 한정 트리거.
  • AI 책임 재분배: 마무리 단원이지만 AI = 가속기 메시지가 AI 무용론 으로 흐르지 않게 균형 유지.