파트 1 · Ch05 · AI-Ready Codebase
Step 2 — Cartography (지도 제작)
"README와 뭐가 다른가?" — 대상도, 톤도, 갱신 빈도도 다르다
| README | Cartography |
|---|
| 대상 | 사람 (신규·외부) | Agent (부차적으로 사람) |
| 톤 | 설명 / 마케팅 | 지시 / 좌표 |
| 포함 | 소개·설치법·기여 가이드 | 진입점·의존 그래프·용어집·Gotchas |
| 길이 | 짧고 매력적으로 | 빽빽하고 정확하게 |
| 갱신 | 가끔 | 코드 변경마다 ← 핵심 차이 |
진입점
"결제는 src/billing/router.ts에서 시작" 좌표
도메인 용어집
내부 용어, 외부엔 헷갈리는 명칭
Gotchas ⚠
"여긴 deprecated, 진짜는 v2" — 한 줄이 30분을 살린다
