Meta에서 배운 실전 테크닉 - AI가 길 잃지 않는 코드베이스 & 토큰 비용 최적화

AI 코딩, 토큰의 80%를 '길찾기'에 버리고 있습니다 - 실리콘밸리 바이브 코딩 테크닉 Claude Code · Agentic Engineering 강의 일부를 무료로 공개하는 세 편 시리즈의 두 번째 영상입니다. 이번 편은 제가 실리콘밸리에서 Meta를 다니며 배운 실전 테크닉 두 가지 — AI-Ready 코드베이스와 Token Efficiency를 다룹니다. CLAUDE.md(헌법)를 아무리 잘 써도, Agent가 들어간 코드베이스 자체가 미로라면 길을 잃습니다. 엉뚱한 파일을 읽고, 이미 있는 Util을 못 찾아 또 만들죠. 실제로 AI-Ready가 안 된 리포에서는 한 작업에 쓰인 토큰의 80%가 코드 수정이 아니라 '탐색'에 낭비됩니다. 이 영상은 그 80%를 되찾는 법 — Codebase Sanity(건강) → Cartography(지도)의 2단계와, 내 코드베이스가 얼마나 AI 친화적인지 100점으로 채점해 주는 스킬을 직접 보여줍니다. 이어서 Token Efficiency — AI를 쓸수록 늘어나는 비용을 어떻게 측정하고 통제하는지 다룹니다. Prompt Caching(5분 TTL, cache read는 1/10 가격)의 원리부터, 캐시를 통째로 날려버리는 흔한 실수, 비용을 점수화하는 대시보드, 그리고 예산을 사전에 막는 Cost Gate까지 — 비용 관리를 개인의 절약이 아니라 팀의 공유 자산으로 만드는 법입니다. ⏱ 타임스탬프 0:00 인트로 — 무료 공개 ② 실리콘밸리(Meta)에서 배운 실전 테크닉 0:37 Part 1. AI-Ready 코드베이스 — 지침(CLAUDE.md)이 좋아도 지형이 미로면 Agent는 길을 잃는다 2:18 Agent 실패는 탐색 비용 문제 — 토큰 80%가 '길찾기'에 낭비된다 3:36 두 단계 — Codebase Sanity(건강) → Cartography(지도) + Agent 시대에 더 중요한 이유 7:21 [데모] AI Readiness 채점 스킬 — 100점·7개 카테고리 → HTML 대시보드 + ROI 액션(주기화·PR까지) 16:30 Part 2. Token Efficiency — 자산이 늘수록 토큰·비용이 폭증한다 19:24 비용을 숫자로 + Prompt Caching — 5분 TTL, cache read는 1/10 가격 24:40 캐시를 날리는 실수 + 6가지 최적화 기법 / 안티패턴 31:51 [데모] Token Efficiency 채점 스킬 + Cost Gate — 팀의 공유 자산으로 박아두기 📌 영상에서 다루는 내용 ✅ 지침 vs 지형 — CLAUDE.md가 좋아도 코드베이스가 미로면 Agent는 길을 잃는다 ✅ Agent는 매 세션 '첫 출근' — 사람과 달리 머릿속 지도가 쌓이지 않는다 ✅ Agent 실패의 본질 — 코드 품질이 아니라 탐색·이해 비용 문제 (토큰 80%가 길찾기) ✅ AI-Ready 2단계 — Codebase Sanity(테스트·dead code·convention) → Cartography(지도) ✅ Agent 시대의 테스트 — 회귀 방지가 아니라 Agent의 셀프 검증 신호 ✅ [데모] AI Readiness 채점 스킬 — 100점·7개 카테고리로 감사해 HTML 대시보드 생성 ✅ 리포트로 끝내지 마라 — 최우선 ROI 액션을 cron으로 주기화하고 PR 머지까지가 완성 ✅ 토큰의 정체 — BPE, 한국어가 영어보다 1~2배 더 먹는 이유 ✅ Prompt Caching — 같은 prefix는 cache read로 1/10 가격, 5분 TTL ✅ 캐시를 날리는 실수 — 세션 중간에 CLAUDE.md·모델을 바꾸면 캐시가 통째로 증발 ✅ 6가지 최적화 기법 & 안티패턴 — 무거운 탐색은 서브에이전트, 대용량 파일 직접 읽기 금지 ✅ Cost Gate — 사후 대시보드 vs 사전 Hook, 세션·PR 단위로 예산 경고 ✅ 비용은 절약이 아니라 자산화 — 팀 플러그인에 박아 모두의 캐시 효율을 올린다 🔗 유용한 링크 Claude Code: https://claude.com/claude-code Anthropic — Prompt Caching: https://docs.claude.com/en/docs/build... Anthropic — 토큰·가격 정책(촬영 시점 기준 확인): https://www.anthropic.com/pricing 🛠 참고 개념 & 도구 AI-Ready 코드베이스 · Codebase Sanity · Cartography(지도 제작) · 진입점 / 의존 그래프 / 용어집 / Gotchas · AI Readiness 채점 스킬(100점·7카테고리) · ROI 액션 · ADR · Token Efficiency · BPE 토크나이저 · Prompt Caching(TTL 5분) · Cache HIT Ratio · cache read / write · 서브에이전트 위임 · 6대 최적화 기법 · Cost Gate · Hook · 팀 플러그인 자산화 💬 오픈카톡 커뮤니티: https://open.kakao.com/o/g3Os2Lri 🎓 5월 신규 강의 (패스트캠퍼스) 강의 링크: https://fastcampus.info/4d7RN8I 혹시 이번 기회에 전체 강의를 들어보고 싶으신 분들을 위해 할인 쿠폰도 안내드립니다. 결제할 때 아래 코드를 넣으면 4만원 할인되고, 7/12(일) 밤 11시 59분까지 쓸 수 있습니다. 🎟️ 쿠폰 코드: 패캠1위바이브코딩 🔗 전체 강의 링크: https://fastcampus.info/42hEDQx