점검과 정리

위키도 청소가 필요해요

페이지가 쌓이면 이런 일이 생겨요.

• 링크를 걸었는데 가리키는 페이지가 이름이 바뀌어서 사라졌다 (깨진 링크)
• 만들어 놓고 어디서도 링크하지 않은 페이지 (고아 페이지)
• 페이지는 있는데 index.md에 안 올라간 것
• 반년 전 내용 그대로인 페이지

눈으로 찾기엔 많아지면 힘들어요. 그래서 점검 도구를 만들어요.

용어: lint(린트) 는 규칙 위반을 자동으로 찾아 주는 점검 프로그램을 가리켜요. 고치는 건 사람(또는 클로드)이 하고, lint는 "여기 이상해요" 목록만 줘요.

점검 항목 정하기

처음에는 이 정도면 충분해요.

클로드에게 만들게 하기

스크립트를 직접 짤 필요 없어요. 무엇을 점검할지만 말하면 돼요.

기본 방법: 클로드 데스크탑 앱의 Code 탭. 위키 폴더(my-wiki)를 프로젝트 폴더로 열고, 아래 프롬프트를 붙여 넣어 클로드에게 시킵니다. 클로드가 파일을 만들거나 바꾸려고 권한을 물으면, 무엇을 하려는지 읽고 허용합니다. 터미널로 하는 방법은 맨 아래 '터미널로도 할 수 있어요'에 있어요.

권한 요청이 나오면 "무슨 명령을 실행하려는지" 읽고 허용하세요. 스크립트는 읽기만 하니 위키가 망가질 일은 없어요.

결과를 보고 고치기

결과가 이렇게 나올 수 있어요.

깨진 링크 2건
  wiki/lecture-03-notes.md -> [[prompt-rules]]
index 빠짐 1건
  wiki/concepts-core-3.md

각 문제를 어떻게 풀지는 사람이 판단해요. 이름이 바뀐 거면 링크를 고치고, 안 만든 페이지면 만들거나 링크를 지워요.

정기 점검 습관

• 큰 작업(페이지 여러 개 추가) 뒤에 한 번
• 매달 증류할 때 한 번

점검이 쌓여 규칙이 새로 필요하면 CLAUDE.md에 한 줄을 더해요. "큰 작업 후 python3 scripts/lint_wiki.py를 돌린다"를 넣어 두면 클로드가 알아서 챙겨요.

터미널로도 할 수 있어요

python3 scripts/lint_wiki.py