AI Crew

Vibe Codingで手が止まるのは「マニュアル思考」が原因|手順ではなく成果物を見る


結論から言います。Vibe Codingを始めた非エンジニアが最初にぶつかる壁は、開発スキルの不足ではありません。手順を全部決めてからでないと動けない「マニュアル思考」から抜けられないことです。ここを切り替えられるかどうかで、同じAIを使っても前に進める人と、途中で手が止まる人に分かれます。まずはVibe Codingそのものの定義から確認しておきましょう。

Vibe Codingとは 2025年2月にAI研究者のアンドレイ・カルパシー氏が提唱した言葉で、作りたいものを自然言語でAIに伝え、生成されたコードを一行ずつ精査するのではなく、動作を確かめながら対話を重ねてアプリを形にしていく開発スタイルです。この記事では、Claude Code・Codexのような、パソコン上でファイルの編集や実行まで行うAIエージェントで実践する前提で話を進めます。

この記事では、みやっち🧑‍💻がAI Crewの業務アプリ講座で受講生と実際に作っている現場から、「マニュアルどおりに進まないと不安になる」という心理的な壁の正体と、その抜け方を解説します。対象は、自分の業務を自分で握っている経営者・個人事業主・士業の方です。

なぜ「マニュアルと画面が違う」だけで手が止まるのか

講座のアプリ開発でいちばん多く出る質問があります。「マニュアルの手順と違ったのですが、大丈夫ですか?」——これです。用意した手順書のスクリーンショットと、いま自分のパソコンに表示されている画面が少し違う。その瞬間に「自分がどこかで間違えたに違いない」と感じて、手が止まってしまうのです。

この不安の正体が「マニュアル思考」です。会社の業務マニュアルは、人があらかじめ全部の手順を決めておき、誰がやっても同じ結果になるように作られています。だから1ステップでもズレると「マニュアルどおりにできていない=失敗」と感じる。長く事務作業や実務を回してきた人ほど、この発想が染みつきやすいはずです。まじめな人ほど、はまりやすい壁かもしれません。

この傾向は、IT実務の経験がない人ほど強く出ます。設定を1つ変えるたびに「これで合っているのかな」「壊してしまわないかな」と不安になり、確認が取れないと次に進めない。手順書という“正解”に照らして安心したいのに、その正解が手元の画面と一致しない。ここで多くの人がフリーズしてしまいます。でも、止まる必要はありません。次の見出しから、その理由を1つずつほどいていきます。なお、手が止まる場面も含めたつまずきの典型パターンはバイブコーディングの失敗例5つと対策に別途まとめています。

すべての手順が、全員同じになることはありえない

ここで大事な前提を1つ。アプリ開発では、すべての手順が全員まったく同じになることは、そもそもありえません。 これはあなたのやり方が雑だからではなく、開発という営みの性質です。

理由は2つあります。1つは、AI業界が常軌を逸したスピードで動いていること。ツールの画面も、いま最善とされるやり方(ベストプラクティス)自体も、どんどん変わっていきます。だから画面が資料と違う=自分の失敗、ではありません。資料を作った時点と、あなたが触っている時点で、ツール側が更新されているだけのことが大半です。

もう1つは、ソフトウェア開発がもともと作っては壊してを繰り返す営みだということ。軽く試してみて、ダメならすぐ捨てて別の形を試す——エンジニアが日常的にやっているのはこれです。一度で完璧な手順を通すゲームではなく、試行錯誤そのものが本編なのです。

たとえば一覧画面のレイアウトをAIに作らせてみて、実際に表示したら少し使いにくい。そうしたら「この並びを変えて」「表の形にして」と伝えて作り直す。この“作って、見て、気に入らなければ捨てて作り直す”を何度も回すのが普通の進め方で、最初から正解の手順を当てにいくものではありません。ズレたら捨てて作り直せばいい、と最初から知っているだけで、手が止まる回数は大きく減ります。

見るべきは「過程」ではなく「成果物」

では何を判断基準にすればいいのか。答えは、過程ではなく成果物です。手順どおりに進んだかではなく、自分が欲しかった成果物が得られているか。ここだけを自分で検証すればいいのです。

たとえば「予約を受け付けるアプリ」を作っているなら、途中の画面が資料と多少違っても、最終的に予約が入力できて保存されていればゴールに着いています。逆に、手順を一言一句なぞれても、欲しかった動きになっていなければ意味がありません。視点を過程から成果物へ移すだけで、「違う=失敗」という不安の大半は消えます。

