위키 문서로 정리하기

핵심 요약

5.3의 핵심은 수집한 raw 자료를 읽기 좋은 요약 하나로 압축하지 말고, 재사용 질문 기준의 여러 wiki 문서로 재구성하라는 것이다. 회의록 하나도 문의 유형, 상담사 연결 기준, 자동화 실험 계획처럼 서로 다른 판단에 쓰이는 문서로 나뉠 수 있다.

좋은 문서 분할 기준은 자료 종류가 아니라 질문이다. 같은 회의록에서 나온 내용이라도 자동화 우선순위를 묻는 문서와 예외 처리 조건을 묻는 문서는 분리해야 LLM이 필요한 근거만 불러와 답변할 수 있다.

문서가 늘어나면 중복과 모순이 생긴다. 이때 목표는 모든 반복을 삭제하는 것이 아니라 같은 판단 기준은 대표 문서로 모으고, 조건이나 날짜가 다른 결론은 확인 필요 또는 모순 후보로 남기는 것이다.

정리된 문서는 다시 찾을 수 있어야 한다. index.md는 단순 목차가 아니라 질문별 출발점이고, log.md는 언제 어떤 자료로 어떤 문서를 바꿨는지 추적하는 처리 이력이다. 링크는 많을수록 좋은 것이 아니라 근거, 예외, 다음 행동 중 하나의 역할을 설명해야 한다.

원문 구조

상세 분석

1. 위키 문서화는 요약이 아니라 질문 기준 재구성이다

raw/에 자료가 쌓여도 그 자체로 LLM위키가 완성되지는 않는다. 회의록, 웹 문서, 개인 메모는 원천 자료로서 가치가 있지만 그대로는 다음 질문에서 바로 쓰기 어렵다. 필요한 작업은 읽기 좋은 요약이 아니라, 다시 질문할 수 있고 근거로 돌아갈 수 있는 wiki 문서로 재구성하는 것이다.

2. 하나의 raw는 여러 wiki 문서로 나뉠 수 있다

고객지원 자동화 회의록 하나에서도 문의 유형, 상담사 연결 기준, 자동화 실험 계획이라는 세 문서가 나올 수 있다. 핵심은 한 자료를 한 문서로만 대응시키지 않는 것이다. 한 회의록 안에도 자동화 우선순위, 예외 처리, 실험 성공 기준이 함께 들어 있을 수 있기 때문이다.

3. 위키 문서는 최소 구조를 가져야 다음 질문에 쓰인다

각 wiki 문서는 한 문장 요약, 근거, 확인된 내용, 확인 필요, 다시 물어볼 질문을 가져야 한다. 이 구조는 형식 장식이 아니라 이후 질문과 검증을 위한 입력 구조다.

4. raw를 지우지 않는 이유는 정리 오류를 검증하기 위해서다

원천 자료를 쪼개면서 원문을 지우면 안 된다. wiki 문서가 잘못 정리되었는지 확인하려면 원문으로 돌아갈 수 있어야 한다. raw는 원천 검증점이고 wiki는 질문과 산출물에 쓰는 파생 지식이다.

5. 중복은 기준 문서가 필요하다는 신호다

문서가 늘어나면 같은 내용이 반복된다. 어느 정도 반복은 자연스럽지만, 반복된 문장이 각 문서에서 조금씩 다르게 바뀌면 위험하다. 목표는 판단 기준을 한곳에서 관리하고 다른 문서는 그 기준 문서로 돌아가게 하는 것이다.

6. 모순은 즉시 통합하지 말고 조건과 날짜를 확인한다

환불 문의 자동화와 상담사 연결 기준은 겉으로 충돌해 보여도 조건이 다를 수 있다. 단순 환불 문의는 자동 응답이 가능하고, VIP 또는 정책 예외가 있는 환불은 상담사 확인이 필요할 수 있다. 안전한 처리 흐름은 모순 제거가 아니라 모순 가시화다.

