バイブコーディングで失敗しないコツ【急がば回れ】

最初に聞いた時はなんやねんそれ！と思ったが、もはや定着しつつある手法。
若干懐疑的ながらも、俺も仕事で専門外のことを対応する場合は結構お世話になっている。
（具体的には、俺は普段インフラエンジニアだけど、時々フロントやバックエンドの修正や機能追加を担当している）

今回は、そんな俺の経験の中でバイブコーディングでうまく開発をするためのコツを紹介する。

ちなみに、ここでの”失敗”の定義は、
「せっかくのバイブコーディングなのに結局通常のコーディングと同等あるいはそれ以上の時間がかかっている」
「成果物は要件を満たしているが全体の整合性が取れていない」
とする。

また、俺が使用したIDEは Cursor, Antigravity, Kiro の3つ。
無課金なのでクレジットが尽きるごとにグルグル3つを使い回している。（スイマセン）

バイブコーディングで失敗しないコツ

「AIを先生にする」コードレビューの徹底

コーディング後にきちんとレビューして、自分がわからないところは素直に聞く

AIが生成したコードについて、都度自分の中でレビューをする。
結構当たり前なことを言っているかもしれないが、AIがあまりにもポンポンとコードを生成するのでおざなりになりがち。

大切なのは自分がコードの中身を理解していること。
コードの中でわからないところ（具体的には、処理の内容や実装の意図）があれば、AIにどんどん質問しよう。

わからないところはきちんと潰しておくことも非常に大切。
バイブコーディングが仮に一般的なコーディング方法として定着したとしても、やはり最後のコードレビューは人がやる。
バイブコーディングの機会をその場の問題解決で終わらせるか、きちんと毎回わからないところを教えてもらって自分の糧にしていくか、長期的にエンジニアとしてやっていくなら言わずもがな。

「スモールステップ」で指示を出す

できるだけ差分が少なくなるように、指示を小分けにする

これは賛否が分かれるかもしれない。
プロンプトを作り込んで一気に要件を伝えて全てコードを作るスタイルに人は一定数いると思うが、俺はどちらかと言えば小出しで進めるスタイル。

というのも、一気にコードが生成されても自分がコードレビューができないから。
さっきも言った通り、大切なのは自分がコードの中身を理解していること。
そのためには、いきなりドカッと全部のコードを読んで理解するのは正直難しい。

できるだけ差分が少なくなるように、要件は小出しにプロンプトに入力する。
そうすることで、コードレビューも少しずつでも着実に進めることができる。

また、小出しにすることで、AIがたまにおかしな方向へ進んで行った時にも対応できる。
おかしな方向へ進んでいることがすぐにわかるし、軌道修正もすぐにできる。
結果的に全体の工数が短くなっていると俺は感じる。（実際に計測したことはない）

儀式としての「コンテキスト共有」

最初にプロジェクトの読み込みを支持する（おまじない？）

若干おまじないに近いかもしれないが、俺は毎回最初のプロンプトにプロジェクト全体を読み込むように指示をする。

一からプロジェクトを作る場合は関係がないかもしれないが、実務的にはやはり既存のコードに手を加える機会の方が多いと思う。

そんな時、いきなり「〇〇の機能を追加してください」と要件を入力するのではなく、「このプロジェクト全体を読み込んでください」と先頭に付け加えておくのが大事。

俺がよく最初のプロンプトは、プロジェクト全体の読み込みと概要を伝えてもらうこと。
それで全体感を自分が理解したら、コーディングをスタートする。

まとめ | 急がば回れの精神

というわけで、俺なりのバイブコーディングで失敗しないコツを紹介した。
要するに一言で言えば「急がば回れ」の精神で、AIの生成スピードに翻弄されず長期目線で自分の理解を優先して進めるのがおすすめ。