AIエージェントで16媒体のコンテンツ運用を回す全体アーキテクチャ — 個人開発の設計メモ

617行に育った本番リポジトリの AGENTS.md を整理するため、Claude公式ドキュメントと個人ブログから推奨要素を洗い出し、8項目の推奨構成案を提示。プロジェクト概要・アーキテクチャ・セットアップコマンド・タスク管理参照先・規約・禁止事項・落とし穴・Definition of Done を、(1)非存在情報(2)探索コスト(3)誤りコストの3基準で正当化。次回記事で実検証予定。

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

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

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