# .claude/wiki — 세션을 넘어 살아남는 지식

개인 메모리에만 적은 재발 방지 규칙은 **다른 세션·다른 사람에게 닿지 않는다.** 레포 하네스에 적어야 닿는다. 이 폴더가 그 그릇이다.

## 파일 구성

| 파일            | 역할                                                 | 쓰는 주체           |
| --------------- | ---------------------------------------------------- | ------------------- |
| `index.md`      | 세션 시작에 자동 주입되는 색인 (한 줄 = 검색 트리거) | 큐레이션된 것만     |
| `incidents.md`  | "이렇게 하면 안 돼" 술어 로그 — 승격 루프의 원료     | 세션 종료 시 append |
| `candidates.md` | 아직 분류 안 된 발견 crumb 큐                        | 세션 종료 시 append |

## 규약

- **index.md는 50줄·줄당 200자 하드캡.** 80%부터 통합을 검토하고, 꽉 차면 새 줄 금지 — 통합·도태로 줄인 뒤 추가한다. 큐레이션은 의지가 아니라 용량이 강제한다.
- **저장 대상**: 버그의 근본 원인, 설계 결정과 기각된 대안, 에러 없이 조용히 실패하는 함정, 실측으로 뒤집힌 가정. **저장 금지**: 코드/git에서 도출 가능한 것, 일회성 작업 디테일, docs/README에 갈 내용.
- **incidents 형식**: `- [날짜] <하면 안 되는 것·술어형> — 근거(파일:라인/재현) — 처방`. 실측 안 한 추측은 끝에 `(탐구 중)`.
- **제목·줄은 결론이 드러나게**: "X 조사" ❌ → "X는 Y라서 Z" ✅.
- **승격**: 같은 술어가 2회+ 재발하면 housekeeping이 `.claude/rules/gate-promotion.md`의 3판정으로 게이트/rule 승격을 검토한다.