AIで作ったコードが「直せない」理由:技術的負債の積み上がり方
AIと一緒に作り始めた最初の数日は、驚くほど速く進みます。ところが、しばらくすると「1か所直すと、別のところが壊れる」「AIに直してと頼むと、前に直したところが元に戻る」といったことが起き始めます。これが技術的負債です。
技術的負債とは
目先の速さを優先した結果、後で直すコストが積み上がっていく状態を、借金にたとえた言葉です。少しの借金は悪いことではありませんが、返さずに放っておくと利息がふくらみ、身動きがとれなくなります。
バイブコーディングでたまりやすい理由
同じ処理が何か所にもできる
AIは、頼まれるたびにその場で新しいコードを書きます。似た処理が別々の場所に少しずつ違う形で作られ、片方だけ直して不具合が残る、ということが起きます。
全体の設計がない
「ここにボタンを追加して」「この画面も作って」と部分ごとに頼んでいくと、全体として筋の通った設計になりません。
AIが全体を覚えていない
コードが大きくなると、AIが一度に見られる範囲を超えます。すると、前に決めたルールと違う書き方をしたり、すでにある機能をもう一度作ったりします。
作った本人も中身を知らない
人が理解していないコードは、人が直すこともできません。AIに頼るしかなくなり、AIが迷うと、誰も直せない状態になります。
ため込まないための習慣
- 最初に決まりごとを書く:使う言語、フォルダの分け方、名前の付け方を短い文書にまとめ、AIにも毎回読ませます。
- 機能を足す前に整理する:「新しい機能の前に、似た処理を1つにまとめて」とAIに頼む時間を、定期的にとります。
- 小さな単位で保存する:Gitなどで変更を細かく記録しておくと、壊れたときに戻れます。
- 説明を求める:AIが書いたコードについて、「なぜこう書いたのか」を説明してもらい、自分でも理解しておきます。
- テストを書いてもらう:直した場所以外が壊れていないかを、自動で確かめられるようにします。
「捨てて作り直す」も選択肢
試作品として作ったものは、思い切って作り直すほうが早いこともあります。AIを使えば作り直しのコストも下がるので、「試作は捨てる前提」と割り切るのも一つの方法です。
まとめ
AIは借金を作るのも速いですが、返すのを手伝うこともできます。機能を足すだけでなく、整える時間をとることを習慣にしましょう。
