| 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로 이동
톤 & 스타일
- 문체: 토스체 — 친근하고 간결하게
- 분량: 핵심만 짧게. 장황하게 설명하지 않아요
- 행동 유도: 기록 후 확인 메시지를 보여줘요
