技術的負債はコードの中に溜まる。認知的負債は頭の中に溜まる。では、「なぜこの実装にしたか」という理由そのものが記録されていない状態——これをAddy Osmaniは"意図の負債"と呼ぶ。エージェントに仕事を任せるほど、この負債だけは効いてくる。
"意図の負債"という概念の中身と、なぜエージェント時代に唯一肩代わりできない負債になるのかの理由。そして今日から実行できる、意図を書き残す最小限の習慣。
技術的負債という言葉はもう馴染み深い。粗いコードや後回しにした設計判断が、コードそのものの中に残る。認知的負債はそれとは別の話で、自分の頭の中にある——コードが何をしているかの理解が、実際のコードから少しずつずれていく状態のことだ。
Addy Osmaniが指摘するのは、この2つとは別にもう1種類あるという点だ。意図の負債——目標・制約・「なぜこの形にしたか」という理由。これは書かれたことのない成果物の中に溜まる。運が良ければチームのドキュメントや議論に断片的に残っているが、たいていは不完全なままだ。
粗いコードの整理、テストの追加、リファクタリング——これらはエージェントが得意とする作業そのもの。人間がやるより速く片付けられる場面も多い。
「なぜこの実装を選んだか」が記録されていなければ、エージェントはコードから逆算で推測するしかない。推測は当たることもあるが、外れれば見当違いの変更を積み重ねる。
これが今回の核心。エージェントに任せる作業が増えるほど、コードそのものの負債は減っていく。だが「なぜそうしたか」を書き残す責任だけは、人間の側に残り続ける。むしろ、任せる範囲が広がるほどこの負債のコストは上がる。
大掛かりな設計文書である必要はない。むしろ小さく、その場で残すのが続くコツだ。
大掛かりな仕組みを整備しようとすると、たいてい続かない。理想の設計文書を書こうとする前に、今この瞬間の判断を1行だけ書き残す方を優先した方がいい。意図の負債は完璧な記録を目指すと挫折するが、断片の積み重ねなら誰でも続けられる。