파트 1 · Ch05 · AI-Ready Codebase

점수 해석 — ROI 높은 1~2개만

다 고치려 들면 며칠. 정석은 점수 변동폭이 큰 한두 개를 즉시 적용
가장 낮은 카테고리 (62 / 100)
Tribal Knowledge
5/20
ROI ①
Freshness
3/10
Navigation
8/15
ROI 중
발견 사항
  • CLAUDE.md가 src/billing/v1/ 참조하는데 경로 없음 (drift)
  • src/utils/index.ts가 81개 파일에서 import (god file)
  • 진입점 표 없음
Tribal Knowledge가 ROI 1순위 — 머릿속 지식을 문서로 외화하는 건 한 시간으로 점수가 크게 뛴다.
시연: CODEBASE_MAP.md 한 페이지(진입점 표 + 용어집 + Gotchas)를 추가 → 다시 채점하면 62 → 74 (+12점). 만점이 아니라 가장 비어 있는 칸을 채워 큰 점프를 만든다.