◉CLAUDE LABEN
●CC 2.1.330 — Claude Code 2.1.330 で、長い会話を圧縮した直後に数分固まる問題が直りました●SONNET 4.5 — Claude API の Sonnet 4.5 は 11/30 で提供終了、残り8日です。推奨の移行先は claude-sonnet-5-5 です●MCP 401 — MCP サーバーが 401 を返しても、エラーにならず無言でタイムアウトする、という報告が出ています●NEW — 新着:Desktop が毎回 worktree を作るとき、確かめる3か所●OPUS 4.5 — Opus 4.5 の 11/24 は「これより前には廃止しない」下限日で、廃止の告知ではありません●SCHEMA — Agent SDK と Messages API の構造化出力は、同じスキーマでも返り値の形を一度見比べると安心です●CC 2.1.330 — Claude Code 2.1.330 で、長い会話を圧縮した直後に数分固まる問題が直りました●SONNET 4.5 — Claude API の Sonnet 4.5 は 11/30 で提供終了、残り8日です。推奨の移行先は claude-sonnet-5-5 です●MCP 401 — MCP サーバーが 401 を返しても、エラーにならず無言でタイムアウトする、という報告が出ています●NEW — 新着:Desktop が毎回 worktree を作るとき、確かめる3か所●OPUS 4.5 — Opus 4.5 の 11/24 は「これより前には廃止しない」下限日で、廃止の告知ではありません●SCHEMA — Agent SDK と Messages API の構造化出力は、同じスキーマでも返り値の形を一度見比べると安心です
記事一覧/API & SDK
⬡ API & SDK/2026-06-16上級

自律エージェントの判断根拠を台帳に残す — 「なぜそうした」を後から説明できる設計

自律エージェントが本番デプロイやファイル削除のような後戻りしづらいアクションを取るとき、採用案・却下案・前提を構造化して台帳に残す設計をまとめました。structured output と追記専用ログ、影響度による線引きまで実装します。

Claude API148Agent SDK5structured output自律運用本番運用36

✦ プレミアム記事

先月、私は個人開発で運用している自動化パイプラインに、設定ファイルを書き換えてから本番へ反映するアクションを任せていました。週明けにある反映の中身を見返したとき、「なぜこの値にしたのか」が自分でも再構成できなくなっていました。ログには「変更した」という事実だけが残り、「どの選択肢を比べて、何を理由に、何を却下したのか」がどこにも無かったのです。

エラーは出ていません。アクションは成功しています。それでも、後から自分が説明できない自動判断が積み上がっていく状態は、静かに危ういものだと感じました。今回は、その「なぜ」を後から追えるようにするための、判断根拠レコードという小さな仕組みの設計と実装を共有します。

規制業界が AI に求める「説明できること」を、個人開発に小さく持ち込む

ちょうど同じ頃、TCS と Anthropic が提携して銀行や航空といった規制業界へ Claude を導入する、というニュースが流れていました。DXC も既存システムへの統合を進めているとのことです。こうした領域で AI を本番に乗せるとき、必ず問われるのが「その判断を、後から人間が説明できるか」という点です。監査や事故調査の場面で、結果だけでなく根拠が残っていなければ、自動化はそもそも許可されません。

私自身が Dolice Labs で運用しているのは、規制とは無縁の小さなパイプラインです。それでも、この「説明できること」という要求は、個人開発の自律運用にこそ小さく持ち込む価値があると考えています。なぜなら、ひとりで運用していると、判断を後から検証してくれる第三者がいないからです。半年前の自分は完全な他人で、その他人が下した自動判断を引き継いで運用していくことになります。

ここで持ち込むのは大掛かりな監査基盤ではありません。「後戻りしづらいアクションを取る前に、根拠を構造化して1行残す」という、それだけの規律です。

判断根拠レコードのデータモデル — 採用案・却下案・前提・可逆性

最初に決めるべきは、何を残すかです。「変更した」という事実は既存のログに残っています。足りないのは、その手前にあった思考の構造でした。私は次の5つを最小単位と決めました。

  • chosen: 実際に取ったアクション(要約)
  • considered: 比較検討した選択肢の一覧
  • rejected: 却下した案と、その理由
  • assumptions: 判断の前提(後で崩れたら見直すべきもの)
  • reversibility: そのアクションが後戻りできるか(reversible / hard_to_reverse / irreversible)

最後の reversibility を入れたのは、根拠の濃さを後から評価するためです。後戻りできないアクションほど、却下案や前提が薄いと危険だと判断できます。

TypeScript で表すなら、レコードの形はこうなります。

interface DecisionRecord {
  action_id: string;          // 紐づくアクションの識別子
  chosen: string;             // 取った行動の要約
  considered: string[];       // 比較した選択肢
  rejected: { option: string; reason: string }[];
  assumptions: string[];      // 前提(崩れたら再検討)
  reversibility: "reversible" | "hard_to_reverse" | "irreversible";
  confidence: number;         // 0.0–1.0
}
✦

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
✦後戻りしづらいアクションの「なぜそうしたか」を structured output でモデル自身に書かせ、追記専用の台帳に残す実装を手に入れられる
✦全アクションに根拠を求めて出力トークンを15%以上無駄にしていた運用を、影響度で線引きして必要な場面だけに絞れるようになる
✦「後付けの正当化」でレコードが形骸化する罠を避け、却下案と前提まで残る判断根拠の設計に切り替えられる
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Claude Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

⬡ API & SDK2026-05-24
Claude API のレスポンスを Cloudflare R2 にアーカイブする実装メモ — 監査・再現性・障害分析の3軸設計
Claude API のリクエストとレスポンスを Cloudflare R2 に保存して、監査・障害分析・本番リプレイの3つに使う設計を、Workers の waitUntil パターンと D1 メタデータインデックス込みで実装メモにまとめました。
⬡ API & SDK2026-05-04
Bun × Claude API で本番運用するエッジAIサービス — Node.js移行の判断軸と落とし穴を回避する実装パターン
Claude APIをBun上で本番運用するための実装ガイド。Node.jsからの移行判断軸・組み込みSQLite/WebSocketの活用・ストリーミング最適化・典型的な落とし穴の回避策まで、動作するコードと実測値で解説します。
⬡ API & SDK2026-04-30
Claude API で多言語翻訳 SaaS を本番運用する設計ガイド — 用語集・スタイル・ドメイン適応の実装
多言語翻訳SaaSをClaude APIで本番運用するための設計を通しで解説します。タグやプレースホルダーを失わせない前処理、用語集の注入と強制、スタイルガイドによるトーン制御、Few-shotでのドメイン適応、品質ゲートとコスト最適化まで、具体的なコードと運用ノウハウでまとめました。