brain-taxonomist

brain-taxonomist

目的

ゲート機能： 新しい脳ページを作成する前に、必ずこのスキルを参照して、正しい保存先を判断してください。これにより、後から分類のずれを修正するのではなく、書き込み時点で誤った分類を防ぎます。

ずれ検出機能： 定期的にスキャンし、現在の保存先に収まらなくなったページを検出します。

契約

このスキルでは、次のことが保証されます。

• すべての新しいページは、ハードコードされたディレクトリ一覧ではなく、ACTIVE スキーマパックによって決定されたパスに保存されます。
• 判断は再現可能です。同じコンテンツに対して brain-taxonomist を 2 回実行すると、同じ推奨パスが得られます。
• あいまいなケースでは、黙ってデフォルトを選ばず、skills/ask-user/ を通じてユーザーに確認します。
• --source <id> によるソースごとのオーバーライドが尊重されます。複数の脳を使うユーザー（Persona B）では、パックが異なる場合、ソースごとに異なる推奨が提示されます。
• ACTIVE パックに一致する page_types[] エントリがない場合、最も近い代替候補を選ぶのではなく、EIIRP Phase 3（SCHEMA CHECK）に進むよう通知します。

重要：このスキルは ACTIVE スキーマパックをデータとして読み取ります

brain-taxonomist は、ハードコードされたディレクトリ一覧を持ちません。すべての判断は gbrain schema show --json によって行われます。つまり、次のとおりです。

• gbrain schema use gbrain-recommended を実行すると、推奨されるディレクトリ一式（deal、meeting、concept、project、source、daily、personal、civic、original、place、trip、conversation、writing、および gbrain-base の全タイプ）が利用できます。
• gbrain schema init を実行して編集し、独自のパックを作成したユーザーには、gbrain のデフォルトではなく、そのユーザー独自の分類体系に基づいた保存先が推奨されます。
• --source <id> を brain-taxonomist に渡すと、ソースごとのオーバーライド（7 段階の解決チェーンにおける tier 3）が尊重されます。

これは、信頼できる唯一の情報源の原則です（v0.39 plan-eng-review の D9）。

参照するタイミング（必須）

次の場合は、脳に書き込む前に分類チェックを実行してください。

1. 新しい脳ページ — type を問わず（person、company、concept、book、meeting など）
2. 一括インポート — 新しいページの一括登録を確定する前
3. 保存先が不明な場合 — 主題があいまいなとき

次の場合は、参照する必要はありません。

• 既存ページをその場で更新する場合（同じパス）
• Timeline セクションに追記する場合
• 既存ページへの会議エンティティの伝播

判断プロトコル

ステップ 1：主題のタイプを特定する

次の質問を順番に確認してください。

1. 主題は固有名を持つ人物ですか？ → person タイプのディレクトリ
2. 主題は固有名を持つ組織ですか？ → company タイプのディレクトリ
3. 期間が限定されたイベント（会議、取引、旅行）に関するものですか？ → temporal タイプのディレクトリ
4. 再利用可能なメンタルモデルですか？ → concept タイプのディレクトリ
5. 生のメディア（記事、動画、書籍、PDF）ですか？ → media タイプのディレクトリ
6. 一括ソースデータですか？ → source タイプのディレクトリ
7. 上記のいずれにも該当しない場合 → EIIRP Phase 3 に進み、スキーマパックの候補を作成してください。

ステップ 2：ACTIVE パックで、そのタイプのディレクトリを調べる

gbrain schema show --json | jq '.page_types[] | select(.primitive == "entity")'

各 page_types[] エントリには path_prefixes: 配列があります。最初のプレフィックスが標準パスです。複数のタイプが一致する場合（たとえば、expert_routing: true を持つ person と founder の両方がパックに存在する場合）は、より具体的なパスプレフィックスを持つ、より具体的なタイプを優先してください。

ステップ 3：書籍の場合 — サブカテゴリーを決定する

gbrain-recommended パックでは、書籍は media/books/<category>/<slug>.md として扱われます。category は次のいずれかです：psychology、philosophy、spirituality、business、media-and-society、family-and-divorce、heritage、science、fiction、biography、arts-and-design。ACTIVE パックの方式が異なる場合は、ここでハードコードせず、gbrain schema show --json を参照してください。

ステップ 4：slug を作成する

• kebab-case で、内容がわかる名前にする
• 識別に必要な場合を除き、著者名は含めない
• 標準パスプレフィックスに正確に合わせる（先頭にスラッシュを付けない）

ステップ 5: 書き込む前に検証する

• パスが有効なパックの page_types[].path_prefixes に従っている
• スラッグがケバブケースで、内容が分かりやすい
• フロントマターに、有効なパックの page_types[].name のいずれかと一致する type: が含まれている
• 関連ページへの相互リンクが含まれている

有効なパックに登録したい項目に対応するタイプがない場合、 最も近いタイプを選んではいけません。代わりに、EIIRP に新しい タイプが必要であることを伝え、スキーマパックのカテドラルに提案フローを任せてください。

他のスキルとの連携

