LLM 위키 synthesis 완벽 가이드 (2026) — /wiki-synthesize로 두 개념 교차 분석 페이지 자동 생성하기
위키 페이지가 50개를 넘으면 개별 페이지 정리보다 페이지 간 "교차 통찰"이 더 중요해집니다. synthesis는 두 페이지를 합쳤을 때만 보이는 결론을 담는 페이지입니다. 본인 vault 76 페이지에서 자동 도출된 synthesis 5개(15:1 비율)와 공현 신호 6가지 점수표, /wiki-synthesize skill 사용법, 실패 패턴 3건을 정리합니다.
검증 환경: macOS Sequoia 15.x / Claude Code / vault 76 페이지 → synthesis 5개 / 마지막 업데이트: 2026-05-21
이 글에서 배우는 것: 위키 페이지 수가 늘어나면 어느 순간 "페이지 하나로는 완결되지 않는 통찰"이 생깁니다. A 페이지도 B 페이지도 단독으로 말하지 못하지만, 두 페이지를 같이 봤을 때만 떠오르는 결론입니다. 이 결론을 담는 페이지가 synthesis입니다. 본인은 76 페이지 vault에서 /wiki-synthesize skill로 synthesis 5개를 자동 도출했고(정식 페이지 15개당 synthesis 1개 비율), 각 페이지는 공현 신호 6가지 점수표에서 5점 이상을 얻은 페어입니다. 이 글은 synthesis 언제 만드는가·4섹션 템플릿·실제 사례 5건·실패 패턴 3건을 정리합니다.
📚 이 글은 LLM 위키 만들기 완벽 가이드 (418) 시리즈의 마지막 편(5편) 입니다. 이전 4편에서 셋업·시각화·언어 정책·distillation을 다뤘고, 이 편에서 시리즈를 마무리합니다.
요약 (Quick Answer)
| 항목 | 결과 |
|---|---|
| synthesis란? | 두 페이지를 합쳐 둘 다 단독으로 말하지 못하는 통찰을 만드는 페이지 |
| 시점 | 정식 페이지 50개를 넘은 후 |
| 추출 점수 | 공현 신호 합계 5점 이상 |
| 실행 | /wiki-synthesize skill 한 줄 |
| 본인 결과 | 76 페이지에서 synthesis 5개 자동 도출 |
| 권장 비율 | 정식 페이지 15개당 synthesis 1개 |
3줄 결론:
- synthesis 페이지는 두 개념을 합쳤을 때만 보이는 결론을 본문으로 가집니다.
- 공현이 높고 카테고리가 다른 페어가 가장 좋은 후보입니다.
/wiki-synthesize는 자동으로 후보를 찾고 초안을 만듭니다 — 본인이 다듬으세요.
synthesis란?
synthesis는 두 개 이상의 기존 페이지를 합쳐 각각의 페이지가 단독으로는 말하지 않는 통찰을 만드는 페이지입니다.
일반 페이지 vs synthesis 페이지
| 페이지 종류 | 역할 |
|---|---|
concepts/ |
개념·이론 정의 |
entities/ |
인물·도구·회사 |
skills/ |
실전 노하우 |
references/ |
외부 자료 요약 |
synthesis/ |
두 개념의 교차 결론 |
synthesis의 본질은 "묶기"가 아니라 "발견" 입니다. 두 페이지를 물리적으로 이어붙이는 것은 synthesis가 아닙니다. 각 페이지를 단독으로 읽었을 때와 두 페이지를 함께 읽었을 때 결론이 달라지는 순간, 그 결론을 담는 것이 synthesis입니다. 예를 들어 "1-1 미팅"과 "핵심 인재 유지" 페이지는 각각 단독으로도 완결적이지만, 두 페이지를 같이 봤을 때만 "48시간 골든타임은 정기 1-1 없이는 불가능하다"는 결론이 드러납니다. 이 결론은 어느 한쪽 페이지에도 없습니다. 그래서 synthesis 페이지는 "발견의 기록" 이며, 위키가 단순 정보 저장고에서 사고의 도구로 진화하는 지점입니다. Karpathy의 raw → distill → wiki 패턴에서 wiki가 graph여야 하는 이유가 여기에 있습니다.
synthesis가 단순히 두 페이지의 요약이면 의미가 없습니다. "A에도 B에도 없는, 둘을 같이 봤을 때만 떠오르는 결론"이 본문이어야 합니다.
언제 synthesis를 만드는가 — 공현 신호 6가지
synthesis 후보를 찾는 것은 감이 아니라 정량 점수로 결정해야 지속 가능합니다. 감으로 만들면 몇 개 만들다 지치고 편향된 페어만 골라 vault 전체의 균형이 무너집니다. 본인은 6가지 신호를 가중치와 함께 점수화하고, 합계 5점 이상만 synthesis 후보로 승격시킵니다. 가장 강한 신호는 3개 이상 다른 페이지에서 함께 언급되는 공현(+3) 과 모순 존재(+2) 입니다. 특히 모순 페어는 대부분 놓치기 쉬운데, 두 페이지가 서로 반대되는 주장을 할 때 그 긴장을 정리한 synthesis가 가장 강력한 사고 자산이 됩니다. /wiki-synthesize skill은 이 6가지 신호를 자동 계산하므로 사용자는 후보 판단이 아닌 초안 다듬기에만 시간을 씁니다.
본인은 다음 신호를 기준으로 synthesis 후보를 찾습니다.
| 신호 | 가중치 |
|---|---|
| 두 페이지가 3개 이상 다른 페이지에서 함께 언급 (공현) | +3 |
| 두 페이지가 다른 카테고리 (예: concepts × skills) | +2 |
| 두 페이지 중 하나가 hub (incoming link 8개 이상) | +1 |
| 두 페이지가 공유 태그 2개 이상 | +2 |
| 명백한 모순이 존재 | +2 |
| 본인이 일주일 안에 두 페이지를 같이 본 적 있음 | +2 |
합계 5점 이상이면 synthesis 페이지 후보입니다.
synthesis 페이지 4섹션 템플릿
# Concept A × Concept B
## The Connection
두 개념을 묶어야 하는 이유. 둘이 어떻게 만나는가.
## Where They Co-occur
공현하는 페이지·맥락 나열.
## Cross-cutting Insight
이 페이지의 핵심. 둘을 같이 봤을 때만 보이는 결론.
A 페이지나 B 페이지 단독으로는 절대 말할 수 없는 내용.
## Tensions and Trade-offs
두 개념이 충돌하는 지점. A를 적용하면 B가 약해지는 경우.
## Open Questions
synthesis가 드러낸 미해결 질문.가장 중요: Cross-cutting Insight 섹션이 비어 있거나 약하면 synthesis 페이지로서 가치가 없습니다. 이 섹션이 페이지의 존재 이유입니다.
본인 vault 실제 synthesis 5개
1. 리더십과 피드백 × 원온원 미팅
Connection: 1-1 미팅은 피드백의 컨테이너, 피드백은 1-1의 콘텐츠.
Cross-cutting Insight: 침묵 리더십이 가장 나쁜 이유는 1-1을 형식적으로 운영하기 때문입니다. 1-1 빈도와 피드백 품질은 48시간 골든타임으로 직결됩니다.
→ 두 페이지를 단독으로 봐서는 "왜 1-1 부실 = 도미노 퇴사인가"를 알 수 없습니다. 합쳐서만 보입니다.
2. Context Engineering × Claude Code
Connection: Claude Code는 context engineering의 운영 OS.
Cross-cutting Insight: CLAUDE.md·anchor comment·세션 분리·서브에이전트 위임은 개념(context engineering)이 아니라 구체적 도구 패턴(Claude Code)으로 살아있습니다. 도구를 바꿔도 패턴은 유지됩니다.
3. 원온원 미팅 × 핵심 인재 유지
Connection: 1-1 부실 = 도미노 퇴사. 핵심 인재의 퇴사 신호는 1-1에서 먼저 드러납니다.
Cross-cutting Insight: 48시간 골든타임은 정기 1-1을 통해서만 유효합니다. 1-1 없이는 퇴사 신호를 감지할 시점이 없습니다.
4. Vibe Coding × Claude Code
Connection: Karpathy의 "농담"을 운영 가능 표준으로 만든 도구-패러다임 체인.
Cross-cutting Insight: vibe coding은 도구 의존적입니다. Claude Code 없이는 vibe coding이 단순 자유 채팅이 됩니다. 패러다임의 가치는 도구의 완성도와 함께 검증됩니다.
5. 개발자 레벨링 × 리더십과 피드백
Connection: D4 진입은 평가와 피드백 전달 방식의 동시 전환점.
Cross-cutting Insight: D3 → D4 전환은 본인 평가만으로는 불가능합니다. 리더의 피드백 + 매니저의 평가가 동시에 전환되어야 D4 진입이 실제 일어납니다. 한쪽만 변하면 단순 호칭 변경에 그칩니다.
/wiki-synthesize skill 사용법
위 5개 synthesis는 수작업이 아니라 skill로 자동 도출됐습니다.
/wiki-synthesizeskill이 자동으로 하는 일
- 모든 페이지의 wikilink·태그·카테고리 스캔
- 공현 행렬 계산 (어느 두 페이지가 같이 자주 언급되는지)
- 기존 synthesis 페이지가 다루는 페어 제외
- 점수 상위 5개 페어 추출
- 각 페어마다 synthesis 페이지 초안 작성
- A·B 페이지에 새 synthesis로 가는 wikilink 추가
소요 시간: 2~5분.
결과 확인
생성된 synthesis 페이지는 wiki/synthesis/ 폴더에 들어갑니다. 본인은 AI 초안을 그대로 두지 않고 한 번씩 손으로 다듬습니다. AI가 만든 Cross-cutting Insight가 약하면 본인의 실제 경험으로 교체합니다.
실패 패턴 3건
실패 1. synthesis = 두 페이지 요약
AI가 만든 초기 synthesis 일부는 단순히 A와 B의 본문을 이어붙인 형태였습니다. Cross-cutting Insight가 "A는 X를 다루고 B는 Y를 다룹니다" 수준.
해결: 본인이 직접 Cross-cutting Insight를 다시 씁니다. AI에게 "둘을 같이 봐야만 보이는 게 뭔지" 명시적으로 물으면 더 나아집니다.
실패 2. 공현은 높은데 의미 없는 페어
claude-code와 매니지먼트는 본인 vault에서 자주 공현하지만, 합쳐서 통찰이 안 나옵니다 (둘 사이 직접 연관 약함).
해결: 점수가 높아도 본인이 직관적으로 "이건 아니다" 싶으면 만들지 않습니다. skill이 추천해도 거부 가능합니다.
실패 3. 너무 많은 synthesis
위키 페이지 100개에 synthesis 50개를 만들면 synthesis 자체가 노이즈가 됩니다.
해결: 본인 기준 정식 페이지 15개당 synthesis 1개가 적정. 76 페이지에 5개 synthesis = 15:1 비율.
자주 발생하는 문제
문제 1. skill이 후보를 못 찾는다
vault 페이지 수가 50개 미만이거나 wikilink가 부족할 때 발생합니다. 먼저 /cross-linker로 wikilink를 채운 뒤 재실행하세요.
문제 2. Cross-cutting Insight가 매번 비슷하다
가장 흔한 실수: AI가 같은 패턴 문장("두 개념은 서로 보완합니다")을 반복 생성. 본인 경험·실패 사례·구체 수치를 1~2개 넣으면 즉시 개선됩니다.
문제 3. synthesis 페이지가 wikilink 고아가 된다
skill은 자동으로 backlink를 추가하지만 누락될 수 있습니다. /wiki-lint로 점검하고 누락된 backlink를 수동 추가하세요.
문제 4. 모순 마커가 있는 페어가 후보에서 빠진다
기본 모드는 공현 중심이라 모순 페어를 놓칠 수 있습니다. CLAUDE.md에 synthesis 후보에 contradicts 페어 우선 포함 규칙을 추가하면 됩니다.
자주 묻는 질문 (FAQ)
Q. synthesis는 왜 별도 카테고리인가요?
A. concepts/와 synthesis/의 차이는 단일 자료에서 나온 개념 vs 여러 개념의 교차입니다. 카테고리가 분리되어야 위키 사용자가 "이건 합성된 견해다"를 알 수 있습니다.
Q. 3-way synthesis (A × B × C)도 가능한가요?
A. 가능하지만 드뭅니다. 세 개념이 진짜 삼각형 관계여야 의미가 있습니다. 본인 vault에는 아직 3-way가 없습니다.
Q. synthesis 페이지에도 frontmatter가 필요한가요?
A. 네. 일반 페이지와 동일합니다. 다만 provenance.inferred가 0.6~0.7로 높은 편입니다 — synthesis는 본질적으로 추론이기 때문입니다.
Q. 모순(contradicts) 페어가 가장 가치 있는 synthesis 후보인가요?
A. 네. 두 페이지가 서로 모순될 때, synthesis 페이지에서 양쪽 주장을 명시하고 어느 조건에서 어느 쪽이 맞는지 정리하면 강력한 자료가 됩니다.
Q. Claude·Codex·Gemini 모두 synthesis를 잘 만드나요?
A. 세 도구 모두 가능하지만 Claude가 Cross-cutting Insight 품질이 가장 좋았습니다. 장문 컨텍스트로 두 페이지를 동시에 보고 추론하는 능력 차이로 보입니다. Codex·Gemini도 충분히 쓸 만하며, 본인이 다듬으면 차이가 거의 사라집니다.
Q. synthesis를 한 번에 몇 개 만들어야 하나요?
A. 한 번에 3~5개가 적정입니다. 그 이상 만들면 본인이 다듬을 시간이 부족해 AI 초안 그대로 방치됩니다.
Q. 시간이 지나면 synthesis도 stale 해지나요?
A. 네. 분기 1회 /wiki-lint로 점검하고, 원본 페이지가 크게 바뀌었다면 synthesis도 재생성하세요.
LLM 위키 시리즈 완결 (5편)
약 1년간 chan-wiki를 운영하며 정착시킨 패턴을 5편으로 정리했습니다.
| # | 편 | 핵심 자산 | 링크 |
|---|---|---|---|
| 1 | 본편 — LLM 위키 만들기 | 30분 셋업, 3종 CLI 비교 | 418 |
| 2 | Graph View 색상 그룹 | Tableau 10 팔레트, 자동화 skill | 419 |
| 3 | 한국어·영어 자료 동시 처리 | CLAUDE.md 4줄 언어 정책 | 420 |
| 4 | distillation 노하우 | 2,470 → 76 (32배 압축), 5원칙 | 421 |
| 5 | synthesis 교차 분석 (이 글) | 공현 신호 6가지, 15:1 비율 | 현재 글 |
이 시리즈의 핵심 메트릭 (누적)
- 처리한 raw 자료: 2,470개
- 최종 위키 페이지: 76개 (32배 압축)
- 자동 도출된 synthesis: 5개 (15:1 비율)
- 주간 운영 시간: 약 15~20분
- 검증 기간: 약 1년 (2025~2026)
- 적용 도구: Claude Code / Codex CLI / Gemini CLI
- 호환 OS: macOS / Windows
함께 읽으면 좋은 글
📚 chan7ee 개발 환경 셋팅 클러스터
- Colima 사용법 완벽 가이드 (415) — 개발 환경 컨테이너
- Ollama에 Hugging Face GGUF 모델 등록 (411) — 로컬 LLM
- macOS Docker에서 GPU 사용 가능한가? (410) — Apple Silicon GPU
- Neovim 0.12 treesitter 오류 해결 (신규) — Neovim 환경
다음 여정
MCP 통합·자동 cross-link·다중 vault 동기화 등 더 깊은 주제가 필요하다면 댓글로 남겨주세요. 시리즈의 후속 시리즈(LLM Wiki Advanced)로 이어질 수 있습니다.
댓글