プロダクションAIエージェント構築の標準（インストール可能なClaude Codeスキル付き）

AIエージェンティック製品とは、「AIを搭載した製品」ではなく、プロセスの一部がLLMによって決定論的アーキテクチャと明示的な信頼境界内で動的に指示される製品です。ほとんどのチームはエージェントのデモをリリースできますが、本番環境に耐えるエージェントをリリースできるチームはほとんどいません。その違いは、ほぼ常にモデルではなく、アーキテクチャ、ハーネス、評価規律にあります。

このリポジトリ（agentic-product-standard）は、そのための現場検証済みの標準を提供し、さらにClaude Codeスキルセットを備えており、エディタに直接組み込めます。標準は5つの原則に基づいています：デフォルトで決定論的、必要に応じて自律的；アーキテクチャがフレームワークに勝る；ハーネスがモデルより重要；コンテキストエンジニアリングが中核；評価駆動開発は不可欠。

リポジトリの内容は2つのトラックに分かれます：単一エージェント構築はAGENT_STANDARD.mdを読み、テンプレートを埋め、agent-builderスキルを使用；エージェント製品設計はSTANDARD.mdを読み、agentic-product-architectスキルを使用（マルチエージェント、オーケストレーション、フレームワーク選択を含む）。スキルセットは10のサブスキルから構成：アーキテクチャ設計、コンテキストエンジニアリング、ハーネスエンジニアリング、ツール設計/MCP、メモリアーキテクチャ、永続実行、評価駆動開発、フレームワーク選択、プロダクション準備、アンチパターンレビュー。インストール後、Claude Codeは関連タスクで適切なガイダンスを自動ロードします。

主要な概念：自律性ラダー（L0-L4）：単一LLM呼び出しから完全自律ループまで、昇格ルールあり（現在のレベルで≥90%合格率が必要）。5つの構成パターン：プロンプト連鎖、ルーティング、並列化、オーケストレーター・ワーカー、評価者・最適化。7層ハーネス：エージェントループから可観測性とトレーシングまで、権限境界はコードで強制され、プロンプトでは強制されない。2025年のReplit事件では、エージェントがプロンプトの「コードフリーズ」命令を無視し、1200社以上の本番データベースを消去したことが証明している。

プロダクション準備チェックリストは12項目で、コンテキストと状態、ツールと権限、信頼性、評価と可観測性をカバー。アンチパターンセクションでは、単一エージェントベースラインなしでのマルチエージェント構築、プロンプトによる権限強制などのよくある失敗パターンを診断。参照実装AgenticMind（Apache-2.0, Postgres + pgvector, Bun）は、MCP上で動作する知識・メモリレイヤーを提供します。標準はMITライセンスで、コントリビューションを歓迎します。

詳細については、Anthropic、OpenAIなどの推奨読書リストを順に読むことをお勧めします。この標準はAlex DuchDevが2026年5月に公開したv1.0で、複数のラボや実践者のプロダクション実践から抽出されています。