11 장 — 11 장. 경험 = 하네스의 검증자 — CLAUDE.md 의 정체
11 장

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 DesignDesign경험의 외재화. 경험이 없으면 외재화도 없다. 그래서 경험 자체Design 의 본체.

다음 12 장에서 — *이 모든 것이 수치로 증명된 사례 * 들을 본다. SDD 도입 시 프로그래밍 시간 -56% / PR 리뷰 -31.8% 같은 측정값. 경험 외재화 + 검증 루프정량적 위력.

"수치로 보지 않으면 — 왜 그렇게 해야 하는지기술적으로 와닿지 않는다."