프로젝트 위키

새 AI 세션은 왜 그렇게 했는지 기억하지 못한다. 그래서 같은 결정을 다시 설명하게 되고 예전 변경의 이유는 사라진다.

1. oah init이 index.md(분류별 목록), log.md(최신순), log_archive_NN.md, 노트와 결정 기록 템플릿이 든 docs/wiki/를 만든다.
2. oah wiki maintain --task T는 마지막 커밋과 게이트, 리뷰 전에 작업의 로그 항목과 색인 줄을 쓰고 수정 뒤에도 다시 실행한다. 두 번 실행해도 같은 내용이 두 번 들어가지 않는다.
3. oah finish는 실행했는지만 확인하고, 하지 않았으면 OAH_WIKI_MAINTENANCE_MISSING으로 거절한다.
4. 로그가 512,000바이트를 넘으면 가장 오래된 항목부터 통째로 다음 log_archive_NN.md로 옮기고, 옮길 때마다 저널에 남긴다.
5. oah wiki lint와 oah wiki hygiene이 깨진 링크, 색인에 없는 노트, 출처가 없는 노트 같은 실제 문제를 알려 준다.

`oah init`이 만드는 폴더(개념 문서).

docs/wiki/
  index.md             catalog by category
  log.md               newest first, below <!-- OAH:LOG_INSERT_BELOW -->
  log_archive_NN.md    older whole entries, moved by rollover, never edited
  templates/           note and decision templates

• oah init이 만든다. 따로 설치할 것은 없다.
• graphify는 선택이다(oah graph).

• lint와 hygiene은 후보만 보여 준다. 어떤 위키 명령도 노트를 스스로 지우거나 옮기지 않는다.
• 로그를 옮기는 도중에 파일이 바뀌면 oah wiki recover를 실행할 때까지 위키 명령이 OAH_WIKI_RECOVERY_PENDING으로 멈춘다.
• graphify 그래프를 자동으로 다시 만드는 일은 없다.
• --allow-missing-wiki-maintenance는 finish 검사를 건너뛰고 그 사실을 기록한다.

• docs/ko/troubleshooting.md ↗탐색기에서 열기
• 개념 › 프로젝트 위키 ↗탐색기에서 열기

• 영향 지도
• 게이트
• 리스