파트 1 · Ch05 · AI-Ready Codebase

측정 가능하게 — AI-Readiness Score

ai-readiness-cartography skill이 repo를 7개 카테고리·100점 만점으로 채점
1
Navigation
진입점 명시 여부, 디렉토리 구조의 명확성
15
2
Context Quality
CLAUDE.md·가이드 문서의 정보 밀도·정확도
20
3
Tribal Knowledge
머릿속 지식이 문서로 외화됐는가
20
4
Dependency Mapping
모듈 의존, 순환 의존, god file 존재
15
5
Verification Gates
테스트·린터·CI 게이트의 신뢰도
15
6
Freshness
문서·코드의 drift, 마지막 갱신 시점
10
7
Agent Outcomes
실제 세션이 첫 시도에 성공하는 비율 — 결과 측 점검
5
앞 6개가 입력 측 점검, 7번이 결과 측 점검 → HTML 대시보드로 "어디서 길을 잃는가"를 시각화