WikiDocs 장 분석 · 1장

1장. LLM위키가 필요한 이유 원문 기반 정리

이 장은 LLM위키를 만들기 전에 “왜 필요한가”를 판정한다. 핵심은 LLM 답변 자체보다, 보고서 톤, 회의록 정리 기준, 고객 정보 제외 규칙, 이미 합의한 판단 기준 같은 업무 맥락이 매번 프롬프트 안에서 소비되고 다음 작업의 기준 문서로 남지 않는다는 문제다.

소스 경로: data/runtime/write-agents/LLM wiki reference analyses/md/wikidocs/chapters/01-llm-wiki-needed.md

  1. 원문과 확인 범위
  2. 핵심 요지
  3. 원문 구조
  4. 세부 내용 정리
  5. 실무 적용 절차
  6. 예시와 체크리스트
  7. 검증 질문
  8. 관련 문서 연결
  9. 누락 또는 주의사항

원문과 확인 범위

확인일은 2026-06-06 KST이며, 장 랜딩과 하위 원문 1.1, 1.2, 1.3의 마지막 편집일시는 2026년 5월 16일 1:06 오후로 기록되어 있다. 장 랜딩 페이지는 세 하위 절 목록 중심의 짧은 입구이므로, 장 수준의 실질 내용은 1.1의 문제 진단, 1.2의 개념 정의, 1.3의 결과물 미리보기를 함께 읽어야 완성된다.

핵심 요지

1.1 문제 진단

대화 기록과 업무 지식은 다르다. 대화 기록은 질문, 중간 답변, 수정 요청, 잘못된 가정, 최종 결론이 시간순으로 섞인 원천 자료 후보일 수 있지만, 확인된 사실과 결정 기준과 금지 사항으로 재정리되기 전에는 다음 업무의 기준 문서가 아니다.

1.2 개념 정의

LLM위키는 특정 제품명이 아니라 지식 관리 패턴이다. 원천 자료를 보존하고, LLM이 다시 쓰기 좋은 위키 문서로 컴파일하며, 질문과 갱신과 검증 결과를 누적하는 운영 방식이다.

1.3 결과물 미리보기

첫 목표는 회사 전체 지식베이스가 아니라 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이 없으면 결과물이 무엇인지 모른 채 큰 지식베이스를 상상하게 된다.

세부 내용 정리

1. 반복 설명은 프롬프트 문제가 아니라 지식 후보 신호다

회의록 정리, 고객 문의 분류, 보고서 초안 같은 업무 요청에는 항상 배경 기준이 따라온다. 실행 항목 표기 방식, 결정 사항과 논의 중 항목의 분리, 민감 정보 제외, 공유 대상에 맞는 문체, 다음 회의 질문 같은 기준은 매번 새로 만들 정보가 아니다. 같은 업무를 반복한다면 이 기준은 다음에도 재사용할 업무 지식이다.

반대로 단순 말투 반복이나 일회성 아이디어 요청은 LLM위키보다 프롬프트 템플릿이나 개인 메모로 충분할 수 있다. 1장은 모든 LLM 대화를 위키로 만들라고 하지 않는다.

2. 대화 기록은 원천 후보이지 완성 지식이 아니다

대화 기록에 섞인 것위키 문서에서 분리할 것근거 위치
사용자의 배경 설명업무 기준, 금지 사항, 출력 형식1.1 매번 다시 설명하는 업무 맥락
LLM의 중간 답변채택한 내용과 버린 내용1.1 대화 기록과 업무 지식의 차이
사용자의 수정 요청예외 규칙과 검토 기준1.1 예시: 대화 기록을 업무 지식으로 바꾸기
마지막에 남은 결론확인일, 상태, 남은 확인 필요가 있는 기준 문서1.1 정리와 검증 포인트

이 변환을 거치면 “지난 대화 어디 있지?”가 “이 기준 문서를 참고해 처리하자”로 바뀐다. 1장의 문제 진단은 바로 이 전환을 목표로 한다.

3. LLM위키는 제품명이 아니라 반복 지식 작업의 운영 패턴이다

이 정의 때문에 LLM위키는 RAG와도 다르다. RAG는 질문 시점에 관련 자료를 검색해 답변을 보강하는 방식에 가깝고, LLM위키는 미리 정리된 지식 구조를 계속 갱신하는 운영 방식이다.

4. 컴파일은 요약이 아니라 재사용 가능한 지식으로 재구성하는 일이다

기준단순 요약LLM위키 컴파일
목적읽기 쉽게 줄인다.다음 질문과 산출물에 다시 쓴다.
근거출처가 빠질 수 있다.원천 자료, 확인일, 자료 성격을 남긴다.
구조하나의 설명문이 되기 쉽다.개념, 결정, 절차, 확인 필요, 다음 질문으로 나눈다.
연결파일 하나로 고립될 수 있다.관련 문서와 산출물로 이어진다.
위험 처리추정과 사실이 섞일 수 있다.확인되지 않은 내용은 확인 필요로 둔다.

5. 첫 결과물은 작고 물리적인 구조여야 한다

1.3은 LLM위키를 추상 개념으로 끝내지 않고 작은 폴더 구조로 보여 준다. 예제 주제는 work-automation이고, 최소 구성은 원천 자료를 둘 raw/, 정리 문서를 둘 wiki/, 보고서와 실행 계획을 둘 output/, 아직 정리하지 않은 메모를 둘 inbox/, 전체 입구인 index.md, 처리 이력인 log.md, 작업 규칙인 AGENTS.md 또는 CLAUDE.md다.

