---
name: fireauto-wiki-guide
description: >
  프로젝트 Wiki(.claude/wiki/)를 활용하세요. 패턴, 주의사항, 결정사항을
  Wiki에 기록하고 검색하세요. wiki-read, wiki-write, wiki-search, wiki-index
  MCP 도구를 능동적으로 사용하세요.
  "wiki", "지식 페이지", "패턴 기록", "주의사항 추가", "결정 기록" 등에 트리거.
---

# Wiki 관리 가이드

`.claude/wiki/` 디렉토리는 프로젝트의 상세 지식 베이스예요.
CLAUDE.md를 작게 유지하면서, 상세 지식은 Wiki에 저장해요.

---

## 언제 트리거되나요?

다음 상황에서 이 가이드를 참고하세요:

- **Wiki 관련**: "wiki", "지식 페이지", "위키"
- **기록 요청**: "패턴 기록", "주의사항 추가", "결정 기록"
- **지식 검색**: "이전에 뭐라고 했지?", "패턴 찾아줘"

---

## 페이지 구조

| 파일 | 용도 |
|------|------|
| `patterns.md` | 코딩 패턴, 모범 사례 |
| `gotchas.md` | 주의사항, 삽질 기록 |
| `decisions.md` | 설계 결정 + 이유 |
| `skills-catalog.md` | 자동 생성된 스킬 목록 |
| `retrospective.md` | 세션별 복기 기록 |
| `index.md` | 자동 생성 목록 |

---

## 능동적 사용

### 패턴 발견 시

코드에서 반복되는 패턴을 발견하면 `wiki-write` MCP 도구로 `patterns.md`를 업데이트하세요.

```
📝 패턴 기록: {패턴명}
   {패턴 설명}
```

### 삽질 발견 시

버그나 삽질을 발견하면 `wiki-write` MCP 도구로 `gotchas.md`를 업데이트하세요.

```
⚠️ 주의사항 기록: {주의사항}
   원인: {원인}
   해결: {해결법}
```

### 설계 결정 시

설계 결정을 내리면 `wiki-write` MCP 도구로 `decisions.md`를 업데이트하세요.

```
📋 결정 기록: {결정사항}
   이유: {이유}
   대안: {고려한 대안}
```

### 지식 검색 시

관련 지식이 필요하면 `wiki-search` MCP 도구로 검색하세요.

---

## CLAUDE.md와의 관계

- CLAUDE.md는 **80줄 이내**로 유지
- 상세 지식은 Wiki로 위임: `@.claude/wiki/patterns.md` 형태로 참조
- "이 줄을 제거하면 Claude가 실수할까?" — 아니면 Wiki로 이동

---

## 톤 & 스타일

- **문체**: 토스체 — 친근하고 간결하게
- **분량**: 핵심만 짧게. 장황하게 설명하지 않아요
- **행동 유도**: 기록 후 확인 메시지를 보여줘요