1. 린트 체크리스트 만들기

앞 절에서 쓴 프롬프트는 일반적인 것이었습니다. 위키마다 잘 망가지는 곳이 다르니, 우리 위키에 맞는 목록을 만들어 둡니다.

1.1 기본 여섯 항목

어떤 위키든 이 여섯은 봅니다.

'근거 없음'을 상으로 둔 이유가 있습니다. 이건 위키의 신뢰를 직접 무너뜨립니다. 출처 없는 문장이 하나라도 있으면 다른 문장도 못 믿게 됩니다.

1.2 우리 위키에만 있는 항목 찾기

기본 여섯 외에 우리 위키에서 반복되는 문제가 있습니다. 그것을 찾습니다.

지금까지 log.md에 남은 인제스트 기록과 린트 기록을 훑어줘.
그리고 wiki/ 문서들을 살펴봐서,
이 위키에서 반복해서 생기는 문제 유형이 있는지 알려줘.

앞으로 정기 점검할 때 봐야 할 항목을 제안해줘.

예시 상황이라면 이런 항목들이 나옵니다.

결정 문서에 뒤집는 조건이 없는 것. 6장에서 결정 문서에 뒤집는 조건을 적기로 했는데, 조건 없이 결론만 적힌 문서가 생깁니다.

뒤집는 조건이 이미 충족된 결정. 이게 더 중요합니다. "9월 전환율이 8월 대비 떨어지면 재검토"라고 적어 뒀는데, 그 데이터가 위키에 들어왔는데도 아무도 안 봤을 수 있습니다.

종합 문서와 재료 문서의 시차. depends_on에 적힌 문서가 종합 문서보다 나중에 갱신됐다면, 종합 문서가 낡았을 가능성이 높습니다.

한쪽 출처만 있는 종합 문서. 비교 문서인데 근거가 한 회사 자료뿐이라면 균형이 안 맞습니다.

1.3 체크리스트 문서 만들기

찾은 항목을 문서로 만들어 둡니다. 매번 프롬프트를 다시 쓰지 않기 위해서입니다.

wiki/lint-checklist.md 를 만들어줘.
아래 항목들을 점검 프롬프트 형태로 정리해줘.
각 항목마다 무엇을 찾는지, 어떻게 판단하는지 적어줘.

(앞에서 정한 항목들)

만들어진 문서는 이런 모양입니다.

# 린트 체크리스트

## 1. 모순 (상)

wiki/ 전체에서 같은 대상에 대해 다른 값을 적은 문서 쌍을 찾습니다.
숫자, 날짜, 기간이 특히 자주 어긋납니다.
발견하면 각 문서의 출처 자료 발행일을 함께 표시합니다.

## 2. 낡음 (상)

프론트매터 updated 이후에 그 문서와 관련된 자료가 raw/에 들어왔는데
문서가 갱신되지 않은 경우를 찾습니다.
log.md의 인제스트 기록과 대조하면 알 수 있습니다.

## 3. 근거 없음 (상)

출처 표기도 [추론] 표시도 없는 사실 문장을 찾습니다.
문서 이름과 해당 문장을 그대로 보여줍니다.

## 4. 결정 조건 충족 (상)

decisions/ 문서의 '뒤집는 조건' 항목을 읽고,
그 조건에 해당하는 데이터가 위키에 들어왔는지 확인합니다.
들어왔으면 재검토 대상으로 표시합니다.

## 5. 종합 문서 시차 (중)

topics/ 문서의 depends_on 목록을 보고,
재료 문서 중 종합 문서보다 나중에 갱신된 것이 있는지 확인합니다.

## 6. 고아 (중)

index.md를 제외하고 아무 데서도 링크되지 않은 문서를 찾습니다.

## 7. 빠짐 (중)

세 개 이상 문서에서 언급되는데 자기 문서가 없는 개념을 찾습니다.

## 8. 색인 어긋남 (하)

index.md와 wiki/ 실제 파일 목록을 대조합니다.

1.4 체크리스트로 린트 돌리기

이제 린트가 한 줄이 됩니다.

wiki/lint-checklist.md 를 읽고 그대로 점검해줘.
결과는 wiki/lint-2026-08-29.md 로 저장하고,
항목마다 체크박스와 심각도를 붙여줘.
아무것도 고치지는 마.

체크리스트를 문서로 두는 것에는 다른 이점도 있습니다. 린트 항목이 위키 안에 있으니, 새 항목이 필요할 때 그 문서를 고치면 됩니다. 프롬프트를 어딘가에 메모해 두는 것보다 관리가 쉽습니다.

1.5 얼마나 자주 돌리나

위키의 크기에 따라 다릅니다.

세 번째가 중요합니다. 문서가 백 장을 넘으면 전체 린트가 한 번에 안 끝납니다. 항목을 나눠 돌립니다.

lint-checklist.md의 1번과 3번 항목만 점검해줘.
(모순, 근거 없음)

심각도 상인 항목을 자주 돌리고, 중과 하는 한 달에 한 번 정도면 충분합니다.

1.6 린트를 시작하는 신호

주기와 별개로, 이런 일이 있으면 린트를 돌립니다.

묶음 인제스트 직후. 한 번에 여러 건을 넣으면 충돌 표시가 쌓입니다.

한동안 방치했다가 돌아왔을 때. 무엇이 어디까지 돼 있는지 파악하는 데 린트만 한 것이 없습니다.

질문했는데 이상한 답이 나왔을 때. 답이 이상하면 위키가 이상한 것입니다. 그 답에 쓰인 문서들부터 점검합니다.

방금 답변에 쓰인 문서들만 집중해서 점검해줘.
lint-checklist.md의 항목 중 1, 2, 3번을 그 문서들에만 적용해줘.

중요한 결정을 앞두고. 위키를 근거로 판단을 내리기 전에 그 근거가 성한지 확인합니다. 이때는 관련 문서만 좁혀서 돌립니다.

다음 절에서 린트가 찾아낸 모순과 낡은 주장을 실제로 처리합니다.