バイブコーディングは、一度の指示で完成品ができあがるものではありません。AIとの対話を何度も繰り返しながら、少しずつ試作を望む形に近づけていく作業です。この「繰り返しの進め方」自体にもコツがあり、知っているかどうかで作業の効率が大きく変わります。
この記事では、AIとの対話を繰り返して試作を改善していく、基本的な進め方を解説します。
この記事で分かること
試作を改善していく作業は、「1回の指示で完璧を目指す」のではなく、「小さな確認を繰り返しながら、着実に前進する」という考え方が基本になります。この記事では、その繰り返しの中で意識したい進め方の型を紹介します。
結論を先に示すと、意識したい進め方は次の3つです。
- 一度に直す範囲を小さく保つ
- 良くなった部分と、まだ課題がある部分を分けて記録する
- 同じ問題が繰り返し起きたら、根本的な原因を疑う
一度に直す範囲を小さく保つ
試作を改善していく中で、多くの人が陥りやすいのが、一度の指示で複数の問題をまとめて直そうとすることです。「AとBとCの問題を直してください」とまとめて依頼すると、AIがどの問題から着手すべきか、優先順位を判断しにくくなり、結果として一部の問題しか解決されなかったり、意図しない別の変更が加わったりすることがあります。
改善は、1つの指示につき1つの問題に絞ることをおすすめします。時間はかかるように感じますが、1つずつ確実に直していくほうが、結果的に手戻りが少なく、効率的に進みます。
まとめて依頼したときに起きやすい失敗パターン
複数の問題を一度に伝えると、具体的にはどのようなことが起きるのでしょうか。よくある失敗パターンを3つ紹介します。
- 一部の問題だけが直り、残りが忘れられる：AIは指示の中で最も分かりやすい問題、あるいは最初に書かれた問題から着手する傾向があります。結果として、後半に書いた問題が対応漏れになりやすくなります。
- 問題同士が干渉し、意図しない変更が発生する：AとBを同時に直そうとすると、Aの修正のためにBに関係するコードまで書き換えられてしまい、Bの症状が変わってしまうことがあります。原因の切り分けが難しくなります。
- 結果を確認するときに、何を確認すればいいか分からなくなる：3つの問題を一度に依頼すると、直った後の確認作業も3つ同時に行うことになります。どの問題が原因でどの現象が起きているのかを見分けにくく、確認の精度が落ちます。
これらの失敗は、いずれも「範囲を小さく保つ」というルールを徹底するだけで避けられます。急いでいるときほど、まとめて依頼したくなる気持ちは自然なものですが、急いでいるときこそ、遠回りにつながる依頼をしていないか、一度立ち止まって確認する価値があります。
例外的に、まとめて伝えたほうがよい場合
ただし、すべての場合において「1指示1問題」が絶対というわけではありません。例えば、同じ原因から発生している複数の症状であれば、まとめて伝えたほうが、AIが根本原因に気づきやすくなることがあります。
「一覧の並び順がおかしい」と「合計金額の表示がずれている」という2つの症状が、実は同じ日付データの扱いの誤りから発生している場合、これらを分けて伝えると、AIはそれぞれ個別の対処をしてしまい、根本原因にたどり着けないことがあります。このような場合は、「一覧の並び順と、合計金額の表示がどちらもおかしい。関連している可能性はあるか」とまとめて伝え、AIに関連性を検討してもらうのも一つの方法です。
見分け方の目安は、「症状の間に関連がありそうか」です。関連が不明な複数の問題は分けて伝え、関連が疑われる複数の症状はまとめて伝えて原因の調査を依頼する、という切り分けを意識すると、より効率的に進められます。
良くなった部分と、まだ課題がある部分を分けて記録する
対話を繰り返す中で、「これは解決した」「これはまだ課題が残っている」という状態を、自分の中で整理しておくことも重要です。口頭やメモ帳などに、簡単なリストとして残しておくとよいでしょう。
- 解決済み：入力した内容が一覧に表示されるようになった
- 課題：一覧の表示順が、意図した順番と逆になっている
このように整理しておくことで、次にAIへ指示を出す際、「前回解決した部分は変更しないでください」と伝えやすくなり、既に直った部分を意図せず壊してしまうリスクを減らせます。
記録の具体的なやり方
記録の方法に厳密な決まりはありませんが、続けやすい形にしておくことが大切です。おすすめの型を3つ紹介します。
- メモ帳やテキストファイルに、解決済み・課題を2つの見出しで分けて書く：最も手軽な方法です。日付とあわせて記録しておくと、後から見返したときに、どのくらいのペースで進んでいるかも分かります。
- チャット履歴の該当箇所に、自分用の目印を残す：「ここで解決」といった一言を自分の発言として残しておくと、後から履歴をさかのぼって確認しやすくなります。
- 画面のスクリーンショットに、簡単な注釈を加えて保存する：見た目に関する課題は、テキストだけでは伝わりにくいことがあります。スクリーンショットに矢印や丸で注釈を加えておくと、後で見返したときも、AIに再度説明するときも役立ちます。
大がかりな管理ツールを用意する必要はありません。むしろ、記録すること自体が目的化して手間になってしまうと、本来の改善作業が滞ってしまいます。数行のメモで十分なので、「続けられる最小限の記録」を意識してください。
記録がないとどうなるか
記録を取らずに対話を続けると、次のような問題が起きやすくなります。
- 前回直したはずの部分について、AIに再度「直してください」と依頼してしまい、すでに正しく動いている部分に余計な変更が加わる
- 「結局、今どこまで進んでいるのか」を自分自身が把握できなくなり、優先順位をつけられなくなる
- 家族やパートナーなど、進捗を共有したい相手に、状況を説明しにくくなる
特に1つ目は実害が大きいパターンです。すでに解決している問題を「まだ直っていない」と誤解して再依頼すると、AIは新たにその部分のコードに手を入れることになり、正常に動いていた挙動が変わってしまう可能性があります。記録さえあれば、この種の事故はほとんど防げます。
同じ問題が繰り返し起きたら、根本的な原因を疑う
同じような問題を、何度直してもまた発生する、という状況に出会うことがあります。この場合、表面的な対処を繰り返すのではなく、根本的な原因が別のところにあるのではないかを、AIに直接尋ねてみることをおすすめします。
「この問題は3回目の発生です。表面的な対処ではなく、根本的な原因を教えてください」というように、繰り返し発生している事実を伝えると、AIがより深い部分の原因を検討してくれることがあります。同じ対処を繰り返すだけでは解決しない問題も、この一言で解決の方向が見つかることがあります。
なぜ「繰り返し発生」というだけで対応が変わるのか
AIとの対話は、基本的に直近の指示に強く影響されます。単に「これを直してください」と伝えると、AIは目の前の症状に対する、最も手早い対処を提案しがちです。これは多くの場合、症状そのものを止める対処であって、症状が生まれる原因を取り除く対処ではありません。
一方で、「これは何度も発生している」という文脈を伝えると、AIは「これまでの対処では不十分だった」という前提から考え直すことになり、より広い範囲のコードや設計を見直す方向で検討してくれる可能性が高まります。同じ言葉で依頼しても、伝える文脈によって、AIの検討する深さが変わるということを覚えておくとよいでしょう。
繰り返し発生に気づくための小さな工夫
「同じ問題が繰り返し起きている」ことに気づくためには、前述の記録が役立ちます。課題のリストに、同じ内容の項目が何度も登場していないかを、定期的に見返す習慣をつけておくと、繰り返し発生に早めに気づけます。
目安として、同じ症状、または似た症状が3回以上記録に登場した場合は、根本原因を疑うタイミングと考えてよいでしょう。逆に、1〜2回程度であれば、単純な見落としや、指示の伝え方の問題である可能性も高いため、必ずしも根本原因を疑う必要はありません。
改善が「後退」しているように見えるときの見分け方
対話を繰り返す中で、「前より悪くなった気がする」と感じる場面が出てくることがあります。これが本当の後退なのか、それとも一時的な変化なのかを見分けることも大切です。
見分け方の目安は、「以前できていたことが、今もできているか」を具体的に確認することです。感覚的に「悪くなった」と感じても、実際に1つずつ機能を確認すると、多くの場合は新しい機能を追加した副作用として、一部の表示が変わっただけで、機能自体は失われていないことがあります。反対に、実際に以前できていたことができなくなっている場合は、その部分を明確に指摘して、元の状態に戻す指示を出す必要があります。
感覚だけで判断せず、具体的な動作を1つずつ確認する習慣をつけておくと、本当に対処が必要な後退と、印象だけの後退を区別しやすくなります。
「本当の後退」と「印象だけの後退」の見分け方チェックリスト
判断に迷ったときは、次のチェックリストを使って確認してみてください。
- [ ] 以前できていた操作を、実際に1つずつ手順どおりに試してみたか
- [ ] エラーメッセージが表示されているか、それとも見た目や配置が変わっただけか
- [ ] 変更したのはどの機能で、今「悪くなった」と感じているのはどの機能か（同じ機能かどうか）
- [ ] 直前の指示内容を振り返り、今回の変更が関係しそうな範囲かどうか
- [ ] 別のブラウザや別の端末で確認しても、同じ現象が起きるか
このチェックリストの前半3つで「はい」に近い答えが出れば、印象だけの後退である可能性が高いです。逆に、エラーが出ている、または操作自体ができなくなっている場合は、本当の後退として対処が必要です。
後退を見つけたときの伝え方
本当の後退だと判断できた場合、AIへの伝え方も重要です。「なんか変になった」というあいまいな伝え方では、AIも何を直すべきか判断しにくくなります。次のような伝え方を意識してください。
- いつまで正常に動いていたか：「3つ前の指示までは、この操作ができていました」
- 今、具体的に何が起きているか：「今は、ボタンを押してもエラーが出て、一覧に追加されません」
- 心当たりがある場合は、その変更点：「直前に一覧の並び替えを依頼したので、そこが関係しているかもしれません」
これらを伝えることで、AIは変更履歴の中から該当する箇所を絞り込みやすくなり、遠回りの調査をせずに直接原因にアプローチできます。
改善のサイクルをどう回すか
具体的な作業のサイクルとして、次の順番で進めると、対話が整理された状態を保ちやすくなります。
- 今の状態を確認する（画面を見て、動いている部分と動いていない部分を把握する）
- 直したい部分を1つ選ぶ（複数の課題がある場合は、優先順位の高いものから）
- 具体的に指示を出す（「今の状態」と「望む結果」を対比させて伝える）
- 結果を確認する（意図した通りに直ったか、他の部分に影響が出ていないかを確認する）
- 1に戻る
このサイクルを繰り返すことで、一歩ずつ確実に試作が前進していきます。焦って複数のステップを一気に進めようとすると、逆に混乱しやすくなります。
サイクルの各ステップで意識したいこと
サイクルの5つのステップは、それぞれ短時間で終えられるものですが、意識するポイントを押さえておくと、質が大きく変わります。
ステップ1「今の状態を確認する」では、思い込みで済ませないことが大切です。「たぶんここは動いているはず」と確認をスキップすると、後になって気づかなかった問題が積み重なっていることがあります。数十秒でよいので、実際に画面を操作して確かめる習慣をつけましょう。
ステップ2「直したい部分を1つ選ぶ」では、優先順位の付け方に迷うことがあります。基本的には、「使う上で困っている度合いが大きいもの」を優先するとよいですが、「直すのに時間がかかりそうなもの」と「すぐ直りそうなもの」が両方ある場合、まず小さく直せるものから片付けて、勢いをつけるのも有効な方法です。
ステップ3「具体的に指示を出す」では、前述のとおり、1つの問題に絞ることを徹底します。加えて、「なぜそう直したいのか」という理由も添えると、AIが意図をより正確に理解しやすくなります。
ステップ4「結果を確認する」では、直したい部分だけでなく、その周辺の機能も一緒に確認することをおすすめします。前述の「後退」の話にもつながりますが、1つの修正が別の部分に影響することは珍しくありません。
改善サイクルの具体例
抽象的な説明だけでは分かりにくいため、簡単な具体例で改善サイクルの進み方を見てみます。
「毎日の売上を記録するツール」を作っているとします。最初の指示で、売上を入力すると一覧に追加される機能ができました。これが1回目のサイクルです。
次に、「一覧が古い順に並んでいて見づらい」という課題に気づきます。ここで「新しい順に並び替えてください」という、1つの課題に絞った指示を出します（2回目のサイクル）。確認したところ、意図通りに並び替えられ、他の部分にも影響がないことを確認できました。これで課題が1つ解決しました。
さらに使ってみると、「月ごとの合計も見たい」という新しい要望が出てきます。これも1つの機能追加として、3回目のサイクルで対応します。
このように、1つずつ課題を解決していく積み重ねが、最終的にまとまった機能を持つツールへとつながっていきます。一度にすべての要望を伝えようとせず、使いながら気づいた順に、1つずつ対応していく進め方が現実的です。
具体例の続き：サイクルが停滞した場合
この「売上記録ツール」の例を、もう少し先まで進めてみましょう。4回目のサイクルで、「月ごとの合計に加えて、グラフでも表示したい」という要望が出てきました。ここでグラフ表示の指示を出したところ、グラフは表示されたものの、なぜか一覧の並び順が古い順に戻ってしまっていることに気づきます。
これは、前述した「1つの修正が別の部分に影響する」という典型的なケースです。ここで慌てて「全部やり直してください」と伝えるのではなく、記録をもとに「グラフ機能を追加する前は新しい順に並んでいました。並び順を新しい順に戻しつつ、グラフ機能はそのまま残してください」と、具体的に範囲を絞って依頼します。これが5回目のサイクルです。
このように、サイクルの途中で新たな課題（後退）が見つかった場合は、それも1つの独立した課題として、次のサイクルで扱えばよいのです。焦って複数の問題を同時に解決しようとせず、見つかった順に、1つずつ積み上げていく姿勢が、結果的に最も早く完成に近づきます。
専門知識を反映する際の対話の進め方
専門分野の業務知識を反映したツールを作っている場合、改善のサイクルの中で、AIに専門的な文脈を繰り返し説明する場面が出てきます。この場合、一度説明した前提を、対話の要所要所で再度伝え直すことをおすすめします。
対話が長くなるほど、AIが以前の説明を十分に踏まえずに提案してくることがあります。「先ほど説明した〇〇のルールを踏まえて、この部分を直してください」というように、関連する前提を都度添えることで、専門知識を反映した実装がずれていくことを防げます。
専門知識が絡む場合によくあるすれ違い
専門的な業務知識をツールに反映しようとする場合、次のようなすれ違いがよく起きます。
- 一般的なルールで代用されてしまう：例えば、飲食店の在庫管理で「先入れ先出し」が業界の常識であっても、AIがそれを知らずに、単純な数量計算だけの実装をしてしまうことがあります。業務特有のルールは、当たり前だと思わずに、明示的に伝える必要があります。
- 例外処理が省略される：「基本的にはこう動くが、月末だけは特別な扱いになる」といった例外は、最初の説明で伝えていても、対話が進むうちに実装から抜け落ちてしまうことがあります。
- 用語の意味のずれ：業界特有の用語を、AIが一般的な意味で解釈してしまうことがあります。「うちの業界で言う『棚卸し』はこういう意味です」と、必要に応じて用語の定義も伝えると、誤解を防げます。
こうしたすれ違いに気づいた場合は、その都度、前提を伝え直すことに加えて、その前提を短くまとめたメモを手元に用意しておくと、次回以降も同じ説明を繰り返す手間が減ります。
「良くなっているはずなのに、進んでいる感覚がない」ときの対処
改善を繰り返していると、細かい修正が続き、「本当に前進しているのか」という感覚が薄れてくることがあります。この場合、定期的に最初の状態と今の状態を比較してみることをおすすめします。
例えば、「最初に何もできなかった状態」のスクリーンショットと、「今動いている状態」のスクリーンショットを並べて見ると、実際にはかなりの前進があったことに気づけることが多いです。細かい修正の積み重ねは、その場では実感しにくいものですが、振り返ると確実な進歩になっています。
進み具合を数字で振り返る方法
スクリーンショットの比較に加えて、進み具合を数字で振り返ることも有効です。例えば、次のような形で記録しておくと、後から振り返りやすくなります。
- 開始時に解決したい課題を書き出しておき、その総数を数える（例：全部で12個の課題）
- 週に1回、解決済みの課題数を数える（例：1週目は3個、2週目は7個）
- 残りの課題数と、これまでのペースから、おおよその完了時期を見積もる
厳密な計画を立てる必要はありませんが、こうした簡単な振り返りを行うだけで、「思ったより進んでいる」ことに気づけたり、逆に「このペースでは目標に届かない」ことに早く気づいて対策を打てたりします。
改善を進める中で、方向転換を検討すべきサイン
対話を繰り返す中で、「そもそも最初の方針が間違っていたのでは」と感じる場面が出てくることもあります。次のようなサインが見られたら、一度立ち止まって方針を見直すことをおすすめします。
- 同じ機能の実装方法を、5回以上変更している：AIとの対話だけでは解決しにくい、設計そのものの問題である可能性があります
- 1つの機能を直すたびに、別の機能が壊れることが頻発する：機能同士の関係が複雑になりすぎているサインです。機能を減らす、あるいは一度作り直すことを検討してください
- AIの説明を読んでも、何が起きているか全く理解できない：無理に進めるより、いったん範囲を小さくした試作からやり直すほうが、結果的に早く進むことがあります
これらのサインに気づいた場合、それまでの作業が無駄になったと考える必要はありません。学んだことを踏まえて、範囲を絞った状態からもう一度組み立て直すのは、決して後退ではなく、むしろ効率的な進め方です。
サインが出たときの、具体的な立て直し方
方向転換のサインに気づいたら、次のような手順で立て直すことをおすすめします。
- 今の試作から、動いている部分だけを書き出す：完全に作り直す場合でも、うまく動いている部分の仕様は再利用できることが多いです。
- 問題が起きている機能を、いったん試作から外す：複雑さの原因になっている機能を切り離し、まずは残りの部分を安定させます。
- 外した機能を、もっと単純な形で作り直す：最初から複雑な要件を満たそうとせず、最小限の形でもう一度組み立てます。
- 単純な形で安定してから、少しずつ要件を足していく：ここからは、この記事で紹介した「一度に直す範囲を小さく保つ」サイクルに戻って進めます。
このように、方向転換は「全部をゼロに戻す」ことではなく、「複雑になった部分だけを、単純な状態に戻して、そこからもう一度積み上げる」という考え方で進めると、これまでの作業を大きく無駄にせずに済みます。
改善を続ける中でのモチベーション管理
試作の改善は、地道な作業の積み重ねです。特に本業を持ちながら取り組んでいる場合、改善のペースが思うように進まず、モチベーションが下がってしまうこともあります。
こうした場合は、改善のサイクルに「区切り」を設けることをおすすめします。例えば、「今週は3つの課題を解決する」というように、小さな目標を都度設定し、達成できたら一度そこで作業を止めて、進んだ部分を振り返る時間を取ります。この振り返りが、次のサイクルに取り組む意欲につながります。
また、1人で改善を続けていると、「本当にこれで合っているのか」という不安を感じることもあります。可能であれば、身近な人に試作を見てもらい、率直な感想をもらうことも、改善サイクルに新しい視点を取り入れる良い機会になります。特に、店舗の業務改善のためにツールを作っている場合は、実際に業務で使う予定の人に早い段階から見てもらうことで、自分だけでは気づけなかった課題が見つかることがあります。
モチベーションが下がりやすいタイミングとその対処
経験的に、改善作業の中でモチベーションが下がりやすいタイミングにはいくつかの共通点があります。
- 同じ問題を2回目、3回目に対処しているとき：「なぜまた同じことをしているのか」という気持ちになりやすいタイミングです。前述のとおり、繰り返し発生は根本原因を見直すサインでもあるため、単なる根気の問題ではなく、アプローチを変えるべき局面だと捉え直すと、気持ちが切り替えやすくなります。
- 細かい修正ばかりが続き、大きな変化を感じられないとき：前述したスクリーンショットの比較や、課題数の振り返りが特に効果を発揮するタイミングです。
- 他の人が使ったときに、想定していなかった反応や不満が出たとき：これは落ち込む要因になりがちですが、実際には「試作が実際に使われるところまで進んだ」という前進の証でもあります。指摘そのものを次の課題としてリストに追加し、通常のサイクルで対処していけばよいと捉えると、気持ちの負担が軽くなります。
改善は一直線に進むものではなく、山あり谷ありのプロセスです。落ち込む場面があっても、それ自体は珍しいことではないと捉え、区切りを設けた振り返りを習慣にすることで、長く続けやすくなります。
区切りの長さはどのくらいがよいか
区切りの長さに正解はありませんが、最初のうちは「1週間」を目安にするとよいでしょう。1日単位では、細かい修正が続くだけで変化を感じにくく、1ヶ月単位では、区切りが遠すぎて途中で息切れしてしまいがちです。1週間ごとに、解決した課題を数え、進んだ部分を振り返る、というリズムであれば、本業と並行して取り組んでいる場合でも、無理なく続けられます。
慣れてきたら、自分の生活リズムに合わせて区切りの長さを調整してもかまいません。大切なのは、区切りを設けること自体であり、その長さが1週間なのか10日なのかは、あくまで目安として捉えてください。
この記事の次に読みたい記事
対話を繰り返す進め方を理解したら、次はつまずいたときの対処法を知っておくと安心です。あわせて次の記事も参考にしてください。
</content>
