バグ修正の「指摘→修正→また指摘」を止める4ルール(CLAUDE.md/AGENTS.md 向け)
実装役とレビュー役を同じエージェント群に任せると、最初からあった古いコードの指摘(投稿では約59%)で往復が終わらない。次の4行を CLAUDE.md/AGENTS.md に置くか、バグ修正の直前に渡す。Claude Code チームが似た制限を入れたあと、5回以上の往復が必要な PR は 8.9%→1.5% になった、という報告つき。
解決する問題
- Opus で書いて Codex にレビューさせると、同じ指摘が何度も戻ってくる
- 「直した」あとに別の古い問題を掘り始め、セッションが終わらない
入れる文言(自分の言葉で再構成)
バグを直すときは次を守る、と書いておく。
- 同じバグが2回の修正でも残ったら止める。 試したこと・変えたこと・まだ落ちること・人が決めるべきことを報告する
- このバグに関係するコードだけ変える。 見つけた古い問題は一覧にするだけで、今は直さない
- 問題を見つけたら、同じパターンを先に検索し、コピーをまとめて直す。 1か所ずつ潰さない
- レビュー(自分でも他エージェントでも)は、このラウンドの差分だけを見る。 すでに挙げた指摘を繰り返さない
注意点
- ルール4は「古い負債を無視せよ」ではない。別チケット/別ラウンドに回す、という意味
- 日本語で渡すなら、上記をそのまま訳して CLAUDE.md に置いてよい(@sumika45379 も同趣旨を共有)