4.2 위키 초기화하기 원문 기반 심화 분석

원문 구조와 실무 의미

상세 분석

1. 초기화는 주제를 운영 구조로 바꾸는 일

4.1에서 업무 자동화 전체처럼 큰 범위를 피하고 작고 검증 가능한 주제를 골랐다면, 4.2에서는 그 주제의 원천 자료, 정리 문서, 산출물, 안내판, 이력, 작업 규칙이 어디에 남을지 결정한다. 첫 자료를 넣은 뒤에는 구조를 바꾸기 어렵기 때문에 이 단계의 경계 설정이 중요하다.

2. raw와 wiki의 경계를 먼저 확인한다

raw는 회의록, 메모, 웹 문서 저장본처럼 사실 확인을 위해 돌아갈 원본 기준점이다. wiki는 raw를 바탕으로 만든 개념 정리, 질문별 답변, 판단 기준, 다음 질문 같은 파생 지식이다. 이 구분은 5장의 자료 수집, 6장의 근거 검증, 7장의 산출물 작성으로 이어지는 신뢰 경계다.

3. 최소 폴더 실습은 기존 파일 보호까지 포함한다

원문 실습은 대상 폴더가 이미 있으면 중단하게 한다. 이는 기존 index.md, log.md, AGENTS.md, raw 자료를 덮어쓰지 않기 위한 안전장치다. 실무에서는 실습용 경로와 실제 업무 경로를 분리하고, 대상 경로가 비어 있는지 확인한 뒤 진행해야 한다.

1. 실습용 폴더와 실제 업무 폴더를 분리한다.
2. 초기화 전 대상 경로가 비어 있는지 확인한다.
3. 기존 파일이 있으면 새 경로를 쓰거나 백업과 변경 이유를 기록한다.
4. raw/, wiki/, output/을 먼저 만든다.
5. index.md와 log.md에는 핵심 질문과 초기화 기록을 넣는다.
6. 구조 목록을 확인하고 각 위치의 역할을 다시 점검한다.

4. index.md와 log.md는 운영의 입구와 이력이다

index.md에는 위키 제목, 핵심 질문, 먼저 읽을 문서, 원천 자료 위치, 최근 산출물, 확인 필요를 둔다. log.md에는 날짜, 작업, 변경 파일, 근거, 확인 필요를 남긴다. 아직 문서가 없어도 비워 두기보다 아직 없음 또는 확인 필요처럼 상태를 표시하는 편이 낫다.

5. AGENTS.md는 작업 기준을 공유하는 계약이다

AGENTS.md는 원본 보호, wiki 작성 위치, output 위치, 근거와 확인일, 근거 부족 시 확인 필요 표시, 문서 작성 형식, 첫 주제 범위를 규칙화한다. 좋은 규칙은 결과물에서 검증 가능해야 한다. 예를 들어 raw 원본을 승인 없이 바꾸지 않는지, 새 wiki 문서가 원천 위치와 확인일을 남기는지, output에서 사용한 근거로 되돌아갈 수 있는지를 확인할 수 있어야 한다.

6. CLAUDE.md는 도구 혼용 시 선택적으로 둔다

Codex만 쓰면 AGENTS.md를 중심 규칙으로 두면 된다. Claude Code도 쓴다면 CLAUDE.md를 추가하거나 현재 도구의 메모리 로드 방식으로 같은 규칙을 읽게 해야 한다. 단, 도구가 어떤 파일을 실제로 읽는지는 공식 문서와 현재 세션의 지침 요약, 샘플 작업 결과로 확인해야 한다.

실무 적용 절차

1. 4.1에서 고른 첫 업무 주제가 여전히 작고 실제로 쓸 수 있는지 확인한다.
2. 실습용 경로와 실제 업무 경로를 분리한다.
3. 초기화 대상 경로에 기존 파일과 raw 자료가 있는지 확인한다.
4. 기존 자료가 있으면 덮어쓰지 말고 새 경로를 쓰거나 변경 이유를 기록한다.
5. raw/, wiki/, output/을 만든다.
6. 첫 자료 유형에 맞춰 작은 하위 폴더를 추가한다.
7. index.md에 제목, 핵심 질문, 먼저 읽을 문서, 원천 자료 위치, 확인 필요를 적는다.
8. log.md에 초기화 날짜, 작업, 변경 파일, 근거, 확인 필요를 남긴다.
9. AGENTS.md에 raw 보호, wiki 작성 위치, output 위치, 근거 표시, 확인일, 확인 필요, log 갱신 기준을 적는다.
10. Claude Code도 사용할 예정이면 CLAUDE.md 또는 현재 도구의 메모리 로드 방식을 확인한다.
11. 필수 경로와 규칙 문구가 모두 있는지 확인한다.
12. 첫 raw 자료를 넣기 전 민감 정보와 외부 LLM 전송 가능성을 점검한다.
13. 4.3에서 사용할 첫 질문 초안을 작성한다.

실무 템플릿

