tomu、AIエージェント開発向けテスト戦略解説──stmt等4指標100%カバレッジゲートを維持する運用法
Claude CodeやCodexが生成するコードの自己申告を排除し、stmtからlineまでの4指標100%を維持する実務運用ノウハウを公開した。
リリース: 2026-08-09 · 読了 4 分記事の要約
1. 核心（What）
- イベント予約・決済を扱うWebサービスリポジトリで、stmt・branch・func・lineの4指標100%のカバレッジゲートを運用している。
- 開発の主体をClaude CodeやCodexなどのAIエージェントに置き換えた状態で検証を実施した。
- CI設定の変更時に--coverageフラグが欠落し、閾値が評価されない事故が発生したため、再発防止策をSOPに組み込んだ。
- 検査スクリプト自体の追加もカバレッジ対象となるため、無駄なコード追加を抑制するアーキテクチャ判断の基準として機能している。
2. 影響（Why）
- AIエージェントの自己申告を排除する機械ゲート: 「テストを書いた」というAIの申告を人間が目視で確認するのは不可能なため、決定的な機械ゲートを置くことでエージェントの裁量を奪い、品質の担保を自動化できる。
- 国内SaaS開発チームにおける運用負荷の最適化: [国内Webサービス開発] 規模のチームでは、AIによる並行開発時のスタブ未更新やカバレッジ維持のコスト増加を防ぐため、基準を下げるのではなく計測タイミングの設計変更が必要になる。
3. 根拠・詳細（How）
- 到達不能なガードの削除手順: テストから到達できない分岐は、キャスト等で無理に覆わず呼び出し元を辿って削除する判断基準をSOP（標準手順書）化している。
- CIゲート自体の動作検証プロセス: CI設定変更時は意図的にuncoveredなコードを混入させ、ゲートが確実に落ちることを確認するミューテーションテスト的手法を導入している。
4. 展望・課題（Next）
- ラベル発火によるCI負荷の軽減: 毎pushからPR時のラベル付与へと計測タイミングを移行させており、完全な強制とのトレードオフをADR（アーキテクチャ決定レコード）に明記して運用を続ける。