# LLM Wiki 사용법

## 전체 흐름

```text
제가 raw/에 원본 투입
        ↓
AI(Gemini CLI)가 wiki/로 컴파일
        ↓
wiki/ 지식을 조합해서 output/ 결과물 생성
```

## 1단계: 원본 수집

raw/의 적절한 하위 폴더에 원본을 넣는다.

| 수집한 것 | 넣는 곳 |
|---|---|
| 웹 아티클, 블로그 | `raw/articles/` |
| 도서 | `raw/books/` |
| 논문 | `raw/papers/` |
| 순간 떠오른 아이디어 | `raw/ideas/` |
| 업무 기록, 암묵지 | `raw/work/` |

- 웹 클리퍼 + Templater로 메타데이터 포함 수집 가능
- 형식은 자유. 마크다운 권장
- **한번 넣은 원본은 수정하지 않는다**

## 2단계: Gemini CLI로 위키 컴파일

Gemini CLI는 이 프로젝트에서 다음 구조를 사용한다.

- 지속 컨텍스트: `GEMINI.md`, `raw/GEMINI.md`, `wiki/GEMINI.md`, `output/GEMINI.md`
- 반복 명령: `.gemini/commands/wiki/*.toml`
- 스킬: `.gemini/skills/llm-wiki-operator/`
- 서브에이전트: `.gemini/agents/*.md`
- 훅: `.gemini/settings.json`, `.gemini/hooks/*.cjs`

### 기본 사용 예시

- 자연어로 직접 요청:
  - `raw/articles/문서정리방법론.md 읽고 wiki에 컴파일해줘`
  - `raw/에서 '유한요소법 모델링' 관련 문서들 찾아서 wiki 페이지로 정리해줘`
  - `raw/books/수치해석.md 내용을 기존 [[해석 모델링 원칙]] 페이지에 반영해줘`

- Gemini CLI 커스텀 명령 사용:
  - `/wiki:compile raw/articles/문서정리방법론.md`
  - `/wiki:ask 해석 모델링 원칙에 대해 내 볼트에 뭐가 있어?`
  - `/wiki:connect 유한요소법 모델링과 다물리해석 문서`
  - `/wiki:draft 문제해결 관련 개념을 모아 output/에 문제해결 101 초안 작성`

### AI가 자동으로 지키도록 설정된 것

- `raw/` 수정 차단 훅
- `wiki/` 수정 시 `index.md`, `log.md` 갱신 리마인더
- wiki 페이지 frontmatter 규칙
- `[[wikilink]]` 내부 링크 규칙

## 3단계: 지식 활용

### 질문하기

> `해석 모델링 원칙에 대해 내 볼트에 뭐가 있어?`

AI는 이 순서로 찾는다.

1. `wiki/index.md`
2. 관련 `wiki/` 페이지
3. `raw/`는 마지막 수단

### 문서 연계·융합 요청

> `유한요소법 모델링과 다물리해석 문서를 연계해서 공통 원칙을 정리해줘`

> `내 볼트에서 수치해석 안정성과 모델 검증 관련 지식을 찾고, 서로 보완되는 내용을 융합해줘`

### 결과물 생성

> `wiki/에서 문제해결 관련 개념들 모아서 output/에 문제해결 101 초안 만들어줘`

> `wiki/에서 문서 정리와 지식 활용 관련 내용 정리해서 가이드 초안 만들어줘`

## 4단계: 설정 변경 후 새로고침

Gemini CLI 인터랙티브 세션 안에서 아래 명령으로 구조 변경을 반영한다.

- `/memory refresh` 또는 `/memory show`
- `/commands reload`
- `/skills reload`
- `/agents reload`
- `/hooks panel`

터미널에서 빠르게 확인하려면 다음 명령도 쓸 수 있다.

- `gemini --version`
- `gemini skills list`

## 주의사항

- **raw/ 파일은 절대 수정하지 않는다** — 원본 보존이 핵심
- 위키 페이지가 이미 있으면 새로 만들지 말고 **업데이트**
- AI에게 요청할 때 대상 문서, 원하는 정리 기준, 출력 형식을 구체적으로 말할수록 좋다
- 문서는 **분류 → 요약 → 연결 → 융합 → 재사용** 순서로 관리한다