초기화 설계 카드

index.md 최소 골격

# 주제 위키 이름

## 이 위키의 질문
- 반복 업무를 어떤 기준으로 정리하고 다시 질문할 것인가?

## 먼저 읽을 문서
- 아직 없음

## 원천 자료 위치
- raw/

## 최근 산출물
- 아직 없음

## 확인 필요
- 첫 자료 후보
- 민감 정보 제외 기준
- 첫 질문의 출력 형식

log.md 최소 골격

# 처리 이력

| 날짜 | 작업 | 변경 파일 | 근거 | 확인 필요 |
| --- | --- | --- | --- | --- |
| YYYY-MM-DD | 위키 초기화 | raw/, wiki/, output/, index.md, log.md, AGENTS.md | 4.2 실습 | 첫 raw 자료 선정 |

AGENTS.md 최소 골격

# LLM위키 작업 규칙

## 기본 원칙
- raw/의 원천 파일은 승인 없이 고치지 않는다.
- 업무 지식 문서는 wiki/에 작성하고 원천 위치를 함께 적는다.
- 공유용 결과물은 output/에 두고 사용한 근거를 연결한다.
- 새 문서에는 확인일, 근거 위치, 남은 확인 항목을 포함한다.
- 근거가 약한 내용은 확정하지 말고 확인 필요로 둔다.
- 자료 추가, wiki 갱신, output 생성, 보류 이유는 log.md에 남긴다.

검증 체크리스트

좋은 질문과 사람이 확인할 질문

LLM에게 던질 질문

• 현재 위키 폴더를 기준으로 raw, wiki, output, index.md, log.md, AGENTS.md의 역할이 분리되어 있는지 점검해 주세요.
• 이 AGENTS.md가 원본 보호, 근거 표시, 확인 필요, log 갱신, 민감 정보 제한을 충분히 담고 있는지 검토해 주세요.
• 첫 주제와 자료 후보를 기준으로 index.md와 log.md 초기 내용을 제안해 주세요.
• 첫 raw 자료를 넣기 전에 확인해야 할 보안, 출처, 최신성, 도구 로드 항목을 체크리스트로 만들어 주세요.

사람이 확인할 질문

• 이 폴더는 4.1에서 정한 작은 업무 주제 하나를 위한 것인가?
• raw 원본과 wiki 정리본이 물리적으로 또는 문서상 분리되어 있는가?
• index.md만 보고 위키의 질문과 다음에 읽을 문서를 알 수 있는가?
• log.md만 보고 언제 무엇을 만들었고 무엇이 아직 확인 필요인지 알 수 있는가?
• AGENTS.md의 규칙은 실제 결과물에서 확인 가능한 문장인가?
• 첫 자료를 넣기 전 민감 정보와 외부 LLM 전송 여부를 확인했는가?

흔한 실패와 수정 방향

관련 문서

• 4장. 첫 번째 주제 위키 만들기: 4.1-4.3을 묶어 첫 업무 주제를 실제 위키로 만드는 흐름.
• 4.1 업무 주제 정하기: 4.2에서 초기화할 주제를 작게 줄이고 첫 자료 후보를 고른다.
• 4.3 첫 질문으로 방향 잡기: 만든 구조에 자료 범위, 목적, 출력 형식, 근거 요청이 들어간 첫 질문을 던진다.
• 2.1 지식이 쌓이는 세 층: raw, wiki, rules의 신뢰 경계를 설명한다.
• 2.2 좋은 폴더 구조 이해하기: index.md, log.md, output/의 역할을 확장한다.
• 5.1 자료를 넣기 전에 정할 기준: 실제 자료를 넣기 전 포함, 제외, 민감 정보 기준을 세운다.
• 6.2 답변의 근거 확인하기: 근거 표시 규칙이 실제 답변에서 지켜졌는지 검증한다.
• 8.2 정리와 감사 흐름 만들기: 출처, 최신성, 중복, 링크 기준을 유지하는지 점검한다.

한계와 완료 기준

1. 4.1에서 고른 작은 업무 주제를 위한 별도 위키 경로가 정해졌다.
2. 기존 파일을 덮어쓰지 않는 방식으로 raw/, wiki/, output/이 만들어졌다.
3. index.md에 위키 제목, 핵심 질문, 문서 목록 또는 확인 필요가 있다.
4. log.md에 초기화 작업과 변경 파일이 남았다.
5. AGENTS.md에 raw 원본 보존, wiki 작성 위치, output 위치, 근거와 확인일, 확인 필요 표시, 단정 금지 규칙이 있다.
6. 구조 점검에서 필수 경로 누락과 핵심 규칙 누락이 없다.
7. 첫 raw 자료를 넣기 전 민감 정보 기준과 출처 메타데이터 기준이 준비됐다.
8. 4.3에서 사용할 첫 질문에 자료 범위, 결정 목적, 출력 형식, 근거 표시, 확인 필요 표시를 넣을 준비가 됐다.