kb

kb — バンドル

kb-* ファミリーのハブです。用語、共有リファレンス、ルーティングを担います。ナレッジは蓄積されます。一度コンパイルしたら、最新の状態を保ち、クエリごとに再導出しません。バンドルは変更せず、変更を行うスキルに振り分けます。

主要用語

references/glossary.md で用語を定義しています。ルーティングの前に、最低限、Bundle、Ingest、Progressive disclosure、Trust model（trust-model.md を参照）を確認してください。

唯一の厳格なルール

すべての予約されていない .md ファイルに、解析可能な YAML フロントマターと空ではない type がある場合に限り、バンドルは準拠しています。それ以外はすべて柔軟なガイダンスです。利用側は、任意フィールドの欠落、未知のタイプ、壊れたリンクを許容しなければなりません。これらを理由にバンドルを拒否してはいけません。完全なルールについては、references/SPEC.md §11 を参照してください。

spec/types.md のドメイン部分は、プロデューサーが選択する、随時変化する語彙であり、検証用の列挙型ではありません。ワークフローの規約である Reference と Spec Section は維持してください。ドメインの種類は少数から始め、ドメインに永続的な新しいエンティティの種類が現れたら、kb-ingest または kb-document を通じて発展させてください。スキーマのドリフトの検出には kb-lint を使用してください。

適切なスキルへのルーティング

ユーザーの目的	使用するスキル
新しいバンドルを作成する	kb-init
ソース（メモ、文字起こし、PDF、画像、URL）を記録、取り込み、ファイル化、または処理する	kb-ingest
リポジトリを文書化する、そのアーキテクチャやワークフローを説明する、またはコード変更後にナレッジを更新する	kb-document
バンドルにどのようなナレッジがあるか尋ねる、情報を調べる、関連性を探る	kb-query
バンドルのヘルスチェックを行う（ドリフト、孤立項目、矛盾、準拠状況）	kb-lint
バンドルをグラフとして表示する	kb-visualize

knowledge/ バンドルが存在し、現在のタスクに役立つ場合は、ユーザーから明示的にナレッジについて質問されていない場合でも、ゼロから回答する前に kb-query を通じて確認してください。

共有リファレンス（信頼できる唯一の情報源）

すべての kb-* スキルは、内容を繰り返し記述する代わりにこれらを参照し、ファミリー全体で一貫性を保ちます。

• references/SPEC.md — OKF v0.2。改変せずにベンダー化されています。
• references/version-profile.md — v0.2 の本番ルールと v0.1 の互換性ルール。すべての書き込みスキルは、バンドルを変更する前にこれを読みます。
• references/glossary.md — 先頭語と定義。
• references/trust-model.md — メンテナンスルール。
• templates/ — concept.md、index.md、log.md のスターター。
• example-bundle/ — 準拠した小さなバンドル。手順を示す例であり、kb-init がコピーするシードです。