중요한 것은 폴더 이름 자체가 아니라 책임 분리다. 원천 자료가 보고서로 바로 바뀌면 근거를 추적하기 어렵다. 중간에 위키 문서가 있어야 질문의 맥락이 안정되고, 산출물의 근거도 다시 확인할 수 있다.

6. 1장의 산출물은 첫 후보와 첫 질문이다

실무 적용 절차

  1. 최근 1주일 동안 LLM에게 다시 설명한 업무 3개를 적는다.
  2. 각 업무에서 반복된 맥락을 출력 형식, 판단 기준, 금지 사항, 문체, 참고 자료, 결정 이력으로 나눈다.
  3. 단순 말투 반복인지, 출처와 확인일이 필요한 업무 기준인지 판정한다.
  4. 대화 기록을 그대로 보존할지, 업무 지식 문서로 재구성할지 결정한다.
  5. 후보별로 다음에도 필요한가, 팀이나 고객 합의 기준이 있는가, 다음 산출물에 바로 쓰이는가를 점검한다.
  6. 세 가지 이상 해당하는 후보만 첫 LLM위키 후보로 남긴다.
  7. 첫 후보는 회의록 실행 항목 정리, 월간 보고서 작성 규칙, 고객 문의 분류 기준처럼 작게 잡는다.
  8. 후보 업무의 원천 자료가 회의록, 기존 보고서, 정책 문서, 고객 문의 샘플, 대화 기록 중 어디에 있는지 적는다.
  9. 원천 자료가 거의 없으면 위키 후보가 아니라 확인 필요 또는 자료 수집 후보로 둔다.
  10. 민감 정보가 포함되면 외부 LLM 호출, 플러그인 권한, 저장 위치, 익명화 기준을 먼저 확인한다.
  11. 후보 업무를 LLM위키 패턴으로 한 문장 정의한다.
  12. 최소 결과물 구조를 적고 raw/, wiki/, output/에 들어갈 내용을 구분한다.
  13. 첫 질문에는 사용할 자료 범위, 업무 목적, 출력 형식, 확인 필요 표시를 포함한다.
  14. 2장으로 넘어가기 전에 원천, 위키, 산출물, 작업 규칙의 차이를 말로 설명할 수 있는지 확인한다.

예시와 체크리스트

첫 LLM위키 후보 판정표

질문후보 유지 신호제외 또는 보류 신호근거 위치
같은 설명을 반복했는가?같은 기준을 두 번 이상 설명했다.한 번만 쓴 일회성 요청이다.1.1 반복 업무 맥락
판단 기준이 있는가?좋은 답과 나쁜 답을 가르는 기준이 있다.단순 문장 다듬기나 취향 요청이다.1.1 반복 질문 탐지표
출력 형식이 반복되는가?매번 같은 표, 보고서, 요약 구조를 요구한다.결과물이 매번 달라 구조화 이점이 작다.1.1 반복 질문 탐지표
출처와 확인일이 중요한가?정책, 고객 기준, 제품 용어, 회의 결정이 들어간다.최신성이나 근거가 크게 중요하지 않다.1.1 첫 위키 후보 실습
원천 자료가 있는가?회의록, 보고서, 메모, 기존 문서가 있다.자료가 없어 LLM 추정으로 채워야 한다.1.2 신중해야 하는 상황
검토할 사람이 있는가?담당자나 팀이 결과를 확인할 수 있다.잘못 컴파일된 내용이 누적될 수 있다.1.2 신중해야 하는 상황
작은 범위로 시작 가능한가?다음 주 업무 하나에 바로 쓸 수 있다.전사 지식베이스처럼 범위가 크다.1.3 최소 구성

대화 기록을 업무 지식으로 바꾸는 최소 점검

1장 산출물 템플릿

산출물작성할 내용합격 기준
반복 맥락 후보 목록최근 LLM 요청, 다시 설명한 기준, 다음에도 필요한지후보가 3개 이하로 작고 구체적이다.
후보 판정 메모프롬프트 템플릿 후보인지 LLM위키 후보인지출처, 확인일, 결정 이력 필요 여부가 적혀 있다.
첫 위키 후보작고 반복되는 업무 질문 1개다음 주에 실제로 쓸 수 있다.
원천 후보회의록, 메모, 문서, 대화 기록 등최소 1개 이상 실제 근거가 있다.
결과물 그림raw, wiki, output, inbox, index, log, rules원천과 정리본과 산출물이 섞이지 않는다.
다음 장 질문이 후보의 원천과 정리본을 어떻게 나눌 것인가2장의 구조 설계로 바로 이어진다.

작게 시작하는 예시

큰 목표1장 기준으로 줄인 첫 후보이유
업무 자동화 전체주간 회의록에서 실행 항목을 일관되게 뽑기반복 업무이고, 회의록 원천이 있으며, 출력 형식과 확인 필요가 중요하다.
고객 지원 품질 개선고객 문의 유형과 긴급 태그 기준 정리분류 기준과 예외 규칙이 반복되고, 민감 정보 제외 기준이 필요하다.
제품 문서 개선릴리스 노트 공개 범위와 문체 기준 정리제품 용어, 금지 정보, 승인 기준이 반복된다.
글쓰기 품질 향상단순 문장 자연스럽게 고치기출처와 결정 이력이 약하면 프롬프트 템플릿으로 충분할 수 있다.

검증 질문

누락 또는 주의사항