1. 비슷하거나 반대처럼 보이는 문장을 찾는다.
2. 두 문장이 같은 사실을 말하는지 확인한다.
3. 자료의 날짜, 조건, 독자, 적용 범위가 다른지 본다.
4. 같은 기준의 중복이면 대표 기준 문서로 모은다.
5. 조건이 다르면 조건별 판단으로 나눈다.
6. 근거가 부족하면 삭제하지 말고 모순 후보 또는 확인 필요로 남긴다.
7. 기준 문서가 필요하면 새 문서를 만들고 관련 문서를 연결한다.
8. 어떤 문서를 고쳤는지 log에 남긴다.

7. index와 log는 문서화 결과를 다시 찾게 하는 장치다

잘 정리된 문서도 찾지 못하면 다시 쓰기 어렵다. index.md는 위키 전체의 입구이고, 주제별 인덱스는 커진 위키에서 특정 영역의 출발점이 된다. log.md는 언제 어떤 자료를 넣고 어떤 문서를 바꿨는지 보여 준다.

8. 좋은 링크는 관계와 용도를 설명한다

모든 문서가 서로를 가리키면 탐색은 쉬워 보이지만 구조가 흐려진다. 좋은 링크는 관계가 분명하다. 실험 계획에서 문의 유형으로 가는 링크는 실험의 근거를 확인하게 하고, 환불 자동화 문서에서 상담사 연결 기준으로 가는 링크는 충돌 후보를 검토하게 한다.

9. 5.3은 6장의 질문 품질을 결정한다

5.3에서 만든 문서는 6.1의 좋은 질문과 6.2의 근거 확인에 직접 쓰인다. 문의 유형 문서가 분리되어 있으면 자동화 우선순위 질문을 좁힐 수 있고, 상담사 연결 기준 문서가 있으면 예외 처리 질문을 별도로 던질 수 있다. 반대로 모든 내용을 하나의 회의록 요약에 넣으면 LLM은 답변에 필요한 부분만 안정적으로 선택하기 어렵다.

실무 적용 절차

1. 5.1의 수집 기준 카드와 5.2의 원천 카드를 확인한다. 출처, 확인일, 자료 성격, 수집 이유가 없는 자료는 먼저 보강한다.
2. 수집 자료를 바로 요약하지 말고 자료 안의 의미 단위를 표시한다. 결정, 논의, 실행 항목, 예외, 정책, 아이디어, 확인 필요를 구분한다.
3. 각 의미 단위가 나중에 어떤 질문에 쓰일지 적는다.
4. 질문이 다르면 문서를 나눈다. 자료 종류가 같아도 우선순위 판단, 예외 판단, 실험 계획은 별도 문서가 될 수 있다.
5. 문서마다 한 문장 요약, 근거, 확인된 내용, 확인 필요, 다시 물어볼 질문을 넣는다.
6. 원천 자료는 raw/에 보존한다. 정리 과정에서 raw를 덮어쓰지 않는다.
7. 같은 raw에서 여러 wiki 문서가 나왔으면 각 문서의 근거 블록에 같은 raw 경로와 확인 날짜를 남긴다.
8. 문서가 늘어나면 같은 사실이 반복되는 위치를 찾는다.
9. 반복된 기준은 대표 기준 문서로 모으고, 다른 문서에서는 짧게 요약한 뒤 링크한다.
10. 서로 다른 결론처럼 보이는 문장은 즉시 삭제하지 않는다. 조건, 날짜, 자료 성격, 적용 범위를 비교한다.
11. 충돌이 확정되지 않았으면 모순 후보 또는 확인 필요로 표시한다.
12. 기준 문서가 필요하면 새 문서 후보를 만들고 관련 문서를 연결한다.
13. index.md에 핵심 질문과 먼저 볼 문서를 연결한다.
14. 주제가 커졌다면 wiki/support-index.md, wiki/experiment-index.md 같은 주제별 인덱스를 검토한다.
15. log.md에 원천 자료, 생성 또는 변경한 문서, 모순 후보, 확인 필요를 남긴다.
16. 링크를 점검한다. 링크마다 근거, 예외, 다음 행동 중 어떤 역할인지 설명할 수 있어야 한다.
17. LLM에게 정리를 맡길 때는 삭제보다 표시를 우선하게 한다. raw 수정 금지, 근거 부족 단정 표시, 모순 후보 보존, 기준 문서 제안을 요청한다.
18. 정리 결과를 사람이 검토한다. 규칙 파일은 작업 기준을 전달할 뿐 결과 품질을 보장하지 않는다.
19. 6장으로 넘어가기 전 첫 업무 질문을 하나 골라, 어떤 wiki 문서를 자료 범위로 삼을지 확인한다.
20. 다음 자료를 넣을 때 갱신할 문서와 새로 생길 수 있는 모순 후보를 미리 예상한다.

