エージェントがコードベースを理解しやすくするためのTips

ソースコードを”信頼できる唯一の情報源”にするコンテンツがCMS等に分散してるなら、コードに移すか、MCP / CLI / Skillを使いエージェントから読めるようにする
エージェントが自分の作業を検証できる状態にする型付き言語・速くて質の高いテスト・正しく設定されたlinter。エージェントが自分で正しさを確かめられるようにする
簡潔で効果的なAGENTS.mdを用意する毎メッセージに含まれる前提で書く。モデルは賢くなったので自明なことは省略してOK（tests は /testsにあるなど）。またモデルにコードベース内を探させて、期待通りの返答が得られなければ、リファクタを検討する。
自動化で”自走するコードベース”にするリファクタ提案・レビューで漏れたセキュリティ問題の検出や継続的なドキュメント化を仕込めば、寝てる間にコードベースが自動的に良くなっていく。