同じ「手が止まった場面」でも、見る場所が変わると行動が変わります。これまでは、画面が資料と1か所違うだけで「間違えたかも」と手を止め、正解の手順をずっと検索し続けていた。これからは、「予約はちゃんと保存できているか?」という成果物の一点だけを確かめ、できていれば気にせず先へ進む。止まる回数が減るぶん、完成までの距離がぐっと縮みます。

もう1つ、ここで役立つのが100%主義からの脱却です。最低限守るべきところ(たとえば個人情報や鍵の扱い)だけ押さえて、あとはどんどん試して進む——この感覚のほうが、結果的に成果は早く出ます。なお、成果物で判断するには「良い成果物とはどんなものか」という完成像を自分が持っている必要があります。この前提についてはAIで作ったアプリがしょぼくなる原因にまとめました。

手順を追う人から、状況を見て決める人へ

マニュアル思考から抜けた人が実際にやっているのは、手順を暗記することではなく、次の思考の流れを回すことです。

  1. 状況を見る — いま自分の画面で何が起きているか、エラーが出ているのか、動きが違うのかを事実として把握する
  2. 仮説を立てる — 「たぶんこの設定が原因では」と自分なりの当たりをつける
  3. AIに聞きながら進める — その状況と仮説をClaude Code・Codexに伝え、対処法を相談する
  4. 自分の環境に合わせる — 返ってきた案を、自分のパソコンや作りたいものに合わせて調整する

たとえば、こんな流れです。ログイン画面が真っ白のまま動かない(状況を見る)→「さっきデータベースの設定をいじったからそのあたりかも」と当たりをつける(仮説を立てる)→その状況と仮説をそのままAIに伝えて相談する(AIに聞く)→返ってきた直し方を自分の設定に当てはめて試す(自分の環境に合わせる)。手順書のどこに戻ればいいかを探すのではなく、目の前の状況からその都度考える。慣れると、これがいちばん速い道になります。

この流れは、手順書を渡されて従う姿勢とは正反対です。手順を追う人から、状況を見て自分で決める人へ——これがマニュアル思考からの脱却の中身です。

ここで1つ補足します。AIと対話しながら進めるといっても、返ってきた提案をすべて「はい」で通していくことではありません。提案の内容と、実際に動かした結果を一つずつ確かめながら進めてください。中身を見ずに全部承認するのは、マニュアルを盲信するのと同じ危うさがあります。確かめながら進める姿勢そのものが、成果を分けます。

なぜこの進め方は「自分専用のアプリ」でこそ身につくのか

「状況を見て仮説を立てて対話で決める」という進め方は、他人が決めた手順に乗るだけの道具では身につきにくいものです。既製のSaaSは、提供側が決めた画面と手順に、こちらのやり方を合わせて使うものです。チャットで相談する使い方でも、返ってくるのは文章やコードまでで、それを自分の環境に置いて動かすところは自分の仕事のまま残ります。どちらも、画面や進め方を自分の要件に合わせて作り変えていける構造にはなりにくいのです。

Claude Code・Codexのような実行型のAIエージェントで、自分の業務に合わせたアプリを自分で作るときだけ、この進め方が本当に必要になります。作っては壊し、状況を見て仮説を立て、対話で直しながら、自分の要件どおりに育てていく。合わない手順に自分を寄せる側から、自分の判断で作り変えていく側へ——事業の要件や判断基準を自分で握っている経営者・個人事業主・士業ほど、この移り方は事業の武器になります。

顧客管理に並べる項目も、予約を受けるルールも、決めているのは自分です。だからこそ「マニュアルどおりか」で悩むより、「自分の事業に必要な成果物になっているか」で判断できる人が強い。他人の手順に自分を合わせるのをやめて、自分の判断で作っては直せるようになると、AIは相談相手から、自分の事業に合わせて動く“分身”に変わっていきます。

この「まず動くものを作り、詰まった箇所に降りて必要な分だけ学ぶ」という順序は、AI Crewではパラシュート学習法と呼んで講座の設計原則にしています。マニュアル思考から抜けることと、この学び方は表裏一体です。手順を全部わかってから動くのではなく、動きながら必要なところを学ぶ。順番を入れ替えるだけで、止まっていた手が動き出します。

AI Crewでは、こうした考え方の切り替えから、実際に自分専用の業務アプリを作るところまで、Claude Code・Codexの両方を使いながら一緒に進めています。まず無料セミナーでお会いしましょう。

関連記事

※「AI Crew」は株式会社AI Orchestraの登録商標(登録第6942947号)です

8/6 Codex勉強会 先行予約