※この記事は、2026年7月時点の自分のAI運用メモです。固有のツール名や内部仕様は伏せ、AIに個人開発を手伝ってもらう中で起きたことだけを書いています。
最近、AIに自作ツールの改善を手伝ってもらっています。
設計を整理してもらう。
コードを書いてもらう。
テストを回してもらう。
別のAIにレビューしてもらう。
この流れを繰り返していると、自分一人では進められなかったところまで形になっていきます。
ただ、先日その内容を確認している時、AIがある内部名称を当然のように使っていました。
最初は、以前の会話で自分が決めた名前を忘れているのかと思いました。
ところが、よく考えても決めた覚えがありません。
思わず、「それ、いつの間に名前が付いたん？」となりました。
コードが増えていたことには気をつけていました。
でも、AIが作業の途中で新しい名前や分類まで増やすことには、あまり注意を向けていませんでした。
名前が付くこと自体は悪くない
最初に書いておくと、AIが内部の仕組みに名前を付けること自体が悪いとは思っていません。
複数の処理や判定要素を一つの名前でまとめれば、会話は短くなります。
設計書にも書きやすくなります。
後から別のAIへ作業を渡す時にも、毎回長い説明を繰り返さずに済みます。
人間が開発する場合でも、機能や処理のまとまりに名前を付けるのは普通だと思います。
問題は、名前が付いたことではありません。
その名前の意味を、持ち主である自分が知らないまま話が進んでいたことです。
AI同士では意味が通っていても、自分だけが途中から会話に入った人のようになっていました。
名前が残ると、いつの間にか仕様のように扱われる
内部名称は、ただの呼び方で終わらないことがあります。
一度名前が付くと、その言葉が設計書に入ります。
テスト名やファイル名に使われることもあります。
次の改修を頼む時には、AIが「すでに合意された前提」として扱うかもしれません。
さらに別のAIへレビューを頼んでも、資料の中にその名前が残っていれば、同じ前提を引き継いで話を進めます。
こうなると、最初はAIが整理のために付けただけの名前でも、少しずつ正式な仕様のようになっていきます。
後から意味を変えたり、名前を消したりしようとすると、どこまで影響するのか分かりにくくなります。
コードが動いているかだけを確認していても、この変化は見落とします。
自分で説明できない言葉が増えるのは少し怖い
以前、AI生成コードを全行読めない自分なりに、目的、入出力、変更差分、テスト、未確認事項、リスク、戻し方を確認する記事を書きました。
この検査工程は今も必要だと思っています。
ただ、今回気づいたのは、その項目だけでは足りないということでした。
コードの中身を全部説明できなくても、何をする機能なのかは説明できるようにしておきたい。
ところが、機能を説明するための言葉までAI側で増え、自分が意味を知らなければ、それも難しくなります。
「この仕組みは何をするのか」と聞かれた時、AIが作った内部名称をそのまま読み上げるだけになる。
それでは、自分のツールなのに、自分の言葉で説明できているとは言いにくいです。
バグがなくても、テストが通っていても、理解の差は少しずつ広がります。
変更報告に「新しく増えた名前」も入れたい
今後は、AIに改修を頼んだ後の変更報告へ、コードやテストだけでなく、新しく増えた名前も入れたいと考えています。
確認したいのは、次のような内容です。
- 今回、新しい名称や略称を追加したか
- その言葉は何を指しているのか
- なぜ既存の言葉では足りなかったのか
- どのファイル、設計書、テストで使っているのか
- 仮の呼び名なのか、今後も使う正式名称なのか
難しい説明は要りません。
自分が後から見て、一文で意味を思い出せる程度で十分です。
名称が必要なら採用する。
分かりにくければ変える。
既存の言葉で足りるなら増やさない。
この判断を、名前が広がる前に挟みたいです。
AIに命名案は出してもらっても、確定は自分で行う
AIは、複雑な処理を整理して短い名前へまとめるのが得意です。
だから、命名まで全部人間がやる必要はないと思います。
候補を出してもらうのは助かります。
ただし、AIが名前を使い始めた時点で確定とするのではなく、一度こちらへ戻してもらう。
意味を確認し、自分が説明できる名前を選んでから、設計書やテストへ反映する。
この一手間があれば、AIの整理力を使いながら、知らない言葉だけが増えていく状態は避けやすくなりそうです。
AIにツールを育ててもらう時、確認すべきなのはコードだけではありませんでした。
AIが何を作ったか。
どう確認したか。
そして、その仕組みを何と呼ぶことにしたのか。
自分のツールとして使い続けるなら、自分が説明できる言葉で管理するところまでは握っておきたいと思います。
コメント