Antigravity Agent
135 lines
4.7 KiB
Markdown
135 lines
4.7 KiB
Markdown
# 🚩 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 삭제 → 아카이브로 변경)
|