# 문서 지도 ## 1. 어디에 무엇이 있나 | 폴더 | 종류 | 고치는 법 | | --- | --- | --- | | `work/` | 작업 방법(고치기, 게이트, 릴리스) | 살아 있는 문서. 동작이 바뀌면 같은 변경에서 고친다 | | `compatibility/` | 지원 매트릭스(무엇을 인증했나) | 살아 있는 문서 | | `runbooks/` | 운영 대응 | 살아 있는 문서 | | `adr/` | 결정 기록(ADR-GRPC-*) | 기록. 본문은 고치지 않는다 | | `design/` | 설계서 | 기록. 본문은 고치지 않는다 | | `ledger/` | 예측·실측 장부 | 줄을 더하기만 한다 | | `vision.md`, `problem-statement.md` | 방향, 풀 문제 | `vision.md`는 소유자만 쓴다 | ## 2. 기록 문서의 머리 블록 `adr/`와 `design/`의 문서는 맨 위에 머리 블록을 둔다. 본문은 쓴 때의 원문이고, 지금도 맞는지는 머리 블록이 말한다. ```markdown > **결정 기록** 본문은 결정한 때의 내용이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. - 상태: 채택 | 대체됨(무엇으로) | 폐기 - 작성일: YYYY-MM-DD - 요약: 한 문장 - 현재 정본: 지금 동작을 설명하는 살아 있는 문서 경로 ``` 지난 결정이 바뀌면 본문은 두고 「상태」와 「현재 정본」만 고친다. 템플릿에서 옮겨 온 기록의 본문 경로(`src/platforms/…`, `.github/workflows/…`)는 그 결정 때의 템플릿 경로다.