はじめに
最近では、AIを活用してコードを書くことが当たり前になってきた。
私自身も、機能実装のスピードを上げるために AI の力を借りることが多い。
しかし、いくつかの経験を通して気づいたことがある。
問題だったのは「AI がコードを書いたこと」ではなく、
そのコードがシステム全体の中でどんな役割を持っているのかを、十分に理解しないまま使っていたことだった。
この記事は、その過程で経験した失敗と、
それをきっかけにコードの見方がどのように変わったのかを整理した記録である。
「動いているコード」が安全とは限らない
AI が生成したコードやサンプルコードをそのまま使ったとき、
一見すると問題はなさそうに見えた。
- エラーは出ない
- 画面も正しく表示される
- API のレスポンスも想定どおり返ってくる
そのため、私はそのコードを「問題のないコード」だと判断していた。
しかし時間が経つにつれて、
まったく想定していなかった箇所で問題が起きるようになった。
- サーバー側で意図しない値が扱われていたり
- 以前は正常に動いていた機能が、気づかないうちに壊れていたり
共通していたのは、
コードの流れを理解しないまま修正・利用していたという点だった。
だからこそ、コードの流れを理解する必要がある
私は「このコードが今何をしているか」は見ようとしていたが、
「このコードがどこから始まり、どこまで影響するのか」については、
十分に考えられていなかった。
例えば、次のような流れである。
- ユーザーの操作がどんなイベントを発生させ
- そのイベントがどの API を呼び出し
- サーバーでどんなロジックを通り
- どんなレスポンスとして返ってきて
- その結果が再びどんな状態を変更するのか
この一連の流れを頭の中で描けないまま、
部分的な理解だけでコードを修正していた。
流れを理解するために、考え方を変えた
同じような問題が繰り返し起きたことで、
「より速くコードを書くこと」よりも
「一度で全体の流れを理解すること」の方が重要だと感じるようになった。
それ以降、機能を修正する際には
次のような順序で流れを整理するようにしている。
1. フロントエンドで起点を確認する
- ユーザーのどんな操作がトリガーになっているのか
- そのイベントハンドラはどこにあるのか
2. API 呼び出しを境界として考える
- どんなデータがサーバーに送られているのか
- この API はどんな責務を持っているのか
3. サーバーサイドの処理を追う
- Controller → Service → DB
- 値はどこで生成・変換されているのか
- バリデーションはどこで行われているのか
4. 再びフロントへ戻る流れを確認する
- レスポンスはどこに保存されるのか
- 既存の状態にどんな影響を与えるのか
カラムの意味を知らずに使うことの危険性
AI が生成したコードやサンプルでは、
レスポンスが次のような形で示されることが多い。
{
"id": 1,
"status": "active",
"created_at": "2025-01-01"
}
このデータを見て、
私は単純に「status の値で分岐すればいい」と考えていた。
しかし実際には、次のような点を確認していなかった。
- この status はどのテーブルのカラムなのか
- どんな条件で値が変更されるのか
- なぜこのプロジェクトではこの値が必要なのか
こうした背景を理解しないままコードを書くと、
フロントエンド側の分岐ロジックは簡単に破綻してしまう。
データ構造を意識して見えるようになったこと
データベースを「詳しく知ろう」としたというより、
なぜこのプロジェクトではこの構造が選ばれているのかを
意識するようになってから、次のような点が見えるようになった。
- なぜこの API はすべてのカラムを返さないのか
- なぜ別のテーブルではなく、このテーブルを基準にしているのか
これは単なる DB 知識の問題ではなく、
プロジェクトの設計意図を理解しているかどうかの問題だと感じた。
AI との向き合い方も変わった
これらの経験を通して、
AI の使い方も少しずつ変わってきた。
生成されたコードをそのまま貼り付けるのではなく、
処理の流れを説明してもらい、
他のロジックにどんな影響が出る可能性があるのかを確認する。
AI は今でも非常に強力なツールだが、
そのコードをシステムに組み込む責任は開発者にあると考えるようになった。
おわりに
今でも、すべての流れを一度で完璧に理解できるわけではない。
失敗することもまだ多い。
それでも、コードを修正するたびに
「この変更はどこまで影響するのか？」と
一度立ち止まって考えるようになったことは、
自分にとって大きな変化だった。
これからは、
機能を実装すること以上に、
コードの流れを理解することを
より重視していきたいと思う。
Discussion