CLAUDE.md の目次に 3 行足したら、Claude の迷子が到達率 25%→100% になった

CLAUDE.mdの目次を3行追加しただけで、Claude Codeの迷子率が25%から100%に改善した事例。段階的開示の構成を見直すことで、情報到達率を向上させた効果を報告。

• Claude Codeのドキュメント構造（CLAUDE.mdと子ファイル）の機能性を、ログ解析により検証した。
• セッションログから、AIがどのファイルをどの順で読んだか（tool_use系列）とコンテキストサイズを復元可能。
• 「リリースタグの命名規則は？」という質問に対し、AIが正解ファイルに到達するまでのステップ数や余計な読み込み数を計測。
• AIがドキュメント構造を辿れない「迷子」モードを特定し、その原因が「遠回り」ではなく「目の前のファイルを見落とす」ことだと判明。
• ドキュメント構造の検証と改善には、計測環境の整備と、AIの挙動を疑う姿勢が不可欠である。