#エージェント設計

ルールを守れと書いた説明文が、そのルール違反だと機械的に誤判定されてしまう——そんな自己言及的な誤検知が自動化パイプラインで実際に起きました。誤検知の構造と、検出対象を自由文から構造化フィールドへ移して直した設計を紹介します。

AIに実装・評価まで任せる自動開発では、環境のノイズがコード欠陥と誤判定され、ループが無駄に止まる・無駄に直ることがあります。失敗を環境要因とコード欠陥に仕分け、CIのgreenを根拠に機械的に閉じる設計を紹介します。

安全のために入れた仕組みで、確認プロンプトが止まらない・セッションが終わらない。設定を見直す前に、まず「暴発・遅延・無限ループ」の3症状で切り分ける——hook を入れた後のデバッグ手順に絞って解説します。

AIに「テストを緑にして」と指示するだけでは、AIは品質ではなくテストを攻略しにきます。実運用のAI開発ループで見つかった5つの抜け道と、それぞれの設計的な対策を紹介します。

自動エージェント実行中に本番認証情報を露出させたり git を強制push してしまう事故を防ぐために、Claude Code の hooks と権限deny ルールを使った多層防御の設計パターン。