← ガイドサイト構築 ssot-search v2(RAG検索) →

10 知識の保存先の使い分け(SSOT層) — 判断の経緯と生きタスクの置き場所

SSOT運用で「この知識、どこに保存すればいいのか?」問題が起きるのは、Claude Code環境だけではない。Vault内部にも複数の保存先があり、使い分けを誤ると知識が埋もれるか、真実のソースが増殖する。本章ではVault内部の代表的な2層と、Claude Code機能側との境界を整理する。

memory・rules・hooks(Claude Code機能ベースの3層)の使い分けは claude-code-guide「知識の保存先の使い分け」 を参照。


Vault内部の2層

層 役割 向いているもの 鉄則
01_DECISIONS 技術的決定の経緯(なぜそうしたか・複数案比較・根本原因) 設計判断・事故分析・再検討条件 「経緯」のみ。成果物の正典は別場所へ
バックログ 生きタスクの唯一の正典 未完了タスク([ ])・完了履歴([x]) handoff等へ「次のタスク」を転記しない(完了済みが残り続ける事故防止)

01_DECISIONS — 「なぜそう決めたか」の正典

バックログ — タスクはここだけを見る


判断ゲート照合表(どこに何を書くか)

記録する前に自問する順番:

自問 はいの行き先
能力・方針・構造の話か? 00_SYSTEM(システム正典)
なぜそう決めたか、理由の経緯があるか? 01_DECISIONS
個人の失敗の直し方か? memory(Claude Code側)
生きているタスクか? バックログ
外部サービスの調査で時系列で陳腐化するか? 30_RESEARCH(スナップショット扱い)

判断ゲートの正典は層1ルール(毎セッション読込の共有ルール)。本章は照合表であり、ここが正典ではない。


ありがちな失敗

💡 一言でいうと: 「なぜ」は01_DECISIONS、「今やること」はバックログ。そして「ガイドは正典の写しを作らない」——リンクで繋ぐだけにするのが、更新漏れを防ぐ一番の防御。