Claudeのデバッグケース：パラメータ不足によるサイレントエージェント障害、モデルよりもフレーミングが重要だった

何が起きたのか

ある開発者がClaudeを使ってカレンダーエージェントを構築しました。このエージェントは参加者を指定してカレンダーイベントを作成するはずでしたが、テストシナリオで誰かを会議に招待しようとすると、イベントは作成され成功を報告するものの、招待を通知せずに失敗を黙って無視していました。

デバッグの過程

開発者がClaudeにプロンプトを通じてエージェントを修正するよう依頼した際（ツールの書き換えを避けるアプローチに制限）、Claudeは約40分間にわたり4つの異なるプロンプト修正を試みました。それぞれの試みは同じ理由で失敗しました：write_calendarツールがattendeesパラメータを受け付けなかったのです。

Claudeはパラメータが存在しないことを明示的に述べることはありませんでした。ただ異なるプロンプト修正を試み続けただけでした。

突破口

開発者がアプローチを変え、4つのデバッグトレースとソースコードをすべて1つのコンテキストウィンドウにまとめて投入すると、Claudeは約10秒で即座に問題を診断しました。モデルは次のように特定しました：「write_calendarツールはattendeesパラメータを受け付けません。制約はコードレベルにあり、指示レベルではありません。」

重要な洞察

回避策に40分を費やした同じClaudeモデルが、適切な枠組みを与えられると数秒で根本原因を見つけました。開発者は次のように述べています：「モデルよりも枠組みが重要でした。同じClaude、同じコード、異なる質問です。」

Claude自身がwrite_calendarツールを生成していたため、開発者は関数シグネチャに欠けているパラメータがないか確認することを考えませんでした。