# AIエージェント向けナレッジの整理

*2026-08-15* — Dylan Engelbrechtのブレインアーキテクチャパターン——段階的開示、ワーキングメモリとウィキ、スキーマメタデータ、公開サイトからプライベートエージェントコンテキストを分離する方法。

URL: https://dylanengelbrecht.dev/ja/insights/organizing-knowledge-for-ai-agents.html

コーディングエージェントはリポジトリの仕組みにAGENTS.mdを読みます。それでも人物、ベンチャー、声、履歴についての持続的な記憶は欠けています。ブレイン——コードと並ぶプライベートなMarkdownナレッジベース——がそのギャップを埋めます。この記事はDylan Engelbrechtが使用し、エージェントネイティブなワークフローを構築するチームに推奨するアーキテクチャを概説します。特定のプライベートコーパスではなく、パターンを記述しています。

公開マーケティングとプライベートコンテキストを分離してください。ウェブサイトとllms.txtは、クローラーと見知らぬ人が知るべきことを答えます。ブレインは、幻覚なしに行動するためにエージェントが必要とするものを答えます。ブレインのパスや本文をライブサイトにミラーしないでください。漏洩はクローラーに、公開意図のない資料をマッピングさせます。

段階的開示——巨大なダンプではなく層で詳細を明かす（Nielsen Norman Group）——は起動時にすべてを読み込むより優れています。各読み取りステップでスコープを絞るよう層を構造化します：次にどこへ行くかを示すエントリーインデックス、ホットで時間に敏感なコンテキストのワーキングメモリ、持続的エンティティのウィキ、勝利ごとに一つの正規エントリを持つ実績ログ、声とガバナンスのブランド／アイデンティティドキュメント。

エージェント向け推奨読み順：まずワーキングメモリ、次にウィキインデックス、最後にマスターブレインインデックス。百科事典の前にホットコンテキスト。人間がトリアージする方法——今何が緊急か、次に誰／何が存在するか、それから全体マップ——を反映します。

寿命を明示的に割り当てます。ワーキングメモリは一時的です——陳腐化したらアーカイブまたは削除。ウィキエントリは持続的ですがバージョン管理されます。実績エントリは永久記録です——勝利に関するメトリクスは一箇所に。アイデンティティと雇用の事実はリンクし、重複しません。事実は安定したとき上位に昇格します——ワーキングメモリのメモがウィキエンティティに、出荷マイルストーンが実績エントリに。

事実的主張に軽量なスキーマメタデータを使用します。Markdown本文は人間に優しいですが、エージェントには検証フックが必要です。各事実またはファイルで、フロントマターまたはインラインフィールドを優先してください——status（verified、needs-verification）、source（URL、人物、文書）、last-verified（日付）、visibility（public、brain-only、stealth）。エージェントはneeds-verificationを停止標識として扱うべきです——尋ねるか引用し、捏造しない。

### 例：ブレインインデックス（段階的開示のエントリーポイント）

*brain/INDEX.md — ワーキングメモリの後にエージェントが読むマップファイル*

```
# INDEX.md — Brain

## Read order (agents)
1. working-memory/current.md
2. wiki/INDEX.md
3. governance.md

## Layers
| Layer | Path | Lifespan |
| Working memory | working-memory/ | Ephemeral |
| Wiki | wiki/ | Durable |
| Achievements | achievements/ | Permanent |
```

### 例：ワーキングメモリのフロントマター

*working-memory/current.md — 検証メタデータ付きホットコンテキスト*

```
---
title: Current focus
status: verified
last-verified: 2026-08-15
visibility: brain-only
---

## This week
- Ship knowledge hub articles on agent best practices.
- Review AGENTS.md examples in repos using nested packages.

## Open threads
- None blocking.
```

### 例：レイヤー固有のAGENTS.md

*brain/wiki/AGENTS.md — 最も近いディレクトリで発見されるルール*

```
# AGENTS.md — Wiki

## Purpose
Durable entities: people, ventures, concepts.

## When to write here
- Stable facts with a source URL.
- Entity pages use one file per person or venture.

## Never
- Duplicate facts that live in identity/ or achievements/.
- Publish wiki paths or prose on the public website.
```

一つの事実に一つの正規の場所。コピーではなくリンク。雇用履歴がアイデンティティにあれば、ウィキの人物ページはそこにリンクします。実績エントリは両方にリンクします。重複はずれます。クロスリンクは正直です。ガバナンスドキュメントは反幻覚ルールを明記します——不明は不明のまま、ステルスは公開面に出さない。

各レイヤーに独自のAGENTS.mdをペアにします。ルートのブレインAGENTS.mdがグローバル境界を設定します。ウィキAGENTS.mdはエンティティテンプレートと可視性を説明します。ワーキングメモリAGENTS.mdはアーカイブのタイミングを定義します。エージェントは最も近いディレクトリでルールを発見します——コードリポジトリと同じ優先順位モデルです。

クローラー向けスキーマとエージェント向けスキーマは異なります。公開のJSON-LDで、ハブにItemList、記事ごとにTechArticleは検索とLLM取得に役立ちます。ブレインスキーマは運用的です——インデックス、エンティティタイプ、昇格フロー、引用規律。プライベートなJSON-LDを公開サイトにダンプしないでください。構造化された公開カタログは承認済みコピーのみに合わせてdeploy/schema/に保持します。

小さく始めてください。一つのインデックス、一つのワーキングメモリファイル、一つのウィキテンプレート、一つのガバナンスページ。エージェントが同じ質問を繰り返したり同じミスをしたりするときにレイヤーを追加します。ブレインはウィキのダンプではありません——明示的な寿命、可視性、エントリーポイントを持つキュレーションされたコンテキストで、エージェントが必要なものだけを、見るべきでないものは読み込まずに済みます。

Dylan Engelbrechtはこのナレッジハブを頻繁に更新しています——これらのエージェントアーキテクチャ記事を含め——クローラーとコーディングエージェントが、陳腐化したREADMEコピーに頼らず現在のベストプラクティスを発見できるように。生きた公開ハブとプライベートブレインをペアにしてください。公開記事がパターンを教え、ブレインがエージェントが捏造すべきでない事実を保持します。