WikiDocs 장 분석 · 1장
이 장은 LLM위키를 만들기 전에 “왜 필요한가”를 판정한다. 핵심은 LLM 답변 자체보다, 보고서 톤, 회의록 정리 기준, 고객 정보 제외 규칙, 이미 합의한 판단 기준 같은 업무 맥락이 매번 프롬프트 안에서 소비되고 다음 작업의 기준 문서로 남지 않는다는 문제다.
소스 경로: data/runtime/write-agents/LLM wiki reference analyses/md/wikidocs/chapters/01-llm-wiki-needed.md
확인일은 2026-06-06 KST이며, 장 랜딩과 하위 원문 1.1, 1.2, 1.3의 마지막 편집일시는 2026년 5월 16일 1:06 오후로 기록되어 있다. 장 랜딩 페이지는 세 하위 절 목록 중심의 짧은 입구이므로, 장 수준의 실질 내용은 1.1의 문제 진단, 1.2의 개념 정의, 1.3의 결과물 미리보기를 함께 읽어야 완성된다.
대화 기록과 업무 지식은 다르다. 대화 기록은 질문, 중간 답변, 수정 요청, 잘못된 가정, 최종 결론이 시간순으로 섞인 원천 자료 후보일 수 있지만, 확인된 사실과 결정 기준과 금지 사항으로 재정리되기 전에는 다음 업무의 기준 문서가 아니다.
LLM위키는 특정 제품명이 아니라 지식 관리 패턴이다. 원천 자료를 보존하고, LLM이 다시 쓰기 좋은 위키 문서로 컴파일하며, 질문과 갱신과 검증 결과를 누적하는 운영 방식이다.
첫 목표는 회사 전체 지식베이스가 아니라 work-automation 같은 작은 업무 주제 하나다. 최소 구조는 raw/, wiki/, output/, inbox/, index.md, log.md, rules 파일이다.
1장의 결론은 “LLM위키를 만들자”가 아니라 “작고 반복되는 업무 지식 하나를 골라 원천, 정리본, 산출물, 규칙으로 남길 준비가 되었는지 확인하자”이다.
| 원문 | 역할 | 핵심 내용 | 장 안에서의 기능 | 다음 장으로 넘기는 기준 |
|---|---|---|---|---|
| 1장 랜딩 | 필요성 장의 입구 | 1.1, 1.2, 1.3으로 구성됨을 안내한다. | 문제 진단에서 개념과 결과물 미리보기로 이동하는 관문이다. | 세부 절을 함께 읽어 첫 위키 후보와 최소 산출물을 정한다. |
| 1.1 LLM을 써도 지식이 남지 않는 이유 | 문제 진단 | 반복 업무 맥락, 대화 기록과 업무 지식의 차이, 첫 위키 후보 판정을 다룬다. | 어떤 업무가 LLM위키 후보인지 가른다. | 반복 기준, 출력 형식, 금지 사항, 출처 필요성이 있는 후보를 남긴다. |
| 1.2 LLM위키는 무엇인가 | 개념 정의 | LLM위키를 제품이 아니라 원천 자료, 위키, 작업 규칙을 잇는 지식 관리 패턴으로 설명한다. | 대화 저장, RAG, 노트, 일반 위키와의 차이를 잡는다. | 원천 보존, 컴파일, 질문, 검증, 갱신을 갖춘 흐름인지 확인한다. |
| 1.3 이 책에서 만들 결과물 | 결과물 미리보기 | 작은 업무 주제 위키, 최소 폴더, 작업 흐름, 장별 산출물을 제시한다. | 추상 개념을 실제 파일과 운영 흐름으로 바꾼다. | 2장에서 raw/, wiki/, output/, rules의 책임을 더 엄밀히 나눌 준비를 한다. |
세 절은 순서가 중요하다. 1.1이 없으면 도구부터 고르게 되고, 1.2가 없으면 LLM위키를 특정 앱이나 프롬프트 모음으로 오해하며, 1.3이 없으면 결과물이 무엇인지 모른 채 큰 지식베이스를 상상하게 된다.
회의록 정리, 고객 문의 분류, 보고서 초안 같은 업무 요청에는 항상 배경 기준이 따라온다. 실행 항목 표기 방식, 결정 사항과 논의 중 항목의 분리, 민감 정보 제외, 공유 대상에 맞는 문체, 다음 회의 질문 같은 기준은 매번 새로 만들 정보가 아니다. 같은 업무를 반복한다면 이 기준은 다음에도 재사용할 업무 지식이다.
반대로 단순 말투 반복이나 일회성 아이디어 요청은 LLM위키보다 프롬프트 템플릿이나 개인 메모로 충분할 수 있다. 1장은 모든 LLM 대화를 위키로 만들라고 하지 않는다.
| 대화 기록에 섞인 것 | 위키 문서에서 분리할 것 | 근거 위치 |
|---|---|---|
| 사용자의 배경 설명 | 업무 기준, 금지 사항, 출력 형식 | 1.1 매번 다시 설명하는 업무 맥락 |
| LLM의 중간 답변 | 채택한 내용과 버린 내용 | 1.1 대화 기록과 업무 지식의 차이 |
| 사용자의 수정 요청 | 예외 규칙과 검토 기준 | 1.1 예시: 대화 기록을 업무 지식으로 바꾸기 |
| 마지막에 남은 결론 | 확인일, 상태, 남은 확인 필요가 있는 기준 문서 | 1.1 정리와 검증 포인트 |
이 변환을 거치면 “지난 대화 어디 있지?”가 “이 기준 문서를 참고해 처리하자”로 바뀐다. 1장의 문제 진단은 바로 이 전환을 목표로 한다.
raw/: 회의록, 업무 메모, 웹 문서, 코드 리뷰 기록처럼 나중에 다시 확인할 원천 자료다.wiki/: 원천을 읽고 개념, 결정, 절차, 질문으로 재구성한 활용 문서다.AGENTS.md, CLAUDE.md, 정리 기준처럼 LLM이 원천과 정리본을 섞지 않도록 하는 작업 기준이다.이 정의 때문에 LLM위키는 RAG와도 다르다. RAG는 질문 시점에 관련 자료를 검색해 답변을 보강하는 방식에 가깝고, LLM위키는 미리 정리된 지식 구조를 계속 갱신하는 운영 방식이다.
| 기준 | 단순 요약 | LLM위키 컴파일 |
|---|---|---|
| 목적 | 읽기 쉽게 줄인다. | 다음 질문과 산출물에 다시 쓴다. |
| 근거 | 출처가 빠질 수 있다. | 원천 자료, 확인일, 자료 성격을 남긴다. |
| 구조 | 하나의 설명문이 되기 쉽다. | 개념, 결정, 절차, 확인 필요, 다음 질문으로 나눈다. |
| 연결 | 파일 하나로 고립될 수 있다. | 관련 문서와 산출물로 이어진다. |
| 위험 처리 | 추정과 사실이 섞일 수 있다. | 확인되지 않은 내용은 확인 필요로 둔다. |
1.3은 LLM위키를 추상 개념으로 끝내지 않고 작은 폴더 구조로 보여 준다. 예제 주제는 work-automation이고, 최소 구성은 원천 자료를 둘 raw/, 정리 문서를 둘 wiki/, 보고서와 실행 계획을 둘 output/, 아직 정리하지 않은 메모를 둘 inbox/, 전체 입구인 index.md, 처리 이력인 log.md, 작업 규칙인 AGENTS.md 또는 CLAUDE.md다.
중요한 것은 폴더 이름 자체가 아니라 책임 분리다. 원천 자료가 보고서로 바로 바뀌면 근거를 추적하기 어렵다. 중간에 위키 문서가 있어야 질문의 맥락이 안정되고, 산출물의 근거도 다시 확인할 수 있다.
raw/, wiki/, output/, inbox/, index.md, log.md, rules 파일raw/, wiki/, output/에 들어갈 내용을 구분한다.| 질문 | 후보 유지 신호 | 제외 또는 보류 신호 | 근거 위치 |
|---|---|---|---|
| 같은 설명을 반복했는가? | 같은 기준을 두 번 이상 설명했다. | 한 번만 쓴 일회성 요청이다. | 1.1 반복 업무 맥락 |
| 판단 기준이 있는가? | 좋은 답과 나쁜 답을 가르는 기준이 있다. | 단순 문장 다듬기나 취향 요청이다. | 1.1 반복 질문 탐지표 |
| 출력 형식이 반복되는가? | 매번 같은 표, 보고서, 요약 구조를 요구한다. | 결과물이 매번 달라 구조화 이점이 작다. | 1.1 반복 질문 탐지표 |
| 출처와 확인일이 중요한가? | 정책, 고객 기준, 제품 용어, 회의 결정이 들어간다. | 최신성이나 근거가 크게 중요하지 않다. | 1.1 첫 위키 후보 실습 |
| 원천 자료가 있는가? | 회의록, 보고서, 메모, 기존 문서가 있다. | 자료가 없어 LLM 추정으로 채워야 한다. | 1.2 신중해야 하는 상황 |
| 검토할 사람이 있는가? | 담당자나 팀이 결과를 확인할 수 있다. | 잘못 컴파일된 내용이 누적될 수 있다. | 1.2 신중해야 하는 상황 |
| 작은 범위로 시작 가능한가? | 다음 주 업무 하나에 바로 쓸 수 있다. | 전사 지식베이스처럼 범위가 크다. | 1.3 최소 구성 |
| 산출물 | 작성할 내용 | 합격 기준 |
|---|---|---|
| 반복 맥락 후보 목록 | 최근 LLM 요청, 다시 설명한 기준, 다음에도 필요한지 | 후보가 3개 이하로 작고 구체적이다. |
| 후보 판정 메모 | 프롬프트 템플릿 후보인지 LLM위키 후보인지 | 출처, 확인일, 결정 이력 필요 여부가 적혀 있다. |
| 첫 위키 후보 | 작고 반복되는 업무 질문 1개 | 다음 주에 실제로 쓸 수 있다. |
| 원천 후보 | 회의록, 메모, 문서, 대화 기록 등 | 최소 1개 이상 실제 근거가 있다. |
| 결과물 그림 | raw, wiki, output, inbox, index, log, rules | 원천과 정리본과 산출물이 섞이지 않는다. |
| 다음 장 질문 | 이 후보의 원천과 정리본을 어떻게 나눌 것인가 | 2장의 구조 설계로 바로 이어진다. |
| 큰 목표 | 1장 기준으로 줄인 첫 후보 | 이유 |
|---|---|---|
| 업무 자동화 전체 | 주간 회의록에서 실행 항목을 일관되게 뽑기 | 반복 업무이고, 회의록 원천이 있으며, 출력 형식과 확인 필요가 중요하다. |
| 고객 지원 품질 개선 | 고객 문의 유형과 긴급 태그 기준 정리 | 분류 기준과 예외 규칙이 반복되고, 민감 정보 제외 기준이 필요하다. |
| 제품 문서 개선 | 릴리스 노트 공개 범위와 문체 기준 정리 | 제품 용어, 금지 정보, 승인 기준이 반복된다. |
| 글쓰기 품질 향상 | 단순 문장 자연스럽게 고치기 | 출처와 결정 이력이 약하면 프롬프트 템플릿으로 충분할 수 있다. |
raw/, wiki/, output/, inbox/, index.md, log.md, rules 파일의 책임을 구분할 수 있는가?raw -> wiki -> output -> review 흐름으로 통합한 안내 문서다.raw/, wiki/, rules, index.md, log.md, output/ 구조로 나눈다.nvk/llm-wiki, WiCER, Codex AGENTS.md, Claude Code CLAUDE.md 관련 설명은 원문 확인일 기준의 배경 자료다. 실제 도구 도입 전에는 현재 공식 문서, 릴리스, 조직 보안 정책을 다시 확인해야 한다.