The Wiki — ページ設計の原則
The Wiki — ページ設計の原則
LLM Wiki の 第2層 The Wiki — 編集済み Markdown ページ群 — の設計原則です。RAG の「倉庫」に未整理のまま放り込むのではなく、図書館の1冊1冊として整えたページを作ります。
4つの基本方針
| 方針 | 説明 | LLM Wiki との関係 |
|---|---|---|
| 1 ページ = 1 テーマ | 独立した複数トピックを詰め込まない | Wiki の概念ページ・手順ページとして独立 |
| 見出しで区切る | ## 単位で整理。Query 時の深掘り単位になる |
index から辿った先のチャンク |
| 事実と手順を分ける | 「とは何か」と「どうするか」を混ぜない | 概念ページ vs 手順ページの分離 |
| 陳腐化を想定する | 日付・バージョンは更新しやすい箇所に | Lint で定期見直しの対象にする |
テーマ分割の判断（Ingest 前の検討）
次のいずれかに当てはまるなら 別ページ を検討してください。
- タイトルに「と」「および」が入り、独立した 2 つの話題になっている
- 見出しが 5 つ以上で、それぞれ別の FAQ や手順になっている
- 読者層が明確に異なる
- 1 本が長く、見出し単位の Query で拾いにくい
LLM Wiki では資料 1 件の Ingest が 10〜15 ページ に影響しうるとされます。iknow でも大きな Raw sources を取り込むときは、テーマ分割を先に設計してください。
見出し設計のコツ（Query 向け）
- 見出し名に 検索キーワード を含める
- 1 見出しは 1 つの質問に答える 分量に収める
- 手順書は
## 前提→## 手順→## トラブル時の流れを固定する
良い例・悪い例
悪い例（倉庫的な詰め込み）
タイトル「ログインと退会とパスワード」— 3 テーマが 1 ページに混在。Query で不要な節まで返る。
良い例（図書館的な分割）
| ページ | テーマ | 関連リンク |
|---|---|---|
| ログイン手順 | ログイン方法と SSO | ↔ パスワード再設定 |
| パスワード再設定 | 忘れたときの復旧 | ↔ ログイン手順 |
| アカウント退会 | 退会条件と手順 | ↔ データ保持ポリシー |
次のステップ
- メタ情報（index 相当）→ No.12.2
- 本文形式 → No.1.3
- 取り込み手順 → No.13.1 Ingest