WikiDocs LLM위키 완벽 가이드 · 3장
3.3의 핵심은 도구를 골랐더라도 실제 업무 자료를 바로 넣지 말고, 작은 실습 환경에서 원본 보존, 위키 정리, 작업 이력, 규칙 파일 반영 여부를 먼저 검증하라는 것이다. 성공 기준은 제품 설치가 아니라 raw/, wiki/, output/, index.md, log.md, 작업 규칙 파일이 작은 예제에서 제대로 작동하는지다.
첫 raw 샘플은 실제 고객 정보가 아니라 가상 회의록이나 익명화 메모여야 한다. 작은 예제로 시작해야 실패했을 때 자료 범위, 질문 품질, 지침 파일 로드, 출처 표시, 확인 필요 누락을 분리해서 볼 수 있다.
이 절의 최종 산출물은 나의 LLM위키 실습 환경 문서다. 실습 폴더, 사용할 LLM 도구, Markdown 편집기, 원천 자료 정책, 작업 규칙 파일, 검증 기준, 현재 확인 필요를 한 장으로 남겨야 4장에서 첫 주제 위키를 안정적으로 시작할 수 있다.
| 원문 절 | 핵심 내용 | 실무 의미 |
|---|---|---|
| 도입부 | 특정 제품보다 원본 보존, 위키 문서, 작업 이력을 작은 예제로 확인한다. | 도구 선택 이후에도 구조 검증 단계를 별도로 둔다. |
| 작은 예제로 먼저 검증하기 | Markdown, raw/wiki/output, index/log, rules 파일, 가상 회의록을 기본 환경으로 제시한다. | 기능 많은 도구보다 작게 검증 가능한 환경을 우선한다. |
| 10분짜리 미니 위키 만들기 | raw 회의록, wiki 개념 문서, index, log, AGENTS, 선택적 CLAUDE를 만든다. | 자동화 없이도 최소 신뢰 구조를 확인한다. |
| 도구가 바뀌어도 유지되는 흐름 | 자료 넣기, 묻기, 점검하기를 ingest, query, lint 흐름과 연결한다. | 명령 이름이 달라도 작업 책임을 판단한다. |
| 환경 기록과 검증 | 도구, 구조, 규칙, 입력 기준, 검증 기준, 확인 필요를 남긴다. | 4장 진입 전 누락과 보안 사고를 줄인다. |
3.1은 시작 방식을 고르고, 3.2는 도구의 설치, 저장 구조, 권한을 본다. 3.3은 그 뒤에 실제 자료 투입을 잠시 멈추고 최소 실습 환경을 고정한다. 바로 긴 회의록, 고객 문의, PDF 보고서, 내부 계약 정보를 넣으면 LLM 답변이 틀렸을 때 자료가 너무 넓은지, 질문이 약한지, 지침 파일이 읽히지 않았는지, wiki 문서가 출처를 잃었는지 구분하기 어렵다.
| 위험 | 3.3의 대응 |
|---|---|
| 자료 범위가 커서 실패 원인을 모른다. | 회의록 하나로 raw, wiki, log 책임을 본다. |
| 실제 민감 정보가 장기 보관된다. | 가상 또는 익명화 자료로 시작한다. |
| 요약이 원본처럼 취급된다. | raw와 wiki를 물리적으로 분리한다. |
| 규칙 파일이 실제로 반영됐는지 모른다. | rules 파일을 만들고 결과 파일로 대조한다. |
원문이 제시한 기본 환경은 폴더 이름 목록이 아니라 신뢰 경계다. raw/는 원본 근거, wiki/는 재질문 가능한 파생 지식, output/은 산출물 공간, index.md는 길 안내, log.md는 작업 이력, AGENTS.md와 CLAUDE.md는 도구별 작업 규칙이다. 이 구조는 2.1의 raw/wiki/rules 신뢰 경계와 2.2의 index/log/output 역할을 실습 환경으로 옮긴 것이다.
| 구성 요소 | 역할 | 통과 기준 | 실패 신호 |
|---|---|---|---|
raw/ | 원본 회의록과 메모 보존 | 날짜, 주제, 자료 성격, 원본성이 남는다. | LLM 요약과 개인 해석이 섞인다. |
wiki/ | raw를 근거로 한 정리 문서 | 요약, 근거, 확인된 내용, 확인 필요, 다음 질문이 있다. | 출처 없는 자연스러운 요약만 있다. |
output/ | 보고서와 실행 계획 공간 | 산출물이 생기면 wiki/raw 근거로 돌아간다. | output이 원천의 유일한 사본이 된다. |
index.md | 탐색 출발점 | 원천과 wiki 위치를 짧게 안내한다. | 긴 본문 저장소가 된다. |
log.md | 작업 이력 | 날짜, 작업, 변경 파일, 확인 필요가 남는다. | 무엇이 언제 바뀌었는지 모른다. |
AGENTS.md | Codex 작업 기준 | raw 수정 금지, 근거 표시, 확인 필요, log 갱신 기준이 있다. | 요청마다 처리 방식이 바뀐다. |
CLAUDE.md | Claude Code 작업 기준 | AGENTS.md 연결 또는 같은 규칙을 둔다. | 모든 도구가 같은 파일을 읽는다고 가정한다. |
원문은 macOS 또는 Linux 계열 셸 기준 실습을 제공하지만, Windows에서는 WSL, Git Bash, 수동 파일 생성 방식으로 조정할 수 있다. 중요한 것은 명령 복사가 아니라 결과 검사다. raw에는 원본 회의록이 있고, wiki에는 그 원본 경로가 있는 정리 문서가 있으며, index와 log에는 위치와 작업 이력이 남아야 한다.
Codex를 쓰면 AGENTS.md, Claude Code를 쓰면 CLAUDE.md를 확인한다. 둘 다 쓰는 경우 CLAUDE.md가 AGENTS.md를 참조하게 둘 수 있다. 다만 규칙 파일은 결과를 자동 보장하지 않는다. raw 수정 금지, wiki 근거 표시, 확인 필요 표시, log 갱신을 적었더라도 실제 산출물이 이를 지켰는지는 별도로 검토해야 한다.
| 규칙 | 결과에서 확인할 증거 | 실패 시 수정 |
|---|---|---|
| raw 원본은 임의 수정하지 않는다. | raw가 보존되거나 수정 이유가 log에 있다. | raw 복구, 요청 문장 보강 |
| wiki 문서는 원천 경로를 남긴다. | 원천 자료: raw/... 같은 근거 블록이 있다. | wiki 템플릿에 근거 섹션 추가 |
| 불확실한 내용은 확인 필요로 둔다. | 미측정 효과와 미정 도구가 확인 필요에 있다. | 단정문을 조건부 문장으로 낮춤 |
| 작업 후 log를 남긴다. | 날짜, 작업, 변경 파일이 기록된다. | 완료 조건에 log 갱신 추가 |
도구가 계속 바뀌어도 핵심 흐름은 거의 같다. 책은 이를 자료 넣기, 묻기, 점검하기로 다루고, Karpathy의 LLM Wiki 원문에서 말하는 ingest, query, lint 흐름과 연결한다. 업무 질문에서 raw 보관, wiki 정리, index/log 갱신, 질문, 답변과 산출물, 근거 점검, 다시 wiki 정리로 돌아가는 순환이 만들어진다.
| 흐름 | 파일 기준 행동 | 검증 기준 |
|---|---|---|
| 자료 넣기 | 원본을 raw/에 보관한다. | 원본과 파생 문서가 분리된다. |
| 위키 정리 | wiki/에 요약, 근거, 확인된 내용, 확인 필요를 둔다. | 핵심 주장마다 근거 위치가 있다. |
| 묻기 | wiki 기준으로 업무 질문을 던진다. | 사용할 자료 범위와 출력 형식이 명확하다. |
| 산출 | output/에 보고서나 실행 계획을 둔다. | 산출물이 wiki/raw 근거로 돌아간다. |
| 점검 | 답변을 근거 있음, 추정, 출처 없음으로 나눈다. | 추정이 보고서 단정문으로 승격되지 않는다. |
| 갱신 | 검증된 결정만 wiki와 log에 반영한다. | 다음 질문에서 같은 배경 설명이 줄어든다. |
raw/, wiki/, output/, index.md, log.md, AGENTS.md를 만들고, Claude Code도 쓸 경우 CLAUDE.md를 추가한다.AGENTS.md에는 raw 수정 금지, 근거 표시, 확인 필요, log 갱신 기준을 쓴다.| 항목 | 내 결정 | 확인 필요 |
|---|---|---|
| 실습 폴더 | 실제 업무 자료와 분리되는가? | |
| 사용할 LLM 도구 | 폴더 접근과 지침 파일 로드가 가능한가? | |
| Markdown 편집기 | .md, 링크, 표를 직접 확인할 수 있는가? | |
| 원천 자료 정책 | 첫 실습은 가상 또는 익명화 자료인가? | |
| 작업 규칙 파일 | AGENTS.md, CLAUDE.md 중 무엇을 쓸 것인가? | |
| 출처 표기 방식 | raw 경로, URL, 확인일이 남는가? | |
| 확인 필요 표시 | 확인 필요가 단정문으로 숨지 않는가? | |
| log 기준 | 날짜, 작업, 변경 파일을 남기는가? | |
| 보안 기준 | 고객 정보, 계약 정보, 개인정보, 비공개 코드가 제외되는가? | |
| 버전 확인 | 플러그인/CLI 사용 전 현재 문서를 확인했는가? |
| 위치 | 확인할 내용 |
|---|---|
raw/ | 원본 회의록 또는 메모가 보존되어 있고, LLM 요약이 섞이지 않는다. |
wiki/ | 원천 경로, 확인된 내용, 확인 필요, 다시 물어볼 질문이 있다. |
output/ | 산출물이 생기면 wiki/raw 근거로 돌아갈 수 있다. |
index.md | 처음 읽을 문서와 원천 자료 위치를 안내한다. |
log.md | 자료 추가와 문서 생성 이력을 남긴다. |
AGENTS.md / CLAUDE.md | raw 보호, 근거 표시, 확인 필요, log 갱신 기준이 있다. |
raw/, wiki/, output/, index.md, log.md, AGENTS.md가 있다.CLAUDE.md 로드 방식이 정해져 있다.AGENTS.md, Claude Code를 쓰면 CLAUDE.md를 확인했다.raw, wiki, output, index.md, log.md, AGENTS.md의 역할이 지켜졌는지 점검해 주세요.AGENTS.md 또는 CLAUDE.md 규칙을 요약하고 raw 보호, 근거 표시, 확인 필요, log 갱신 기준이 빠졌는지 점검해 주세요.raw, wiki, rules의 신뢰 경계를 설명한다.index.md, log.md, output/ 역할과 원본/요약 분리 원칙을 제공한다.nvk/llm-wiki, OpenAI Codex AGENTS.md, Codex Plugins, Claude Code Memory 문서는 원문 확인일 기준 정보다. 실제 사용 전 현재 공식 README, 릴리스, 설치된 도움말, 데이터 공유 정책을 다시 확인해야 한다.AGENTS.md와 CLAUDE.md는 작업 기준을 전달하는 파일이지 raw 보호, 보안, 품질을 자동 강제하지 않는다.raw/, wiki/, output/, index.md, log.md, AGENTS.md, 필요 시 CLAUDE.md의 역할을 설명할 수 있다.