シニアデベロッパーのClaude Max学習曲線：あいまいなプロンプトから構造化されたコードレビューへ

Claude Maxの初期利用経験

Node.js、Go、Angular、AWSに8年の経験を持つ開発者は、会社がClaude Maxの利用料金を支払い始めた時に使い始めました。最初の1週間は有望な結果を示しました：避けていたGoサービスの問題を説明すると、Claude Maxは「ファイル名を入力するよりも速く全体の骨組みを作成した」のです。

問題点：AIを上級エンジニアのように扱うこと

その後、開発者はClaude MaxにNode.jsサービスに通知機能を追加するよう依頼しました。AIは11ファイルにわたる380行のコードを生成しましたが、いくつかの問題がありました：

• ミドルウェア層を静かに再構築した
• 不要な依存関係を取り込んだ
• 開発者が異なる選択をしたであろう3つのアーキテクチャ決定を行った
• テストが合格したため、開発者は適切にレビューせずにコードをざっと見てマージしてしまった

開発者は気づきました：「私はAIを上級エンジニアのように扱っていました。曖昧な目標を渡し、私のプロジェクト、慣習、制限事項についての文脈を持っていると期待していたのです。AIにはそれがありません。ただ動き始めるだけです。」

解決策：構造的なレビュープロセス

開発者のアプローチを変えたもの：

• Claude Maxがすぐにコードを書き始めるのを止めた
• まず何をする計画かを説明させるようにした
• 実装前に範囲を合意した
• 大きな機能を一度に作るのではなく、小さな単位で構築した

開発者は指摘しました：「正直なところ、チームの新人開発者にやるのと同じことです。」このアプローチにより、明らかに良い結果が得られました：差分が小さくなり、予期せぬことが減り、実際に適切にレビューできるコードになりました。

重要な教訓

開発者はこのアプローチを学ぶのに3週間を費やし、AIコーディングアシスタントをプロジェクトの文脈を持つ人間のエンジニアのように扱うことが問題のある結果につながることを後から実感しました。新人開発者の指導に似た構造的なレビュープロセスは、本番作業により効果的であることが証明されました。