テック技報最新号へ →
AIコーディング

バグ修正の「指摘→修正→また指摘」を止める4ルール(CLAUDE.md/AGENTS.md 向け)

実装役とレビュー役を同じエージェント群に任せると、最初からあった古いコードの指摘(投稿では約59%)で往復が終わらない。次の4行を CLAUDE.md/AGENTS.md に置くか、バグ修正の直前に渡す。Claude Code チームが似た制限を入れたあと、5回以上の往復が必要な PR は 8.9%→1.5% になった、という報告つき。

@Voxyz_ai · 2026-11-06
#ai-coding#claude-code#codex#レビュー#agents-md

解決する問題

  • Opus で書いて Codex にレビューさせると、同じ指摘が何度も戻ってくる
  • 「直した」あとに別の古い問題を掘り始め、セッションが終わらない

入れる文言(自分の言葉で再構成)

バグを直すときは次を守る、と書いておく。

  1. 同じバグが2回の修正でも残ったら止める。 試したこと・変えたこと・まだ落ちること・人が決めるべきことを報告する
  2. このバグに関係するコードだけ変える。 見つけた古い問題は一覧にするだけで、今は直さない
  3. 問題を見つけたら、同じパターンを先に検索し、コピーをまとめて直す。 1か所ずつ潰さない
  4. レビュー(自分でも他エージェントでも)は、このラウンドの差分だけを見る。 すでに挙げた指摘を繰り返さない

注意点

  • ルール4は「古い負債を無視せよ」ではない。別チケット/別ラウンドに回す、という意味
  • 日本語で渡すなら、上記をそのまま訳して CLAUDE.md に置いてよい(@sumika45379 も同趣旨を共有)

関連

出典

X の元の投稿を開く