AGENTS.md には何を書くべき？その1 〜推奨構成調査（2026年7月）〜

LangChain、CrewAI、AutoGen、Claude Agent SDK、Dify の 5 つのエージェントフレームワークを習得コスト・本番安定性・拡張性などの実務軸で比較。各フレームワークのインストールからエージェントループ実装までの動作コード（Python・TypeScript）を交えて、自分のユースケースに適した選択方法を解説する。Claude Agent SDK は公式サポートとシンプルな API により Tier 1（必須級）に位置付けられる。

エージェント開発はプロンプト品質の改善から、エージェントを制御する外側のループ設計へシフトしている。ループの成果は反復回数ではなく、停止条件・検証ゲート・状態永続化といった制御構造で決まる。長く回すほど複雑さが増幅し理解の負債が蓄積するため、検証関数が実装できる範囲でのみループを活用すべき。

複数のClaude Codeエージェントをメッセージブローカー経由で連携させる魚卸会社の運用で、プロセスが稼働しているのに機能が停止する「偽の健全」状態に直面。本記事はこの障害を4カテゴリ（セッション死、ツール呼び出し記法エラー、受信デーモン未起動、サーバ二重起動）に分類し、各々の症状・真因・診断手順・対処法をマトリクスで整理。分散システムにおける代理シグナルの限界を実装レベルで解説し、偽アラート連鎖を防ぐための設計パターンを提示。

harness-starter-kit の実運用経験から、エージェントの精度向上よりも「エラー検出・記録・再利用の仕組み作り」が本質的な価値だと気付いた。Django と Next.js の 2 つのプロジェクトでの dogfood を通じ、既存プロジェクト構造に適応できる検査設計と、外部 API 依存時の段階的ゲート戦略が重要なポイント。