Claude Codeで20エージェントパイプラインを構築：AIより構造を重視して

r/ClaudeAIで開発者が、Claude Codeを使用してGmail、カレンダー、Notion、LinkedIn、ウェブスクレイパー、ローカルAPIにまたがる日々のワークフローを自動化する20エージェントのパイプラインを構築した経験を共有しました。このシステムにより、毎朝1時間かかっていた手動チェックが不要になりました。

モノリシックアプローチの問題点

最初のバージョンは、注文、ロジック、すべてのタスクを処理するClaudeとの単一の長い会話でした。この「モノリス」は約10万トークンまでは機能しましたが、その後モデルが追跡を失い始め、ステップを繰り返したり、他のステップをスキップしたりするようになりました。すべてが一つのコンテキストに存在するため、デバッグの方法がありませんでした。

解決策：エージェントベースのアーキテクチャ

開発者はシステムを個々のエージェントに分割し、それぞれに一つの仕事を割り当てました。各エージェントはそのタスクを持つマークダウンファイルです。オーケストレーターがファイルを読み、変数を置き換え、Agentツールを使用して起動します—LangChainやCrewAIは使用しません。

通信層はシンプルです：エージェントはコンテキストを共有しません。各エージェントはディレクトリ（1日ごとに1つ）にJSONファイルを書き込み、calendar.json、gmail.json、notion.json、leads.json、hitlist.jsonなどのファイルを作成します。次のエージェントがそのファイルを読みます。このアプローチにより完全な可視性が提供されます—どのファイルを開いても、エージェントが生成した内容を正確に確認できます。開発者はこれを「爆発半径の封じ込め」と呼んでいます：1つのエージェントが失敗しても、残りは動作を続けます。

主要な構造的要素

• 非AIオーケストレーター：「これら4つのエージェントを並列で実行し、すべてが完了するのを待ち、出力ファイルが存在することを確認してから、次のフェーズを実行する」と指定するマークダウンファイル。システムには9つのフェーズがあり、一部は並列、一部は順次実行されます。
• フェーズ0検証：すべてのツールが接続されていることを確認します。GmailやNotionがダウンしている場合、完全に停止します—完了したように見える部分的な実行はありません。
• 非AI圧縮：システムは開始時に「1から5？」と尋ねて容量を決定します。これによりルールを含むJSONファイルが書き込まれます：低い数字はすべてを5アクションに制限し、30分を超えるものはスキップします；高い数字は完全なルーチンを実行します。
• スタイルルールファイル：すべてのコンテンツエージェントが書き込み前に読み込むプレーンテキストファイル。これにより、複数のエージェントが異なるAIのように聞こえるアウトリーチメッセージを書く問題が解決されました—これ以前はゼロ応答でしたが、その後は実際の会話が生まれました。

核心的な洞察

開発者は、何かが壊れるたびに、修正は決してより良いプロンプトではなかったことを発見しました。それはAIの周囲に構造を追加することでした。AI部分は機能しました—壊れたのは、シーケンシング、エージェント間の通信、エラー処理、および出力量でした。そのたびに、答えはより賢いモデルではなく、ソフトウェアの一部でした。

脅威インテリジェンス調査の背景を持つこの開発者は、汎用バージョンをhttps://github.com/assafkip/kipi-systemでオープンソース化し、他の人々が自分のドメインで同様のシステムを構築できるようにしました。