1. Obsidian에서 결과 검수하기

인제스트가 끝났다는 답이 왔습니다. 이제 그 답을 믿을지 정해야 합니다. 이 절은 3분 안에 끝나는 검수 절차를 손에 익히는 자리입니다.

1.1 왜 대화창이 아니라 파일을 보나

AI의 보고는 이렇게 옵니다.

인제스트 완료했습니다.
- entities/competitor-a.md 갱신
- concepts/conversion-design.md 갱신
- topics/pricing-comparison.md 갱신

이 보고에는 무엇을 어떻게 바꿨는지가 없습니다. "갱신"이라는 단어 뒤에 한 문장을 더한 것도 갱신이고 문단 세 개를 지우고 다시 쓴 것도 갱신입니다.

그리고 더 중요한 문제가 있습니다. AI는 자기가 한 일을 자기가 보고합니다. 빼먹은 것을 빼먹었다고 보고하지 않습니다. 규칙을 어겼다는 것을 알아채지 못한 채 잘 처리했다고 말하기도 합니다.

그래서 파일을 봅니다. 파일에는 실제로 일어난 일만 적혀 있습니다.

1.2 3분 검수 절차

Obsidian에서 이 순서로 봅니다.

첫째, 새로 생긴 문서를 엽니다. 왼쪽 파일 목록에서 방금 생긴 것을 찾습니다. Obsidian은 최근 수정된 파일을 위로 올려 정렬할 수 있습니다. 파일 목록 위쪽의 정렬 아이콘에서 수정한 시간(Modified time)을 고르면 방금 건드린 문서가 맨 위로 옵니다.

둘째, 문장 하나를 골라 원본에서 찾습니다. 문서에서 가장 구체적인 문장, 보통 숫자가 든 문장을 고릅니다. 그 옆의 출처 표시를 보고 원본을 열어 실제로 그 숫자가 있는지 확인합니다.

한 문장만 확인해도 충분합니다. 한 문장이 맞으면 대체로 다른 문장도 맞고, 한 문장이 틀리면 그 인제스트 전체를 다시 봐야 합니다.

셋째, 출처 없는 문장을 찾습니다. 문서를 훑으면서 출처 표시가 없는 문장이 있는지 봅니다. [추론] 표시도 없이 출처가 비어 있는 문장이 AI가 자기 지식으로 채운 자리입니다.

넷째, 오른쪽 백링크 패널을 봅니다. 이 문서를 가리키는 문서가 하나도 없다면 방금 만든 문서가 위키에서 떨어져 나온 것입니다. 색인 말고 다른 문서에서도 연결돼야 합니다.

1.3 무엇이 바뀌었는지 보는 법

기존 문서가 어떻게 바뀌었는지는 눈으로 알기 어렵습니다. 두 가지 방법이 있습니다.

AI에게 바뀐 부분만 보여 달라고 합니다.

방금 인제스트에서 competitor-a.md의 어느 문장이
추가·수정·삭제됐는지 이전 내용과 나란히 보여줘.

인제스트 전에 미리 시켜 둡니다. 이 편이 더 확실합니다.

인제스트하기 전에, 고칠 문서들의 현재 상태를
어떻게 바꿀 계획인지 먼저 보여줘.
확인하면 진행할게.

이 습관을 들이면 되돌리기 어려운 사고가 거의 사라집니다. 특히 문서 여러 장을 한꺼번에 건드리는 인제스트에서는 계획을 먼저 받는 편이 안전합니다. 규칙 문서의 "한 번에 문서 10장 넘게 고쳐야 한다면 계획을 먼저 보여준다"는 줄이 이 역할을 합니다.

10장에서 Git을 붙이면 이 문제가 근본적으로 해결됩니다. 무엇이 바뀌었는지 줄 단위로 보이고, 마음에 안 들면 통째로 되돌릴 수 있습니다.

1.4 자주 나오는 문제 네 가지

출처가 문서 맨 아래에만 붙었습니다. 문장별 출처가 아니라 참고 목록만 있는 경우입니다. 이러면 어느 문장이 어디서 왔는지 알 수 없습니다.

competitor-a.md의 사실 문장마다 출처를 옆에 달아줘.
맨 아래 참고 목록만으로는 어느 문장이 어디서 왔는지 알 수 없어.

추론이 사실처럼 적혔습니다. 원본에는 요금표만 있는데 "이 회사는 시장 점유율을 노리고 있다"는 문장이 표시 없이 들어간 경우입니다.

competitor-a.md에서 원본에 직접 적혀 있지 않은 문장을 전부 찾아서
[추론] 표시를 붙여줘. 근거가 약하면 아예 빼도 좋아.

같은 대상 문서가 둘로 갈라졌습니다. competitor-a.md와 entities/A사.md가 따로 생긴 경우입니다. 파일 이름 규칙이 안 지켜진 것입니다.

같은 대상을 다루는 문서가 중복돼 있는지 wiki/ 전체를 확인해줘.
있으면 어느 쪽으로 합칠지 제안하고, 링크도 전부 고쳐줘.

문서가 너무 길어졌습니다. 자료 열 건이 한 문서에 들어가 화면 다섯 쪽이 된 경우입니다. 6장에서 쪼개는 기준을 다룹니다.

1.5 검수 결과를 규칙에 반영하기

같은 문제를 두 번 잡았다면 그건 규칙 문제입니다. 세 번째부터는 규칙 문서를 고칩니다.

인제스트할 때마다 출처가 문서 맨 아래에만 붙는 문제가 반복돼.
CLAUDE.md의 문서 작성 규칙에 이걸 막을 문장을 넣어줘.
지금 규칙에서 어느 부분이 모호해서 이런 일이 생기는지도 알려줘.

마지막 질문이 유용합니다. 규칙을 더하는 것보다 모호한 규칙을 명확하게 고치는 편이 대체로 낫습니다. 규칙이 길어질수록 뒤쪽이 흐려지기 때문입니다.

이 과정을 몇 번 돌면 검수에 걸리는 시간이 줄어듭니다. 처음에는 문서 하나하나를 다 읽게 되지만, 규칙이 자리를 잡으면 새로 생긴 문서만 훑고 넘어가게 됩니다.

다음 절에서 자료 종류별로 다르게 해야 할 것들을 정리합니다.