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