🚩 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 파일이 없을 경우, 에이전트는 아래 순서로 루트를 탐색한다.

현재 작업 디렉토리(CWD)에 00_Raw/ 폴더가 있으면 → CWD를 WIKI_ROOT로 사용
CWD의 상위 디렉토리까지 순차 탐색 (최대 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 삭제 → 아카이브로 변경)

4.7 KiB Raw Blame History