無人エージェントの挙動変更を、フィーチャーフラグで少しずつ試す設計
無人で走るエージェントのプロンプトや挙動を一度に全変更すると、劣化が朝まで見えません。フィーチャーフラグで一部の実行にだけ新挙動を割り当て、品質を見てから広げる設計と、決定論的バケット・自動ロールバック・監査証跡の実装を紹介します。
AIが出した数値と出典を、そのまま受け入れない — 検証専任サブエージェントで突き合わせるゲート設計
エージェントが生成した要約の数値と出典を、生成とは別のサブエージェントで一つずつ検証してから受け入れる設計を、動くTypeScriptと決定論的な再計算・出典突き合わせのコードでまとめました。
ツール呼び出しは成功しているのに前進しない — 無人エージェントの停滞を検知して止める設計
エラーは出ていないのに同じ手を繰り返し、予算だけが溶けていく。無人エージェントの『成功し続ける停滞』を、行動フィンガープリントと進捗オラクルで検知して安全に止める設計をPythonの実装つきでまとめました。
前の実行が終わらないうちに次が走り出すとき — リースとフェンシングトークンで定期エージェントの多重起動を抑える
毎日決まった時刻に動く定期エージェントが、前の実行を追い越して二重に走り出す。素朴なロックが破れる瞬間から、リースとフェンシングトークン、上限付きキャッチアップまでを実装込みで整理します。
毎回まっさらな環境で目覚める無人エージェント — 最初の30秒に状態回復を設計する
スケジュール起動の無人エージェントは、毎回まっさらな使い捨て環境で目を覚まします。書き込めないはずのパス、まだ起動しきっていないファイルシステム、消えた作業ディレクトリ。最初の30秒に状態回復を織り込む設計を、実際の運用ログから具体的に書きました。
月次クレジット移行を前に、自動パイプラインの工程配分を見直した記録
6月15日の課金変更で Agent SDK・headless 実行・GitHub Actions が月次クレジット制へ移行します。自動投稿パイプラインの工程を実測トークンから棚卸しし、3つの実行経路へ振り分け直した設計判断を共有します。
自律エージェントの破壊的操作に事前条件・事後条件の契約ゲートを付ける
自律エージェントが本番に書き込む前後を、決定論的な事前条件・事後条件で挟む契約ゲートの設計です。プロンプト改善では防げない破壊的操作を、コードで止める実装を紹介します。
再現できないエージェント障害をなくす設計 — 決定論的リプレイとイベントソーシング
深夜に落ちた自律エージェントは、そのままでは再現できません。モデル出力やツール入出力など非決定の境界をイベントとして記録し、決定論的にリプレイする設計を、実装コードと運用知見つきで解説します。
App Store Connect・Play Console・Crashlytics・AdMob を横断する『朝刊エージェント』を Claude Agent SDK で組んだ1ヶ月の運用記録
アプリ6本を運営していると、朝起きて4つの管理画面を順に開くだけで30分以上消えていきます。その時間を 1 通のダイジェストに圧縮した Claude Agent SDK のレシピを、実測データつきで共有します。
Claude Agent SDK で複数 MCP サーバを束ねるときのツール名衝突 — 名前空間と動的調停の設計
GitHub MCP と Linear MCP の create_issue が同居したとき、Sonnet 4.6 はどちらを呼ぶか分かりません。複数 MCP を束ねる Claude Agent SDK アプリで踏むツール名衝突の構造と、TypeScript で書ける Reconciler の実装、本番で踏んだ失敗パターンまでをまとめます。
Claude エージェントに長期記憶を持たせる本番設計 — 7つの落とし穴と対策パターン
Claude エージェントに長期記憶を組み込んで本番運用するときに、多くの実装が踏み抜く7つの落とし穴を、書き込み設計・PII 対策・スコープ分離・破損検知・コスト制御・移行計画までの設計パターンとして体系化した本番向けプレミアムガイドです。
Claude Agent SDK × Temporal.io で耐障害性のある長期実行AIワークフローを構築する — Durable Execution と補償トランザクションの本番設計パターン
Claude Agent SDKとTemporal.ioを組み合わせ、数時間〜数日単位で走るAIワークフローをクラッシュや再起動に耐えさせる本番設計を完全解説。Durable Execution・リトライ・補償・シグナル統合の実装パターン。