• eiirp — インベントリ内のすべての出力について、フェーズ 2 TAXONOMY としてこのスキルを呼び出します。
• ingest — 記事やメディアの取り込み時に、brain-taxonomist に分類先を確認します。
• repo-architecture — 分類先の判断をこのスキルに委ねます。
• book-mirror — ミラーの生成後、brain-taxonomist を通じて分類します。

定期的なドリフト検出

# Which pages have no type matching the active pack? Counts untyped pages AND
# pages whose type the pack neither declares nor aliases (undeclared_types).
gbrain schema review-orphans --json

# Per-type audit of the stored corpus (stored_type_undeclared / stored_type_is_alias).
gbrain schema lint --with-db --json

どちらのコマンドもローカルで実行されます。MCP 経由では、run_doctor レポートに schema_pack_consistency チェックと同じ判定結果が含まれます（未宣言のタイプがあると、コード page_type_undeclared で警告されます）。

未宣言のタイプが見つかった場合は、パックで宣言するか（gbrain schema add-type <type> --primitive <p> --prefix <dir/>）、宣言済みのタイプを使ってページを書き直してください。ソースの 10% を超えるページでタイプが未設定の場合は、EIIRP のフェーズ 3 SCHEMA CHECK フローを実行し、schema detect で候補タイプを見つけてください。

出力形式

提案：1 つの推奨事項ブロックと、1 行の判断理由。

**File at:** `<directory>/<slug>.md`
**Reasoning:**
- Primary subject: <person|company|concept|...>
- Matched page_type: <name> (primitive: <entity|temporal|concept|media|annotation>)
- Active pack: <pack-name> v<version>
- Source: <source_id>

曖昧な場合は、黙って選ぶのではなく、skills/ask-user/ を使って 2 つの候補を提示してください。

有効なパックに一致するタイプがない場合は、EIIRP フェーズ 3 （SCHEMA CHECK）に伝え、次の内容を出力してください。

**No match in active pack `<name>`.**
**Suggested next step:** `gbrain schema detect --source <source_id>` then
`gbrain schema review-candidates`.

失敗した場合

gbrain のエラー code、終了コード、[AGENT] ブロック、または通知ブロックについては、エージェントオペレータープロトコルに従ってください。このスキル固有の事項は次のとおりです。

• スキーマパックが有効でない、または破損しているために gbrain schema show / gbrain schema lint が失敗した場合：その旨を報告し、schema-author スキルに引き継いでください。記憶を頼りにディレクトリを推測してはいけません。
• 推奨事項にスキーマの変更（gbrain schema add-type、gbrain schema use）が必要な場合：このスキルは助言のみを行います。ユーザーの同意を得たうえで、EIIRP または schema-author に引き継いでください。このスキルから有効なパックを変更してはいけません。

アンチパターン

• このスキル内にディレクトリテーブルをハードコードする。 あらゆる判断で gbrain schema show --json を使用します。v0.39 以降では、gbrain-recommended またはカスタムパックを使うユーザーに適切な振り分けが自動で行われるよう、以前のハードコードされたテーブルは意図的に使えなくなっています。
• 一致するタイプがないときに、最も近いタイプを選ぶ。 最も近いタイプを選ぶと、ユーザーの分類精度が気づかれないまま低下します。代わりに EIIRP フェーズ 3 に引き継いでください。
• 複数のブレインを使う設定で --source <id> を無視する。 ソースごとのオーバーライドは、7 段階の解決チェーンの第 3 段階です。このフラグを省略すると、ブレイン全体で有効なパックが黙って使われます。
• gbrain schema review-candidates --apply の判断を自動適用する。 確信度の高い提案であっても、ユーザーの承認が必要です。このスキルは自動化ツールではなく、ゲートです。

厳守事項

• このスキル内にディレクトリテーブルをハードコードしてはいけません。 あらゆる判断で gbrain schema show --json を使用してください。有効なパックが正式な情報源です。
• ソースごとのフラグを必ず使用します。 デフォルト以外のソースを扱う場合、すべての CLI 呼び出しに --source <id> を渡してください。
• 信頼度の下限を遵守します。 EIIRP のフェーズ 3 が信頼度 < 0.6 の提案を生成した場合、brain-taxonomist はそれを自動適用せず、ユーザーに提示しなければなりません。信頼度の低いスキーマ変更を、黙って昇格させてはいけません。

変更履歴

v1.0.0 — gbrain v0.39.0.0

• 上流の OpenClaw から初期移植しました。汎用化し、CLAUDE.md のプライバシールールに従って、プライベートフォーク名への言及をなくしました。
• ハードコードされたディレクトリテーブルを削除しました。すべての判断で、アクティブなスキーマパックを gbrain schema show --json 経由で読み取るようになりました。単一の信頼できる情報源です。
• 書籍の分類体系をスキルテキストから gbrain-recommended パックの media/books/ ブランチに移動しました（src/core/schema-pack/base/gbrain-recommended.yaml を参照）。
• マルチブレインユーザー向けに、--source <id> の伝播を文書化しました（ペルソナ B）。