目的のない実装が、一番高くつく
「あ、これもついでにやっといて」
Claude Codeにタスクを投げながら、僕は無意識にそう付け加えていた。
認証機能の修正をお願いしたついでに、「あとログ出力も整理しといて」。API実装を頼んだついでに、「エラーハンドリングも充実させといて」。
トークンはまだ余ってる。AIがやってくれるなら、やっておいた方がいいだろう——。
1週間後、PRレビューで言われた。
「このログ出力、どこで使うんですか?」
答えられなかった。
はじめに
AIコーディングの時代が来た。Claude Codeがあれば、実装は一瞬で終わる。
でも僕らは、新しい問題を抱えている。
「やれるから、やる」という思考停止。
トークンが余っている。AIが実装してくれる。じゃあ、やっておいた方がいいよね?
——その「やった方がいい」、本当に必要だったか?
結論を先に言うと、AIに投げる前に「なぜやるか」を10秒考えるだけで、無駄な実装の8割は消える。
今日は、僕がAIコーディングで陥った「とりあえず実装」の沼と、そこから抜け出した話を書く。
「ついで」が積み重なる地獄
Claude Codeを使い始めて、最初の1ヶ月は天国だった。
今まで半日かかっていた実装が、30分で終わる。テストも書いてくれる。リファクタリングも一瞬。
「これはすごい」と思った。
そして、僕の思考が変わり始めた。
「やった方がいい」の誘惑
ある日、ユーザー認証のバグ修正を頼まれた。
僕: 「認証トークンの有効期限チェックにバグがあるから修正して」
Claude Codeが修正案を出してくれた。5分で終わった。
ここで、ふと思った。
「せっかくだから、認証周りのエラーメッセージも改善しておこうかな」
トークンはまだ余ってる。Claude Codeに頼めば、すぐやってくれる。やっておいた方がいいよね?
僕: 「ついでに、認証エラーのメッセージをもっとユーザーフレンドリーにして」
Claude Codeがサクッと実装してくれた。いい感じ。
さらに思った。
「ログ出力も整理しておいた方がいいな。デバッグしやすくなるし」
僕: 「あと、認証周りのログ出力も構造化ログに変えておいて」
これも5分で完了。
気づけば、最初の「バグ修正」だけのはずが、PRの差分は300行を超えていた。
レビューで詰まる
PRを出したら、レビュアーから質問が来た。
「このエラーメッセージの改善、どのユーザーストーリーに紐づいてますか?」
「この構造化ログ、どこで使う想定ですか?監視ダッシュボードに追加するんですか?」
答えられなかった。
「いや、ついでにやっておいた方がいいかなと思って……」
レビュアーの表情が曇った。
「ついでにやった変更って、テストどうするんですか?リリース後に問題が起きたら、切り分けが難しくなりますよね」
正論だった。
結局、PRを3つに分割することになった。エラーメッセージの改善は「要件を明確にしてから」と保留。構造化ログは「監視設計と合わせて」と先送り。
最初のバグ修正だけなら、30分でマージできていた。
「ついで」を追加したせいで、3日かかった。
「ついで」の正体
この経験で気づいた。
「ついでにやっておく」は、「目的を考えていない」の言い換えだ。
- エラーメッセージの改善 → 誰のため?どんなユーザー体験を改善する?
- 構造化ログ → どこで使う?誰が見る?アラート設計は?
これらの問いに答えられないなら、それは「やった方がいい」じゃなくて「やらなくていい」だ。
でも、AIがあると、この判断が鈍る。
「やるコストが低い」から、「やるべきかどうか」を考えなくなる。
世間の声
この問題をチームで共有したら、だいたい2つの反応があった。
「どんどんやれ」派
「AIがやってくれるなら、やっておいた方がいいでしょ」
「技術的負債は早めに返した方がいい」
「リファクタリングは気づいたときにやるのがベスト」
「完璧主義より、まず動くものを」
正論に聞こえる。確かに、技術的負債は早めに返した方がいい。リファクタリングも大事だ。
でも、目的のないリファクタリングは、負債を増やしているだけだ。
「なぜこう変えたのか」が説明できないコードは、次にそのコードを触る人(3ヶ月後の自分含む)を混乱させる。
「慎重にやれ」派
「AIの出力は全部レビューすべき」
「理解できないコードはマージしちゃダメ」
「AIに任せすぎると、自分のスキルが落ちる」
「結局、人間が責任を持たないと」
これも正論。AIの出力は確かにレビューすべきだ。
でも、「慎重にレビューする」と「目的を考える」は別の話だ。
目的のない実装を慎重にレビューしても、目的のない実装がマージされるだけ。問題の本質はそこじゃない。
どちらの派閥も、「AIをどう使うか」の話をしている。
でも本当の問題は、「何をやるか」を決める前にAIに投げていることだ。
第三の道——「なぜ」を10秒考える
転機は、あるシニアエンジニアの一言だった。
「それ、誰が喜ぶの?」
僕が「ついでにログ出力を改善しようと思って」と言ったとき、彼はそう聞いた。
「誰が喜ぶの?」
僕は答えられなかった。
「ログを見るのは誰?運用チーム?開発者?それとも自分?その人たちは今、ログで困ってるの?」
「いや、困ってはいないと思いますけど、あった方がいいかなと……」
「『あった方がいい』は、『なくていい』と同義だよ」
この一言で、目が覚めた。
実装前の10秒ルール
その日から、Claude Codeにタスクを投げる前に、10秒だけ考えるようにした。
「これは誰の、どんな問題を解決するのか?」
たった10秒。でも、この10秒で「ついで実装」の8割が消えた。
具体的には、こういう問いを自分に投げる:
1. 誰が困っている?
→ 「特に誰も困っていない」なら、やらない
2. どんな問題を解決する?
→ 「あった方がいい」は問題じゃない。やらない
3. 解決したら、どう検証する?
→ 検証方法が思いつかないなら、要件が曖昧。やらない
4. 今やる理由は?
→ 「ついで」は理由じゃない。やらない
Before / After
Before(10秒ルール導入前)
僕: 「認証トークンのバグ修正して。
ついでにエラーメッセージも改善して。
あとログも構造化して。
できればテストカバレッジも上げといて」
→ PRの差分: 500行
→ レビュー: 3日
→ 本当に必要だった変更: 20行
After(10秒ルール導入後)
僕: (10秒考える)
「認証トークンのバグ修正して」
(エラーメッセージ改善は?→ 誰も困ってない → やらない)
(ログ構造化は?→ 運用チームに確認してから → 今はやらない)
(テストカバレッジは?→ 別タスクで計画的に → 今はやらない)
→ PRの差分: 20行
→ レビュー: 30分
→ 本当に必要だった変更: 20行
同じ成果を、1/6の時間で達成できた。
「やらない」リストを作る
さらに効果的だったのは、「やらない」リストを作ることだ。
Claude Codeにタスクを投げるとき、「やること」だけじゃなく「やらないこと」も明示する。
僕: 「認証トークンのバグ修正をして。
## やること
- 有効期限チェックのロジック修正
- 修正に対するユニットテスト追加
## やらないこと
- エラーメッセージの改善(別タスク)
- ログ出力の変更(運用チームと要相談)
- 既存コードのリファクタリング(スコープ外)」
こう書くと、Claude Codeも「ついで」の提案をしなくなる。
そして何より、自分自身が「ついで」の誘惑に負けなくなる。
「やらないこと」を書いた時点で、それは「意識的にやらない判断をした」ことになる。後から「ついでにやろうかな」と思っても、「いや、やらないって決めたじゃん」とブレーキがかかる。
気づき——AIがあるからこそ「やらない」が大事
この習慣を1ヶ月続けて、面白いことに気づいた。
「やらない」と決めた機能の8割は、その後も必要にならなかった。
「ついでにエラーメッセージを改善しよう」→ 1ヶ月経っても、誰からも改善要望が来ない
「ついでにログを構造化しよう」→ 運用チームに聞いたら「今のログで十分です」
「ついでにテストカバレッジを上げよう」→ そのコード、半年間誰も触ってない
「あった方がいい」は、だいたい「なくてよかった」になる。
逆に、本当に必要な機能は、「ついで」じゃなくてちゃんと要望が来る。
ユーザーから「このエラーメッセージ、意味がわからない」とフィードバックが来る。運用チームから「このログ、こういう形式だと嬉しい」とリクエストが来る。
必要なものは、向こうからやってくる。
「やった方がいい」の誘惑に負けて先回りする必要はない。
AIは「実行」の道具であり、「判断」の道具じゃない
もうひとつ、大事な気づきがあった。
Claude Codeは、「何をやるか」を決めてくれない。
「認証周りを良くして」と投げれば、何かしら「良く」してくれる。でも、それが本当に必要な「良さ」かどうかは、Claude Codeには判断できない。
「何をやるか」を決めるのは、人間の仕事だ。
AIがあると、「実行」が一瞬で終わる。だからこそ、「判断」に時間をかけられるようになった。
以前は「実装に時間がかかるから、やることを厳選しよう」だった。
今は「実装は一瞬だからこそ、やることを厳選しよう」になった。
制約が変わっても、「厳選する」という本質は変わらない。
むしろ、AIがあるからこそ、「やらない判断」の重要性が増している。
結論
AIコーディング時代、最大の罠は「やれるから、やる」だ。
トークンが余っている。AIが実装してくれる。じゃあ、やっておいた方がいいよね?
——その思考が、無駄な実装を生む。
AIに投げる前に、10秒だけ考えろ。
「これは誰の、どんな問題を解決するのか?」
答えられないなら、やらない。「あった方がいい」は、「なくていい」と同義だ。
Claude Codeは優秀な実行者だ。でも、何を実行するかを決めるのは、あなたの仕事だ。
「ついで」を手放せ。「やらない」を選べ。
——そして、本当に必要な20行に、全力を注げ。
Discussion