# 🚩 Wikification (위키화) 작전 지침

본 문서는 위키 문서 생성 및 데이터 정제 프로세스를 규정한다.  
경로는 모두 **워크스페이스 루트 기준 상대 경로**로 작성되며,  
Mac / Windows 환경 전환 시 `WIKI_ROOT` 설정만 변경한다.

---

## ⚙️ 환경 설정 (최초 1회 또는 환경 전환 시)

워크스페이스 루트(`WIKI_ROOT`)를 아래 중 하나의 방법으로 설정한다.

### 방법 A — `.wiki_env` 파일 (권장)

워크스페이스 루트에 `.wiki_env` 파일을 생성하고 아래 내용을 작성한다.  
에이전트는 실행 전 이 파일을 먼저 읽어 `WIKI_ROOT`를 확정한다.

```
# .wiki_env
# 현재 환경에 맞는 줄만 주석 해제한다.

# Mac
WIKI_ROOT=/Volumes/Data/project/Antigravity/Wiki

# Windows
# WIKI_ROOT=E:\Wiki\2nd
```

### 방법 B — 에이전트 자동 감지

`.wiki_env` 파일이 없을 경우, 에이전트는 아래 순서로 루트를 탐색한다.

1. 현재 작업 디렉토리(CWD)에 `00_Raw/` 폴더가 있으면 → CWD를 `WIKI_ROOT`로 사용
2. CWD의 상위 디렉토리까지 순차 탐색 (최대 3단계)
3. 탐색 실패 시 → 실행 중단하고 사용자에게 `WIKI_ROOT` 수동 입력 요청

> 에이전트는 경로를 확정한 뒤 반드시 사용자에게 아래 형식으로 보고한다.
> ```
> [환경 확인] WIKI_ROOT = /Volumes/Data/project/Antigravity/Wiki
> OS: macOS / Windows 중 하나 감지됨
> 계속 진행합니다.
> ```

---

## 📁 경로 구조 (WIKI_ROOT 기준 상대 경로)

| 역할 | 상대 경로 |
|------|-----------|
| Raw 원본 입력 | `{WIKI_ROOT}/00_Raw/` |
| 위키 출력 (기본) | `{WIKI_ROOT}/10_Wiki/Topics/` |
| 프로젝트 문서 | `{WIKI_ROOT}/10_Wiki/Projects/` |
| 의사결정 문서 | `{WIKI_ROOT}/10_Wiki/Decisions/` |
| 스킬/자동화 | `{WIKI_ROOT}/10_Wiki/Skills/` |
| 메타/그래프 | `{WIKI_ROOT}/20_Meta/` |
| 검토 대기 | `{WIKI_ROOT}/20_Meta/ReviewQueue/` |
| 처리 완료 Raw | `{WIKI_ROOT}/00_Raw/_archived/` |

> 경로 구분자는 OS에 따라 자동으로 처리한다.  
> 에이전트는 `os.path.join()` 또는 동등한 방식으로 경로를 조합하며,  
> `/`와 `\`를 하드코딩하지 않는다.

---

## 🛠️ 위키화 프로세스

### 트리거
다음 중 하나의 명령이 들어오면 실행한다.
- "위키화해"
- "위키화 작업 진행해"
- "wiki화 해줘"
- "P-Reinforce 실행"

### 실행 순서

```
[STEP 0] WIKI_ROOT 확정
  → .wiki_env 읽기 → 없으면 자동 탐색 → 없으면 사용자 입력 요청
  → 경로 존재 여부 확인 (00_Raw/, 10_Wiki/ 폴더 유무)

[STEP 1] Raw 파일 목록 수집
  → {WIKI_ROOT}/00_Raw/ 의 .md 파일 전체 목록 출력
  → _archived/ 폴더는 제외한다

[STEP 2] p-reinforce 스킬 규칙에 따라 각 파일 처리
  → CREATE / UPDATE / MERGE / QUARANTINE / REJECT 판단
  → 출력 경로는 분류 규칙에 따라 결정 (기본: 10_Wiki/Topics/)

[STEP 3] 처리 완료된 Raw 파일 이동
  → {WIKI_ROOT}/00_Raw/_archived/YYYY-MM-DD/ 폴더로 이동
  → 원본 파일은 삭제하지 않는다 (p-reinforce 원칙: Raw 수정·삭제 금지)

[STEP 4] 실행 결과 보고
  → 생성/업데이트/보류/거부 문서 목록
  → 이동된 Raw 파일 목록
  → 사용자 확인이 필요한 항목
```

> ⚠️ **Raw 파일 영구 삭제 금지**  
> 이전 버전의 지침에 "위키 생성 완료 후 Raw 파일 영구 삭제"가 명시되어 있었으나,  
> 이는 `p-reinforce` 원칙(00_Raw 수정 금지)과 충돌한다.  
> 처리 완료 파일은 `_archived/` 폴더로 **이동**하며 삭제하지 않는다.

---

## 📚 작성 원칙

`p-reinforce` 스킬(`{WIKI_ROOT}/10_Wiki/Skills/p_reinforce.md`)의 규칙 전체를 준수한다.  
해당 파일이 없을 경우 에이전트는 실행 전 사용자에게 경고한다.

핵심 원칙 요약:
- 새 문서 생성 전 기존 문서와의 유사도를 반드시 확인한다
- 하나의 핵심 개념에는 하나의 대표 문서를 유지한다
- 출처 신뢰도(S/A/B/C/D)를 모든 문서에 부여한다
- 충돌 내용은 즉시 덮어쓰지 않고 ReviewQueue에 보류한다

---

## 🔄 환경 전환 체크리스트 (Mac ↔ Windows)

환경을 바꿀 때 아래 항목만 확인하면 된다.

```
□ .wiki_env 파일의 WIKI_ROOT 경로 수정
□ 새 환경에서 WIKI_ROOT 폴더가 실제로 마운트/접근 가능한지 확인
□ 에이전트 실행 후 "[환경 확인]" 보고 메시지로 경로 검증
```

나머지 경로(00_Raw, 10_Wiki 등)는 모두 상대 경로이므로 수정 불필요.

---

**승인인**: Antigravity AI 지휘통제실 🫡  
**최종 업데이트**: 2026-05-07 (워크스페이스 상대 경로 정책 적용, Raw 삭제 → 아카이브로 변경)
