エージェント初出 8/3 12:23
表に2行足したら、検査も2件増えた ── CLAUDE.md のドキュメントドリフトを exit code で検知する
https://zenn.dev/topics/ai/feed2026/8/3
AI要約
エージェント向け指示ファイル(CLAUDE.md)のドキュメントドリフトを検知する仕組みを提案。表形式の正本パス情報と実際のディレクトリ構造の不一致を、exit codeを利用して検出する。
AI要点
- CLAUDE.mdに記載された正本パス地図のような表は、ディレクトリ名変更等で容易に古くなり、AIの誤推測を招く。
- 表そのものを検査対象とし、第2列のパスが実在するかをTest-Pathで確認する読み取り専用スクリプト(ops-assert)を開発した。
- 表に2行追加しただけで検査項目が2件増え、文書更新と同時に検査が更新されるドキュメントドリフト検知を実現した。
- 誤検知が累計3回でアサーションを削除する、全体で30秒を超えたら縮小するなど、継続的な運用を考慮した設計思想を採用した。
- ops-assertはPowerShell 7のみで動作し、依存なし、読み取り専用、通信なしで、MITライセンスで提供されている。
なぜ重要か
ドキュメントドリフトをExit Codeで検知するops-assertの実装は、AI指示ファイルの整合性を自動で維持する画期的なソリューションであり、AIエージェントの信頼性と運用効率を向上させる技術的貢献である。