heartbeat と last_seen で分散 AI エージェントを死活監視する設計

ビジネスコミュニケーションで「結局何を決めればいいのか」という聞き手の混乱を解決するため、AI Agent を活用したアプリを開発。話し手がメッセージを磨くプロセスを重視し、課題・根拠・結論・求める判断の 4 要素を固定した「5 枚の Message-First Deck」という共通プロトコルで伝達形式を統一する。

Claude Code で SubAgent と Skills の違いと使い分けを解説。SubAgent はメインから独立したコンテキストでタスクを処理して結果のみ返す仕組み、Skills は再利用可能な手順書。「再利用するか」「結果だけ欲しいか」で判断する基準を提示し、モデル性能向上に伴う実装トレンドの変化も言及。

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

Claude Agent SDK と Google Sheets API を組み合わせた IT 申請フォーム自動化の設計パターンを紹介。トリガー層（スケジュール実行・リクエスト起動）、ツール層（単一責任ベースのツール定義）、出力層（Sheets 更新・ログ記録・通知）の 3 レイヤーで整理し、GAS との比較を通じて Agent SDK が処理フロー設計よりもツール責任範囲の設計に注力できる点を実務的に解説。