🎯

目的のない実装が、一番高くつく

に公開

「あ、これもついでにやっといて」

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