kb-management

KB の管理

ナレッジベース（kb/）は、プロジェクトの永続的な記憶です。すべてのエージェントがコンテキストを得るために参照します。このスキルでは、ナレッジベースを適切に維持する方法を説明します。

レイヤー

Canon：物語で確定した事実です。章が公開または確定されると、その章で確立された事実は正史となります。正史に反すると、読者の信頼を損ないます。

Wiki：情報をまとめたリファレンスページです。魔法体系の仕組み、キャラクター間の関係、派閥間の政治などを扱います。物語の展開に合わせて進化する、生きたドキュメントです。

Styles：文章のサンプルから作成した、文体の参考ファイルです。ライターエージェントと批評エージェントは、文体の一貫性を保つためにこれらを参照します。

Vocab：物語で使う用語、別名、使用しない語の正式な一覧です。プロジェクト全体の用語は kb/vocab.md に、特定の領域の用語は、それが適用される領域の隣に置きます。例：kb/world/vocab.md。

Issues：複数の章にまたがる、追跡対象の執筆上の問題（繰り返し現れる癖、ペース配分のパターン、連続性の誤りなど）です。story-memory スキルを参照してください。

ページのルール

1つのドキュメントにつき1つの概念

各ドキュメントでは、1つのまとまったトピック（1人のキャラクター、1つの場所、1つのシステムなど）を扱います。無関係なトピックを2つ扱っている場合は、分割してください。2つのドキュメントが同じ内容を異なる視点から説明している場合は、統合するか、相互参照を追加してください。

ファイル名には、作成時期（session-3-notes.md）ではなく、説明対象（fire-magic.md、protagonist.md）を使います。

構成

kb/
  characters/
    <name>.md              # one file per character
  vocab.md                 # project-wide canonical terms
  world/
    vocab.md               # worldbuilding terms when needed
    <topic>.md             # locations, factions, systems
    <domain>/
      vocab.md             # subdomain terms when needed
      <topic>.md           # nest when a domain has many pages
  timeline/
    <arc-or-period>.md     # chronological entries
  canon/
    <chapter-or-arc>.md    # hard facts per chapter/arc
  styles/
    <style-name>.md        # voice reference files
  issues/
    <issue-name>.md        # tracked writing problems

プロジェクトの AGENTS.md でカスタマイズされている場合があります。まず、これを読んでください。

リンク

相対パスを使って関連ページにリンクします。内容を重複させずに相互参照し、各概念の情報源を1つに保ちます。キャラクターのページから、そのキャラクターの住まいの場所ページや、キャラクターの軌跡を記した年表の項目などにリンクします。

読みやすさ

単独でも読めるページにします。

• 自己完結：読者が先に別のページを3つも読まなくて済むよう、十分なコンテキストを記載します
• ざっと読める：見出し、箇条書き、表を使います。用語を初めて使うときは太字にします。
• 具体的：具体的な引用、章への参照、場面の出典を記載します
• 最新：物語の内容によって情報が否定されたり、拡張されたりしたら更新します

Vocab ページ

エージェント間で用語の統一が重要な場合は、vocab ページを使います。対象には、魔法の名称、派閥の呼称、地名、称号、関係性の呼称、創作語、物語内で繰り返し使われる表現、プロジェクト独自の意味を持つジャンル用語などがあります。

各項目には、以下を含めます。

• 正式名称：エージェントが使うべき表記
• 定義：曖昧さが生じそうな場合は、その用語が何を指さないのかも含め、1〜3文で説明します
• 別名：作者、キャラクター、草稿、古い kb ページで実際に使われている名称
• 出典：その用法が確立または決定された場所

食い違いは早めに解決します。2つの用語が同じものを指しているように見える場合は、作者と相談して正式な表記を選ぶか、両方を黙って引き継がず、レポートでその点を指摘してください。

新規作成と更新の使い分け

他のエージェントが参照できる程度に概念が確定したら、新しいページを作成します。まだストーリーの計画段階にあるものについては、ページを作成しないでください。

新しい章でその概念に関する事実が確立されたとき、作者の決定によって内容が変わったとき、またはページの情報が古くなったときは、既存のページを更新します。

ページが約200行を超えた場合や、無関係な概念を複数扱う場合は、分割します。

KB と Work の使い分け

• 確定した知識 → kb/
• 草稿の反復、ブレインストーミングの記録、批評レポート → work/
• 草稿の完成後に昇格した事実 → kb/canon/ または該当する wiki ページ

完成した章から定期的に事実を抽出するには /story-memory を使います。kb を直接編集するのは、作者またはミューズが対話しながら決定事項を記録する場合です。