1. 린트 한 번 돌려 보기

위키는 가만히 두면 나빠집니다. 이 장에서 그 상태를 점검하는 동작을 익힙니다. 프로그래밍에서 코드를 검사하는 도구 이름을 빌려 린트라고 부릅니다.

1.1 위키가 나빠지는 방식

자료를 스무 건쯤 넣으면 이런 것들이 쌓입니다.

서로 어긋나는 문장. 3월 자료로 쓴 "무료 체험 14일"과 8월 자료로 쓴 "무료 체험 7일"이 다른 문서에 각각 남아 있습니다. 인제스트할 때는 관련 문서를 다 열어 보지 못했기 때문입니다.

낡은 주장. 반년 전에는 맞았지만 지금은 안 맞는 문장입니다. 그 자체로는 틀린 것이 없어서 눈에 안 띕니다.

고아 문서. 만들어졌지만 어디서도 링크되지 않아 질문할 때 안 걸립니다.

빠진 문서. 여러 문서에서 언급되는데 자기 문서가 없는 개념입니다.

색인과 실제의 어긋남. 색인에는 있는데 파일이 없거나, 파일은 있는데 색인에 없습니다.

이것들의 공통점이 있습니다. 하나하나는 사소하고, 쌓이면 위키를 못 믿게 만듭니다. 그리고 전부 기계적으로 찾아낼 수 있습니다.

1.2 첫 린트 돌려 보기

지금 위키에 대고 그냥 돌려 봅니다.

위키 전체를 점검해줘. 아직 아무것도 고치지 말고 목록만 보여줘.

1. 서로 어긋나는 내용이 있는 문서 쌍
2. 마지막 갱신이 오래된 문서 (프론트매터 updated 기준)
3. 아무 데서도 링크되지 않은 문서 (index.md 제외)
4. [[문서명]]으로 링크됐는데 실제 파일이 없는 것
5. 여러 문서에서 언급되는데 자기 문서가 없는 개념
6. index.md와 실제 파일 목록의 차이

각 항목마다 몇 건인지 세고, 심각한 것부터 보여줘.

처음 돌리면 대개 열 건에서 스무 건이 나옵니다. 놀랄 필요는 없습니다. 위키를 성실하게 만들었어도 나옵니다. 인제스트는 한 번에 한 자료만 보고, 린트는 전체를 한꺼번에 보기 때문입니다.

1.3 결과를 문서로 남기기

린트 결과는 대화창에만 두면 사라집니다. 문서로 남깁니다.

방금 점검 결과를 wiki/lint-2026-08-22.md 로 저장해줘.

- 항목마다 체크박스를 붙여줘. 처리하면서 지울 수 있게.
- 각 항목에 관련 문서 링크를 걸어줘.
- 처리 우선순위를 상중하로 표시해줘.

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

# 린트 결과 2026-08-22

## 어긋나는 내용 (상)

- [ ] [[competitor-a]] 는 팀 최소 5명, [[pricing-comparison]] 은 3명
      원본: 전자는 08-14 PDF, 후자는 08-20 블로그
- [ ] [[free-trial]] 은 우리 체험이 14일, [[decision-trial-7days]] 는 7일로 결정됨
      결정 이후 free-trial 이 갱신되지 않은 것으로 보임

## 낡은 문서 (중)

- [ ] [[market-overview]] 마지막 갱신 2026-03-11, 이후 자료 6건 들어옴

## 고아 문서 (중)

- [ ] [[user-interview-notes]] 링크 없음

## 없는 문서 (하)

- [ ] [[competitor-c]] 로 3곳에서 링크되는데 파일 없음

Obsidian에서 열면 체크박스가 눌러집니다. 하나씩 처리하면서 체크하면 어디까지 했는지 보입니다.

1.4 한 번에 다 고치지 않기

린트 결과를 받고 "전부 고쳐줘"라고 하고 싶어집니다. 하지 않습니다. 두 가지 이유입니다.

판단이 필요한 항목이 섞여 있습니다. 두 문서가 어긋날 때 어느 쪽이 맞는지는 사람이 정합니다. AI에게 맡기면 최근 자료를 무조건 채택하는데, 최근이 항상 옳은 것은 아닙니다.

한꺼번에 고치면 무엇이 바뀌었는지 알 수 없습니다. 문서 스무 장이 한 번에 바뀌면 검수가 불가능합니다.

순서를 정합니다.

기계적으로 확실한 것부터 처리합니다. 색인 갱신, 끊긴 링크 고치기, 한쪽만 걸린 링크 채우기입니다. 판단이 필요 없으니 한꺼번에 시켜도 됩니다.

린트 결과 중에 판단이 필요 없는 것부터 처리해줘.
- index.md를 실제 파일 목록에 맞게 갱신
- 한쪽에서만 걸린 링크를 양쪽으로
- 끊긴 링크 중 파일 이름 오타로 보이는 것

이 세 가지만. 나머지는 건드리지 마.

판단이 필요한 것은 하나씩 봅니다. 다음 절들에서 다룹니다.

자료를 더 구해야 하는 것은 목록으로 남겨 둡니다. 지금 당장 할 수 있는 일이 아닙니다.

1.5 린트 기록 남기기

린트가 끝나면 기록에 남깁니다.

log.md에 이번 린트 기록을 남겨줘.
- 발견한 문제 건수를 종류별로
- 처리한 것과 미룬 것
- 미룬 것은 왜 미뤘는지

## [2026-08-22] lint | 정기 점검

- 발견: 모순 2, 낡음 1, 고아 1, 없는 문서 1, 색인 불일치 3
- 처리: 색인 불일치 3건, 링크 3건
- 미룸: A사 팀 최소 인원 모순 (공식 페이지 확인 필요)
- 미룸: market-overview 갱신 (자료 6건 재검토 필요, 시간 필요)

미룬 것과 이유를 적어 두는 것이 중요합니다. 다음 린트에서 같은 항목이 또 나올 텐데, 왜 미뤘는지 적혀 있으면 다시 고민하지 않아도 됩니다.

다음 절에서 우리 위키에 맞는 린트 체크리스트를 만듭니다.