Codex×AGENTS.md×MCPで大規模リポジトリのバグ修正精度を高める実装ガイド

• URL: https://zenn.dev/0h_n0/articles/ff39679e7b4b27
• 日付: 2026-06-23
• Tier: Tier 3
• 要旨: Codex Subagents と AGENTS.md＋MCP で大規模リポジトリのバグ修正精度を向上。静的指示（AGENTS.md）と動的コンテキスト（MCP）の併用で、ランタイム 28.64% 削減、性能 30～80% 改善を実現。

詳細

AGENTS.md は効率を改善（ランタイム -28.64%、出力トークン -16.58%）だが成功率が 3% 低下する矛盾がある。人間が書く AGENTS.md は最小限の要件のみに限定すべき（150-200 行以内、自動生成は避ける）。テストコマンド、非自明なアーキテクチャ決定、禁止事項の 3 カテゴリに絞る。MCP（Model Context Protocol）で Filesystem・Context Engine・Sentry・GitHub・Context7 など 5 つのサーバーを組み合わせてバグ修正時のコンテキスト取得を自動化。Codex Subagents の Explorer（読取専用、コンテキストマップ構築）→ Worker（読み書き、修正実行）パターンでバグ修正精度向上。モノレポでは階層型 AGENTS.md 設計（ルート・サービス・パッケージ層）で 32KiB 制限対応。静的指示＋動的文脈のハイブリッド戦略構築。