11 장. 경험 = 하네스의 검증자 — CLAUDE.md 의 정체
"시니어 전문가는 숙련된 경험 을 바탕으로 AI 결과물을 검증하는 하네스를 직접 설계 한다." — 하재상 (알렉스), Meta 시니어 개발자 (30 년 경력)
도입 — 책에서 가장 깊은 한 줄
이 책의 모든 장을 한 줄로 요약하라면 — 11 장의 한 줄이다.
하네스 = 시니어 경험의 외재화 (externalization).
10 장에서 하네스 = AI 가 자기를 검증하게 만드는 시스템 이라고 정의했다. 11 장은 그 위에 한 층 더 깊은 질문을 던진다.
*"그러면 그 검증 기준은 어디서 오는가?"
답은 단 한 곳이다 — 시니어의 경험. *오랜 기간 비슷한 사고를 *몸으로 경험한 사람의 직관. *그 직관이 문서로 기록된 것 이 — CLAUDE.md.
이 한 줄이 의미하는 바를 풀어 본다. 왜 3·4 학년인 여러분이 지금 CLAUDE.md 작성 훈련을 시작해야 하는가 — 이 질문의 답이 11 장의 진짜 무게다.
핵심 명제 — 하재상의 진단
먼저 하재상 (알렉스) 의 발언 전문을 옮긴다.
"시니어 전문가는 자신의 숙련된 경험 을 바탕으로 AI 가 생성한 결과물을 검증하는 하네스를 직접 설계 한다. 이는 AI 오류 (Hallucination) 를 시니어의 직관과 논리 로 제어하는 고도의 기술적 협업 모델 이다."
이 두 문장에 세 가지 핵심 단어 가 기록되어 있다.
- 숙련된 경험 — 시간이 아니라 반복된 의사결정 의 누적.
- 하네스를 직접 설계 — 외부 도구가 아니라 자기 손으로 만든다.
- 직관과 논리로 제어 — *AI 의 출력을 맹신하지 않는다.
이 셋이 합쳐진 자리가 시니어 = AI 시대의 새 역할 이다.
경험 자본 ↔ 하네스 강도
이 경험과 하네스의 관계 를 경력 단계 로 본다.
| 경력 수준 | 하네스 설계 능력 | AI 통제력 |
|---|---|---|
| 신입 (0 ~ 3 년) | 기준 불명확 | 낮음 — AI 출력 맹신 위험 |
| 중급 (5 ~ 10 년) | 부분 보유 | 중간 — 특정 영역만 검증 |
| 시니어 (10 년 +) | 비즈니스 + 예외 패턴 축적 | 높음 — 즉각 감지 |
이 표를 부정적으로 읽으면 — "신입은 약하다" 다. 그러나 정확한 메시지는 다른 것이다.
신입의 약점은 영구 가 아니다. 하네스 설계 훈련 으로 경력 5 ~ 10 년의 결과물 을 지금 낼 수 있다.
이게 Crossbeam 해커톤 우승 사례 (2 부 5·6 장) 가 의미하는 바다. 2 일 만에 우승한 팀 이 경력 10 년 짜리 시니어 가 아니었다. 그러나 4 시간을 설계에 투입 했다 — *그 4 시간이 경험 누적분의 압축본 * 이었다.
여러분에게 이 책이 권하는 것 — *4 시간 설계의 습관 * 을 지금 학생일 때부터 기록하는 것. 그 습관이 입사 후 5 년의 격차 를 6 개월로 압축 한다.
CLAUDE.md = 경험의 외재화 — WHAT / WHY / HOW 3 레이어
CLAUDE.md 가 경험을 어떻게 외재화 하는지의 구조. 3 레이어 프레임워크 다.
| 레이어 | 역할 | 예시 |
|---|---|---|
| WHAT (컨텍스트) | 프로젝트 목적·정확한 기술 스택 버전·저장소 맵 | "React 18.3 + TS 5.4, auth/ 폴더 건드리지 말 것" |
| WHY (원칙) | 아키텍처 결정 이유·코딩 스타일·안티패턴 | "SSR 사용 이유: SEO 요구사항 때문" |
| HOW (워크플로우) | 빌드·테스트·린트 명령어·실행 규율 | "코드 수정 후 반드시 npm test 통과 확인" |
이 3 레이어가 강력한 이유 — 각 레이어가 서로 다른 종류의 경험 을 기록한다.
WHAT 레이어 는 기술적 사실. 신입도 읽고 적을 수 있다. 프로젝트의 stack 을 정리하는 것 은 경험 보다 문서 작업. 그러나 "auth/ 폴더 건드리지 말 것" 은 — 과거에 누군가 그 폴더를 건드려서 사고가 났음 의 흔적. 경험이 한 줄로 기록되어 있다.
WHY 레이어 는 결정의 이유. 이게 진짜 경험의 자리 다. "왜 SSR 인가? — 왜 이 라이브러리를 쓰는가? — 왜 이 패턴을 쓰는가?" 의 질문에 한 줄로 답하는 것. 신입은 이 한 줄을 적기 어렵다. 시니어는 별 생각 없이도 적는다. 그래서 WHY 레이어 = 시니어의 자리.
HOW 레이어 는 실행 규율. npm test / npm run lint / 빌드 명령어 같은 기계적 단계. 그러나 "반드시 통과 확인" 같은 단어가 들어가면 — 과거에 통과 확인 없이 커밋해서 사고가 났음 의 흔적. 다시 경험이 한 줄로 기록되어 있다.
이 3 레이어를 함께 적은 CLAUDE.md 가 — *시니어가 자기가 몸으로 알고 있던 것 을 글로 박은 것 *. AI 가 그 글을 매 세션 처음에 자동 로드 한다. 그래서 시니어가 그 자리에 없어도 AI 가 시니어의 판단 을 흉내 낸다. 이게 외재화 의 정확한 의미.
학생용 처방 — 3 가지 데일리 훈련
경험은 시간만으로 쌓이지 않는다. 반복적 의사결정과 그 결과의 관찰 이 진짜 경험이다. 그래서 지금 학생일 때부터 시작 가능한 3 가지 훈련을 기록한다.
| # | 훈련 | 무엇을 하는가 |
|---|---|---|
| 1 | 지식 구조화 | 매 과제마다 CLAUDE.md 에 자신의 판단 기준 한 줄씩 문장화 |
| 2 | 검증 체계 설계 | AI 결과물을 자신의 기준으로 수동 검증 (자동화는 그 다음) |
| 3 | 문제 정의 고도화 | 복잡한 문제를 AI 가 실행 가능한 단위 로 분해 · 위임 |
이 3 가지가 4 년 동안 누적 되면 — *입사 시점에 이미 시니어급 하네스 설계 능력. 이 책이 반복적으로 권하는 것이다 — 지금부터 시작.
특히 1 번 훈련. "내 판단 기준 한 줄씩 문장화" 가 경험 외재화의 기초 훈련. 학기 프로젝트 끝날 때마다 이번에 어떤 결정을 했고, 왜 했고, 다음에 어떻게 할지 를 한 페이지짜리 회고 로 적어 둬라. 그 회고가 누적된 1 년이 — 1 년의 진짜 경험.
이게 알렉스의 3 장 4 단계 모델 의 4 단계 (행동) 와 정확히 같은 자리다. 행동이 누적되어야 목격 이 활용 으로 옮겨가고 — 그 순환의 마지막 결과가 외재화된 경험 = CLAUDE.md.
알텐바흐 사례 — 비개발자 1 명 = 시니어 7 명
경험 + 하네스 의 극단적 사례 한 건. 부록 A 에서 더 자세히 다룬다.
Altenbach 의 그로스 리드 (비개발자) 가 AI 코딩 에이전트 7 개 를 구축했다. 업무 자동화의 형태였다 — Meta 광고 분석 / 재고 예측 / 이메일 분류 / 보고서 자동 생성 등.
이 7 개 에이전트가 시니어급 인력 7 명분 의 결과물을 냈다. 회사가 7 명을 추가 채용 하지 않고 그로스 리드 1 명이 7 명 분량을 처리했다.
비결은 무엇인가?
비개발자가 AI 를 잘 다뤘다 가 답이 아니다. *그 비개발자에게 현장 경험이 있었다. * *Meta 광고 운영을 몇 년 동안 직접 한 사람이었다. *광고 분석에서 어떤 데이터를 어떻게 처리해야 하는지 의 몸으로 알고 있는 지식이 있었다.
그 지식을 *AI 에게 업무 로직으로 * 정의해 줬을 때 — AI 가 코드를 잘 만들었다. *코드 능력이 부족해도 — 업무 정의 능력 이 코드 능력의 부족을 메웠다.
이 사례의 일반화 한 줄.
코드 실력이 아니라 업무 로직을 정의하는 경험 이 AI 시대의 자본.
이게 *6 장 코더 → 아키텍트 * 의 완성된 구체 다. 알텐바흐 사례는 비개발자가 도달한 자리 다. *컴공 졸업 후 그 자리에 도달하는 것은 훨씬 가깝다.
강의의 핵심 메시지 — 세 사람의 비교
같은 메시지를 세 단계의 사람 으로 그린다.
초보 개발자:
AI가 뭐라 하든 *그냥 쓴다*
→ 오류 나야 알아챔
→ "어? 안 되네?" 하고 다시 짠다
경험 있는 개발자:
AI 출력 보며 *"이건 아닌데?"* 즉각 감지
→ 경험 = *실시간 검증기*
→ 머릿속에서 자동으로 검증
시니어 전문가:
검증 기준을 *CLAUDE.md 에 문서화*
→ 경험을 *시스템* 으로 외재화
→ AI 가 *시니어 부재 중에도 시니어의 판단 흉내*
이 세 단계의 목적지 가 시니어 전문가 다. 그러나 3 단계로 한 번에 도착하지 않는다. 2 단계 (실시간 검증기) 를 거쳐야 3 단계 (외재화) 가 가능.
여러분이 지금 1 단계 라면 — 이 책의 가르침은 — *2 단계로 가는 길은 AI 의 모든 출력에 한 번씩 "이게 맞나?" 를 묻는 습관 * 이다. 매번 맞다 / 아니다 를 판단 하면서 — 그 판단이 누적되어 직관 이 된다.
한 줄로 기록한다 — 경험은 자본이다
11 장의 결론.
하네스를 설계하는 능력은 경험 에서 온다. 경험 없는 하네스는 빈 껍데기 다.
이 한 줄이 *왜 8·9·10 장이 충분하지 않은가 * 의 답이다. 4 계층 아키텍처도, Superpowers 도, 검증 루프도 — 모두 재료 다. *그 재료를 어떻게 조립할지 는 경험에서 온다.
그래서 이 책이 권하는 것은 도구를 익히기 전에 경험을 쌓는 습관 부터. 16 장의 5 종 체크리스트 + 3 가지 데일리 훈련 이 그 습관의 출발점이다.
11 장 정리 — 학생 메시지
이 장의 마지막 한 줄은 학생을 위한 직접 메시지 다.
지금 여러분이 쌓는 도메인 이해 와 설계 능력 이 — 미래 하네스의 원천.
여러분이 알고리즘 시험을 보면서 왜 이 알고리즘이 이 문제에 적합한지 를 말로 설명할 수 있게 되는 것 — 그게 경험 외재화의 첫 훈련 이다. 시험에서 답만 맞추는 것 이 아니라 왜 그 답인지 를 문서로 기록하는 습관. 그 습관이 5 년 후 CLAUDE.md 한 줄을 적는 능력 이 된다.
표어로 닫는다.
AI-Native Vibe Coding: No Design, No Code. — No Design 의 Design 은 경험의 외재화. 경험이 없으면 외재화도 없다. 그래서 경험 자체 가 Design 의 본체.
다음 12 장에서 — *이 모든 것이 수치로 증명된 사례 * 들을 본다. SDD 도입 시 프로그래밍 시간 -56% / PR 리뷰 -31.8% 같은 측정값. 경험 외재화 + 검증 루프 의 정량적 위력.
"수치로 보지 않으면 — 왜 그렇게 해야 하는지 가 기술적으로 와닿지 않는다."