Skip to content

Concepts — 設計思想の全体像

8つの章が描く「AIエージェントアーキテクチャの設計思想」を俯瞰する。

ドキュメントチェーン

各章の概要

ラベル中心的な問いリンク
01WHYAIになぜ指針が必要か?01-vision
02WHAT何を参照先とするか?02-reference-sources
03HOWどう構成するか?03-architecture
04WHICHどのパターンをいつ選ぶか?04-ai-design-patterns
05REALITY現実の制約にどう向き合うか?05-solving-ai-limitations
06EXTENSION三層モデルは物理世界でも成り立つか?06-physical-ai
07DOCTRINEAIは何を基準に判断し行動すべきか?07-doctrine-and-intent
08MEMORYエージェントは何を記憶し、どう接続するか?08-memory-and-knowledge
09DECOMPOSITIONプロンプトは層へどう分解されるか?09-prompt-decomposition

レイヤー × 関心事の横断マトリクス

各章がどのレイヤーのどの関心事をカバーしているかを示す。

関心事Agent 層Skills 層MCP 層Memory 層Doctrine 層
構造定義0303030807
設計パターン040404
制約と対策0505050805
エッジ拡張06060606
判断基準07070807
参照先の体系020208
プロンプト条件の分配0909090909
設計思想(WHY)0101010101

Mermaid 図の色調凡例

全章を通じて、以下のカラーコードでレイヤーを表現する。下の Mermaid 図は実際の塗り色のサンプル。

レイヤー色見本カラー名Mermaid fill
Agent 層水色#87CEEB
Skills 層薄緑#90EE90
MCP 層ピンク#FFB6C1
Memory 層薄紫 (Lavender)#E6E6FA
Doctrine 層薄橙#FFE4B5

規範強度ラダー(shall / should / may)

本サイトのドキュメントでは、RFC 2119 に準拠した規範キーワードを使用する。色は強度の階層を視覚的に表すもので、レイヤー色(淡色系)とは色域が重ならないよう、彩度を高めに設定している。

強度キーワード日本語意味
必須MUST / SHALLしなければならない絶対的な要件。違反は設計上の欠陥
禁止MUST NOT / SHALL NOTしてはならない絶対的な禁止事項
推奨SHOULDすべきである正当な理由がある場合のみ逸脱可能
非推奨SHOULD NOTすべきでない正当な理由がある場合のみ採用可能
任意MAYしてもよい完全に選択的

ドクトリン内の制約(07-doctrine-and-intent)や、仕様MCPから抽出される規範要件は、この強度ラダーに沿って解釈される。

Concepts → 実装への出口チェックリスト

Concepts セクションの理解が実装フェーズへ進むのに十分かを確認するためのチェックリスト。

最低限の準備条件

  • [ ] Reference Sources の最小カタログ — プロジェクトが参照する権威ある情報源を特定し、MCP 化の優先順位を決定したか?(02 参照)
  • [ ] 三層分離の理解 — Agent / Skills / MCP の責務境界を説明でき、アンチパターン(層の混同)を認識しているか?(03 参照)
  • [ ] パターン選択の根拠 — RAG / MCP / Fine-tuning のどれを採用するか、その根拠を示せるか?(04 参照)
  • [ ] 制約の境界認識 — 技術で解決できる制約(知識制約)と、技術だけでは解決できない制約(制度的制約)を区別できるか?(05 参照)
  • [ ] ヒト介入点の合意 — エージェントの自律性レベルと、人間にエスカレーションする条件をチームで合意したか?(07 参照)
  • [ ] 証拠トレイルの最低要件 — AIの判断根拠を事後的に検証できる仕組み(検証ステータス、出典記録)を設計に含めているか?(05 参照)
  • [ ] Memory 層導入判断 — 現在のシナリオで scatter-gather のコストが許容範囲か評価し、必要に応じて Memory 層 (Stage 1〜2) の導入を計画したか?(08 参照)

これらが揃ったら

開発フェーズ に進み、各フェーズでのMCP統合を実装する → スキル設計ガイド を参照し、ドメイン知識をSkillsとして形式化する

AI 研究との対応

本サイトの概念体系は、AIエージェント研究の標準的な構造と以下のように対応する。

AI 研究の標準構造本サイトの対応該当章
GoalIntent(意図)07
PolicyDoctrine(ドクトリン)07
ReasoningAgent 層(推論・判断)03
Tools / SkillsSkills 層 + MCP 層03
ExecutionMCP 経由のツール実行03, 04
Physical ActionフィジカルAI06

Released under the MIT License.