概要
AI Agentが開発に参加する時代において、ドキュメントの「腐敗」を防ぎ効率的に活用するための二層構造（作業記憶/長期記憶）と機械的な管理手法（harness/auditor）について考察した記事。
詳細内容
本記事は、Claude CodeやCodexなどのCoding Agentが開発ワークフローに組み込まれる中、ドキュメントが果たすべき役割とその管理手法を再定義しています。筆者は、ドキュメントを「コードから導出可能」「検証可能」「不変の記録」「還元不能な知識」の4つに分類し、Agentにとってはコードから導出できない「Why（背景）」や「Why not（却下理由）」こそが重要であると指摘。具体的な運用案として、CLAUDE.md（常時注入される作業記憶）とdocs/adr（オンデマンドの長期記憶）の二層構造を提案しています。さらに、ドキュメントの鮮度を保つためのcheck-doc-freshness.sh（PreToolUse hookでの自動チェック）や、Agentの行動への貢献度（ROI）を評価するdocs-auditorなど、ドキュメントに「harness（検定器具）」をかけてフィードバックループを閉じる実践的なアプローチが紹介されており、AI協働時代のエンジニアリングにおける示唆に富む内容となっています。