실무 템플릿

주제 문서 분할 매트릭스

wiki 문서 기본 골격

# 문서 제목

## 한 문장 요약
- 현재 자료 기준의 결론을 한 문장으로 쓴다.

## 근거
- 원천 자료:
- 확인 날짜:
- 자료 성격:
- 적용 범위:

## 확인된 내용
- raw 또는 검토된 wiki에서 확인되는 내용만 적는다.

## 확인 필요
- 자료 부족, 최신성, 정의 미정, 충돌 후보를 적는다.

## 관련 문서
- 근거, 예외, 기준, output 문서 링크를 둔다.

## 다시 물어볼 질문
- 이 문서를 기준으로 다음에 던질 업무 질문을 적는다.

중복과 모순 감사표

기준 문서 설계 카드

index 갱신 카드

LLM 정리 요청 프롬프트

wiki/ 폴더의 문서를 검토해 주세요.

목표:
- 같은 사실이 반복된 곳을 찾습니다.
- 서로 충돌할 수 있는 문장을 찾습니다.
- 근거가 부족한 단정은 확인 필요로 표시합니다.
- 기준 문서가 필요하면 문서명과 역할을 제안합니다.

주의:
- raw/ 원천 자료는 수정하지 마세요.
- 충돌 여부가 애매하면 삭제하지 말고 모순 후보로 남기세요.
- 각 판단에는 근거 문서와 확인일을 붙이세요.
- index.md와 log.md에 남길 변경 항목을 제안하세요.

검증 체크리스트

좋은 질문과 검증 질문

LLM에게 던질 좋은 질문

• 이 raw 회의록을 그대로 요약하지 말고, 다시 물을 질문 기준으로 wiki 문서 후보를 나누어 주세요. 각 후보에는 문서명, 답할 질문, 근거, 확인 필요를 붙여 주세요.
• 이 wiki 문서 묶음에서 같은 사실이 반복되는 곳과 충돌할 수 있는 문장을 찾아 주세요. 삭제하지 말고 기준 문서 후보와 확인 필요 항목으로 분리해 주세요.
• 이 문서들의 링크를 점검해 주세요. 각 링크가 근거 확인, 예외 검토, 다음 행동 중 어떤 목적을 갖는지 표시하고 장식성 링크를 제거 후보로 표시해 주세요.
• index를 질문별 안내판으로 갱신해 주세요. 모든 문서를 나열하지 말고 사용자가 어떤 질문에서 어디를 먼저 읽어야 하는지 중심으로 작성해 주세요.
• log에 남길 처리 이력을 제안해 주세요. 원천 자료, 생성 문서, 변경 문서, 확인 필요, 모순 후보를 표로 나누어 주세요.

사람이 확인할 검증 질문

• 이 문서는 왜 별도 wiki 문서로 존재해야 하는가?
• 이 문서가 답하는 질문은 다른 문서의 질문과 실제로 다른가?
• 이 문장에 대한 원천 자료를 raw에서 다시 찾을 수 있는가?
• 중복을 줄인다고 과거 판단이나 조건 차이를 지워 버리지 않았는가?
• 모순 후보를 빨리 매끄럽게 만들려고 확인 필요를 삭제하지 않았는가?
• index를 보면 처음 온 사람이 질문별 출발점을 찾을 수 있는가?
• log를 보면 언제 어떤 자료로 어떤 문서를 만들거나 바꿨는지 알 수 있는가?
• 링크가 다음 확인이나 다음 행동을 돕는가, 아니면 장식인가?

