huangjia2019/agent-design-patterns

解決する課題

このプロジェクトは、本番グレードの AI エージェントを構築するための構造化された設計語彙を提供します。テクニックのフラットなリストではなく、エージェントアーキテクチャを 2 次元マトリクスに整理し、開発者が特定の認知機能と実行トポロジーに適したパターンを正確に特定できるようにします。これにより、予算配分エラーや競合する批評家などの一般的な失敗モードを防ぎます。

仕組み

このフレームワークは、27 のコアパターンを 2 つの直交軸に整理します。

• 認知機能（エージェントが行っていること）：知覚、記憶、推論、行動、振り返り、協調、統治。
• 実行トポロジー（作業の配置方法）：チェーン、ルート、並列、ループ、階層、オーケストレーション。

各パターンは、自己完結型のフォルダとして実装され、最小限の参照実装（pattern.py）、実際のシナリオ例（example.py）、およびパターンの不変条件が維持されることを保証するテストを含みます。

対象読者

本番環境向けにエージェントを構築しており、単純なチュートリアルを超えて、アーキテクチャパターンを体系的に選択・構成する方法を必要としている AI エンジニアおよびアーキテクト。

ハイライト

• 2 軸マトリクス：フラットなリストを超え、エージェント設計の決定に座標を提供します。
• 本番環境に基づく：各パターンは、Claude Code、Aider、OpenHands などの実際の本番ハーネスからの検証済み「エンジニアリングスライス」を引用しています。
• 実行可能な参照コード：おもちゃの例ではなく、誠実で小規模な実装（50〜250 行）を提供します。
• 包括的なカタログ：RAG、思考の連鎖、ガードレールサンドイッチ、階層的委任を含む 27 のコアパターンをカバーしています。