AI エージェント時代にソースコード以外の何を残すべきか

AIコーディングエージェントが開発に組み込まれると、「何を資産として残すべきか」という問題が生じる。ソースコードは当然だが、それだけでは不十分な場合がある。人間がソースコードをほとんど直接編集せず、仕様やテストやプロンプトを変更してAIに実装を更新させている場合、実際に変更しているのはコードそのものではなく、その上流にある指示や仕様だからだ。

AGENTS.mdというファイルは、単なる説明文ではなく、GitHubのAIエージェントが毎回読み込む実行指示になる。「後方互換性を維持する」という条件が仕様書にしか書かれていなければ、その文書はAIの実装結果を直接拘束している。テストコードが期待する振る舞いを機械的に判定しているなら、テストも変更工程の一部である。将来の開発者がこれらを失うと、次の変更でAIが同じ制約に従わなくなり、開発工程そのものが変わってしまう。判断基準は「この情報を失うと、次の変更で何ができなくなるか」である。

プロンプトや対話履歴をすべて保存すべきではなく、実装結果を拘束する設計判断や制約条件をどこに記録するかが重要だ。ソースコード、テスト、ドキュメント、エージェント指示など、最適な場所に分散させて、引き継ぎに必要な情報を再構成できる状態を保つことである。AI時代の開発資産は「コードだけでいい」という時代は終わった。何が実装を決めているかを明確にすること自体が、保守可能性の鍵になる。