Lint 체크리스트¶
위키가 커질수록 주기적으로 구조와 내용의 건강 상태를 점검해야 합니다. 이 체크리스트는 LLM 에이전트나 사람이 위키를 점검할 때 사용합니다.
1. 구조 점검¶
- 새로 생긴
wiki/문서가index.md에 빠짐없이 등록되어 있는지 확인합니다. - 주요 페이지가 최소 한 곳 이상에서 링크되고 있는지 확인합니다.
raw/에만 있고 아직 ingest되지 않은 중요한 소스가 있는지 확인합니다.
2. 링크 점검¶
- 상대 경로 링크가 실제 파일을 가리키는지 확인합니다.
- 문서 제목과 링크 텍스트가 서로 어긋나지 않는지 확인합니다.
- 개념, 엔티티, 소스 페이지 사이의 교차 링크가 끊기지 않았는지 확인합니다.
3. 내용 점검¶
- 서로 충돌하는 주장이나 오래된 설명이 남아 있지 않은지 확인합니다.
- 한 문서에만 고립된 중요한 개념이 있다면 별도 페이지 승격 여부를 검토합니다.
- 서로 거의 같은 내용을 담은 중복 개념이나 엔티티가 있는지 확인합니다.
- 요약 문서가 raw 소스의 핵심 내용을 반영하는지 확인합니다.
4. 운영 기록 점검¶
- 의미 있는 ingest, 질의, 구조 변경 작업이
log.md에 기록되어 있는지 확인합니다. - 로그 항목 제목 형식이 일관적인지 확인합니다.
- 최근 작업이 있었는데 로그가 비어 있거나 누락되지 않았는지 확인합니다.
5. 우선순위 분류¶
- 즉시 수정해야 할 문제: 끊긴 링크, 잘못된 소스 참조, 중대한 사실 오류
- 다음 ingest 전에 고칠 문제: 인덱스 누락, 교차 링크 부족, orphan 페이지
- 나중에 정리해도 되는 문제: 표현 중복, 약한 제목, 분류 개선