1. 모순과 낡은 주장 처리하기

린트가 찾아낸 것 중 판단이 필요한 항목들입니다. 여기서 하는 일이 위키에서 사람이 하는 일의 대부분입니다.

1.1 모순의 네 가지 원인

두 문서가 다른 말을 할 때, 원인이 넷 중 하나입니다. 어느 것인지에 따라 처리가 완전히 다릅니다.

가장 흔한 것이 첫 번째이고, 가장 많이 실수하는 것도 첫 번째입니다. 시점이 다른 것을 모순으로 보고 옛 값을 지워 버리면 그 대상이 어떻게 변해 왔는지가 사라집니다.

1.2 원인부터 알아내기

모순을 발견하면 고치기 전에 원인을 묻습니다.

[[competitor-a]] 는 팀 최소 5명, [[pricing-comparison]] 은 3명으로 돼 있어.

고치기 전에 확인해줘.
1. 각 문장의 출처 자료가 무엇이고 언제 것인지
2. 원본에서 해당 부분을 그대로 인용해서 보여줘
3. 두 자료가 같은 것을 재고 있는지, 다른 것을 재고 있는지

세 번째 질문이 기준 차이를 잡아냅니다. 한 자료는 "팀 플랜 신청 최소 인원"이고 다른 자료는 "팀 할인 적용 최소 인원"일 수 있습니다. 이러면 모순이 아니라 서로 다른 항목입니다.

1.3 시점이 다를 때

시간순으로 정리합니다. 현재 값은 위에, 변화는 아래에 쌓습니다.

[[competitor-a]] 의 팀 최소 인원 부분을 이렇게 고쳐줘.

- 현재 값은 3명 (2026-08-20 자료 기준)
- 그 아래 '시간순 기록' 절에
  2026-08 이전에는 5명이었다는 것을 남겨줘. 출처와 함께.
- [[pricing-comparison]] 도 현재 값으로 맞춰주고,
  그 문서의 updated 날짜를 갱신해줘.

이렇게 하면 두 값이 다 남으면서 무엇이 현재인지 분명해집니다. 나중에 "저 회사가 언제부터 최소 인원을 낮췄지"라는 질문에도 답할 수 있습니다.

1.4 정말 갈릴 때

두 자료가 서로 다른 주장을 하고 어느 쪽이 맞는지 알 수 없는 경우입니다. 이건 해결하는 것이 아니라 드러내 두는 것이 맞습니다.

이건 두 자료가 서로 다른 주장을 하는 거야. 어느 쪽으로도 정하지 마.

[[market-overview]] 에 이 대립을 정리해줘.
- 양쪽 주장과 각각의 근거
- 어느 자료에서 나왔는지, 그 자료의 성격은 무엇인지
  (업계 리포트인지, 기업 발표인지, 기사인지)
- 어느 쪽이 맞는지 알려면 무엇을 확인해야 하는지

문서 제목 아래 '한 줄 요약'에도 이 대립이 있다는 걸 적어줘.

마지막 줄이 중요합니다. 한 줄 요약은 색인에 들어가므로, 나중에 이 주제로 질문했을 때 대립이 있다는 것이 답에 반영됩니다.

결론을 못 내린 것을 결론 못 냈다고 적어 두는 것이 위키의 값을 올립니다. 어설픈 결론이 적혀 있으면 그걸 근거로 판단하게 되고, 대립이 적혀 있으면 판단하기 전에 확인하게 됩니다.

1.5 낡은 주장 처리하기

낡음은 모순과 다릅니다. 어긋나는 문장이 없어서 눈에 안 띕니다. 그냥 오래돼서 지금은 안 맞는 문장입니다.

린트에서 이렇게 찾습니다.

lint-checklist.md의 2번 항목으로 낡은 문서를 찾아줘.

각 문서마다
- 마지막 갱신일
- 그 이후 raw/에 들어온 관련 자료 목록
- 새 자료 때문에 안 맞을 것 같은 문장
을 보여줘.

찾은 문장은 세 가지로 갈립니다.

여전히 맞는 것. 갱신일만 새로 찍어 줍니다.

[[market-overview]] 를 확인했는데 내용은 여전히 맞아.
updated 날짜만 오늘로 바꾸고,
'2026-08-29 확인, 변경 없음'을 문서 하단 기록에 남겨줘.

확인했다는 기록을 남기는 것이 요령입니다. 다음 린트에서 또 걸리지 않습니다.

갱신이 필요한 것. 새 자료를 근거로 고칩니다. 이때 옛 내용을 지우지 않고 시간순 기록으로 내립니다.

이제 틀린 것. 이건 조심합니다. 지우지 않고 표시합니다.

[[free-trial]] 의 "구독형이 시장 표준" 문장은 이제 안 맞아.

지우지 말고 이렇게 고쳐줘.
- 문장 앞에 [2026-03 시점 판단] 을 붙이고
- 바로 아래에 지금은 어떻게 달라졌는지 새 문장을 근거와 함께 추가

틀린 판단을 지우면 우리가 그때 왜 그렇게 생각했는지가 사라집니다. 그 기록이 있어야 비슷한 실수를 반복하지 않습니다.

1.6 결정 재검토하기

6장에서 결정 문서에 '뒤집는 조건'을 적어 뒀습니다. 린트에서 그 조건이 충족됐는지 봅니다.

decisions/ 폴더의 모든 문서를 훑어줘.

각 문서의 '뒤집는 조건'을 읽고,
그 조건에 해당하는 데이터나 자료가 지금 위키에 있는지 확인해줘.

- 조건이 충족된 것
- 조건 판단에 필요한 데이터가 아직 없는 것
- 뒤집는 조건 자체가 안 적힌 것
으로 나눠서 알려줘.

첫 번째 항목이 나오면 그 결정을 다시 봐야 할 때입니다. 이게 위키가 해 주는 일 중 실제로 값이 나가는 것입니다. 반년 전에 정한 조건을 기억하고 있다가 알려주는 사람은 없습니다.

재검토해서 결정을 바꾸기로 했다면, 기존 문서를 고치지 않고 새 문서를 만듭니다.

decisions/trial-7days.md 의 결정을 뒤집기로 했어.

기존 문서는 그대로 두고 새 결정 문서를 만들어줘.
- 새 문서에 이전 결정을 [[trial-7days]] 로 링크하고
  무엇이 달라져서 바꾸는지 적어줘.
- 기존 문서 맨 위에 '이 결정은 [[새 문서]] 로 대체됨' 을 추가해줘.
- 기존 문서의 내용은 지우지 마.

결정의 역사가 남으면 "우리가 왜 이렇게 하고 있지"라는 질문에 훨씬 깊이 답할 수 있습니다.

다음 절에서 위키의 빈자리를 찾아 메우는 방법을 다룹니다.