흔한 실패와 수정 방향

관련 문서

• 5장. 자료를 넣고 다시 쓰기 좋은 지식으로 바꾸기: 5.1-5.3의 수집 기준, 자료 수집, 문서화 흐름을 묶는다.
• 5.1 자료를 넣기 전에 정할 기준: raw와 wiki 분리 기준, 포함/제외 범위, 민감 정보 기준을 먼저 세운다.
• 5.2 자료 수집하기: 웹 문서, 회의록, 업무 메모를 출처와 확인일이 있는 원천 카드로 만든다.
• 2.1 지식이 쌓이는 세 층: raw, wiki, rules의 신뢰 경계를 설명한다.
• 2.2 좋은 폴더 구조 이해하기: index, log, output과 원본/요약 분리 원칙을 제공한다.
• 2.3 좋은 위키 문서의 조건: 출처, 재사용성, 링크 기준이 5.3 문서화 품질의 기반이다.
• 4.3 첫 질문으로 방향 잡기: 5.3에서 만든 문서를 첫 질문의 자료 범위로 지정하는 방법을 다룬다.
• 6.1 좋은 질문 만들기: 주제별 wiki 문서를 업무 질문의 경계로 사용하는 방법을 확장한다.
• 6.2 답변의 근거 확인하기: 5.3의 근거 블록을 답변 문장별 검증에 사용한다.
• 6.3 답변을 다시 위키에 반영하기: 검증된 답변만 관련 wiki, index, log에 반영한다.
• 7.3 다음 행동으로 연결하기: 자동화 실험 문서와 output을 담당자, 기한, 완료 기준으로 연결한다.
• 8.2 정리와 감사 흐름 만들기: 중복, 모순, 링크, 최신성 문제를 주기적으로 점검한다.
• 8.3 주제가 늘어날 때 관리하기: 문서가 늘어날 때 기존 위키에 둘지 새 주제로 나눌지 판단한다.

한계와 확인 필요

• 고객지원 자동화 회의록과 환불 문의 예시는 학습용이다. 실제 자료에는 개인정보, 고객명, 계약 조건, 내부 정책, 상담 이력이 포함될 수 있으므로 raw 투입 전 익명화와 접근 권한을 확인해야 한다.
• 원문 실습 명령은 학습용 로컬 폴더를 만든다. 실제 업무 폴더에서 실행하면 기존 index, log, wiki 문서를 덮어쓸 수 있으므로 경로와 기존 파일 존재 여부를 먼저 확인해야 한다.
• 규칙 파일은 작업 기준을 전달할 뿐 품질을 보장하지 않는다. raw 보존, 근거 표시, 확인 필요, 링크, log 갱신 여부는 결과 파일에서 직접 검토해야 한다.
• 중복과 모순은 항상 기계적으로 제거할 수 없다. 서로 다른 날짜, 조건, 독자, 정책 버전이 만든 차이일 수 있으므로 판단 변화와 확인 필요를 남기는 편이 안전하다.

이 절의 완료 기준

1. 수집 자료를 질문 기준의 여러 wiki 문서 후보로 나누었다.
2. 각 wiki 문서가 한 문장 요약, 근거, 확인된 내용, 확인 필요, 다시 물어볼 질문을 가진다.
3. raw 원천 자료는 보존되고, wiki 문서는 파생 지식으로 남는다.
4. 같은 사실의 반복은 대표 기준 문서와 링크로 정리했다.
5. 모순 후보는 삭제하지 않고 조건, 날짜, 근거, 확인 필요로 표시했다.
6. index에서 핵심 질문별로 먼저 볼 문서를 찾을 수 있다.
7. log에 원천 자료, 생성 또는 변경 문서, 확인 필요가 남아 있다.
8. 링크마다 근거 확인, 예외 검토, 다음 행동 중 하나의 역할이 있다.
9. 다음 단계인 6장에서 질문할 때 사용할 자료 범위와 근거 경로가 준비되어 있다.