AI コーディングの道具を入れたのに、出てきた変更を毎回こちらで直している。
そういうときに足りないのは、モデルの賢さより、人が先に渡しておくべき情報であることが多いです。
AI駆動開発は、実装の多くを AI エージェントに任せながら、何を作るかと、できたかどうかの確かめ方を人が持って進めるやり方です。
似た言葉のバイブコーディングとは、この 2 つを人が持つかどうかで分かれます。
この違いが分かると、始めるときに何から整えればよいかの順番も決まります。
AI駆動開発とは
この連載では、AI駆動開発を次の意味で使います。
AI エージェントがコードを調べ、書き、テストを走らせるところまでを受け持ち、人は「何ができたら完成か」と「それをどう確かめるか」を決めて、最後に結果を承認する進め方です。
AI エージェントは、モデルの周りに道具や指示をまとめた仕組み(ハーネス)の上で動いています。
主な道具の公式ドキュメントを読むと、どれも同じことを勧めていました。
Claude Code のベストプラクティスは、セッションがうまくいかない原因の 1 つに「終わったと言ったのに終わっていなかった」を挙げ、たいていは自分の作業を確かめる手段が無かったからだと説明しています。
参考: Best practices for Claude Code(Claude Code Docs)
OpenAI の Codex のドキュメントは、長い作業を頼むときに、欲しい結果・守る制約・確かめ方の 3 つで「完成」を書くよう勧めています。
参考: Long-running work(ChatGPT Learn)
GitHub Copilot のドキュメントも Issue に受け入れ条件を書くよう勧め、ビルドとテストのやり方を指示ファイルに書いておくと、すぐマージできる PR になりやすいとしています。
参考: Best practices for using GitHub Copilot to work on tasks(GitHub Docs)
道具は違っても、仕様と確かめ方を人が先に渡すところで 3 つとも一致しています。
バイブコーディングとの違い
バイブコーディングは、アンドレイ・カルパシー氏が 2025 年 2 月 2 日付の X への投稿で名付けた言葉です。
参考: Andrej Karpathy 氏の投稿(X)
投稿では、雰囲気に身を任せてコードの存在すら忘れるやり方として紹介されています。
差分は読まずに全部受け入れ、エラーはそのまま貼り付けて直してもらい、使い捨ての週末のプロジェクトなら悪くない、という書き方でした。
開発者のサイモン・ウィリソン氏は、AI が書いたコードを読み、十分にテストし、人に説明できる状態にしたなら、それはバイブコーディングではなくソフトウェア開発だと書いています。
参考: Not all AI-assisted programming is vibe coding(Simon Willison's Weblog)
2 つを並べると、違いは次のようになります。
| 見るところ | バイブコーディング | AI駆動開発 |
|---|---|---|
| 何を作るか | 頭の中にあり、作りながら決める | 完成の条件を先に書いて渡す |
| 確かめ方 | 動かして見た目で判断する | テストや型チェックなど、合否が出る手段を用意する |
| 差分 | 読まない | 人が読んで承認する |
| 向く場面 | 試作、自分だけが使う道具 | 他の人が使い、長く直し続けるコード |
どちらが上というより、壊れたときに困る人がいるかどうかで使い分けるものです。
言葉の成り立ちや向く場面は、別の記事で詳しく書いています。
進め方

始めるときは、AI に渡す順番と同じ順で整えていきます。
人が先に渡すもの、AI が回すもの、人が最後に見るものの 3 つに分けると、どこから手を付けるかが見えます。
確かめる手段を先に用意する
最初に用意するのは、AI が自分で走らせて合否を読める手段です。
テストのファイル、ビルドの終了コード、リンター、出力を期待値と比べるスクリプトなど、結果が「通った/落ちた」で返るものなら何でも使えます。
Claude Code のドキュメントは、すでにどれかがあるなら、指示ファイルに書くいちばん役に立つ 1 行はその実行コマンドだとしています。
私も Claude Code を使う自分のリポジトリでは、テストを流すコマンドを指示ファイルに書いています。
指示ファイルに何を書くかは、AGENTS.md の記事にまとめました。
リポジトリ全体を、AI が自分で確かめられる形に整える話は、次回のハーネスエンジニアリングで扱います。
完成の条件を書いてから頼む
次に、何ができたら直ったと言えるかを書いてから頼みます。
Claude Code のドキュメントは、対象のファイルと症状と「直った状態」を最初に書くと、たいていやり直しが 1 往復減ると説明しています。
例として挙がっているのは、再現する失敗テストを先に書かせてから直させる頼み方です。
何を作りたいかが固まっていないときは、AI に質問させて仕様を書かせる手もあります。
Claude Code では質問に答えながら仕様のファイルを書かせ、新しいセッションでそこから作らせる流れが、Codex では /plan で質問させてから /goal に渡す流れが紹介されています。
仕様を先に書く進め方そのものは、仕様駆動開発の回で詳しく書きます。
計画を見てから書かせる
変更が大きいときは、先に調べさせて計画を出させ、人が読んでから実装に進ませます。
Claude Code の plan mode は、調べて変更を提案するところまでで止まり、人が計画を承認してから編集に移るモードです。
参考: Choose a permission mode(Claude Code Docs)
Cursor のドキュメントは、できたものが思っていたのと違ったら、追加の指示で直すより、変更を戻して計画を具体的にし、やり直すほうが速いことが多いとしています。
参考: Plan Mode(Cursor Docs)
主な道具の指示ファイルと計画の出させ方は、次のとおりです(2026-11-10 時点の公式ドキュメント)。
| 道具 | 指示ファイル | 先に計画を出させる方法 |
|---|---|---|
| Claude Code | CLAUDE.md | plan mode(Shift+Tab か /plan) |
| Codex | AGENTS.md | /plan(アプリ・CLI・IDE 拡張) |
| Cursor | .cursor/rules・AGENTS.md | Plan Mode(Shift+Tab) |
| GitHub Copilot(クラウド) | .github/copilot-instructions.md・AGENTS.md など | ブランチで調べて計画し、PR を開く前に見直す |
完成の条件を満たすまで作業を続けさせる /goal は、Claude Code と Codex の両方にあります。
計画を先に出させる考え方は、Planning モードの記事でも書いています。
証拠を見て、差分を人が承認する
AI が「終わりました」と言ったら、実行したコマンドとその出力を見せてもらいます。
Claude Code のドキュメントも、「テストは全部通りました」の一言からはほとんど何も分からないので、証拠を求めるよう書いています。
そのうえで差分を読み、マージや本番への反映のような戻せない操作を承認するのは人の役目です。
Claude Code のドキュメントは、人がいない間に長く走らせる場合でも、始めること、今回の「完成」を決めること、最後のマージを承認することは人の手に残ると書いています。
承認をどこに挟むかの考え方は、ヒューマン・イン・ザ・ループの記事にまとめました。
二度言ったことを仕組みに移す
同じ指摘を 2 回したら、それは指示ファイルに書く合図です。
Claude Code のドキュメントは、指示ファイルに書くものの 1 つに「すでに 2 回直したこと」を挙げています。
ただし、指示ファイルは AI が読んで判断する「お願い」なので、例外を許せない決まりは、フックや拒否のルールのように道具の側で必ず実行される形に移します。
確かめる手段と完成の条件がそろうと、AI は自分で直して確かめ直すところまで進められます。
落とし穴
始めたばかりのときにつまずきやすいところを 3 つ挙げます。
試作のつもりのコードがそのまま残る
バイブコーディングで作った試作を人に使ってもらい始めると、誰も読んでいないコードがそのまま動き続けます。
ウィリソン氏は、バイブコーディングで作ってよいのは壊れても困らないものだとし、秘密情報・個人のデータ・従量課金の API を扱うときは特に気を付けるよう書いています。
他の人が使う段階に来たら、テストと差分のレビューを足してから出します。
「終わりました」を信じて止める
確かめる手段が無いまま任せると、AI は見た目ができた時点で止まります。
Claude Code のドキュメントは、この状態を「人がテストの代わりになる」と表現し、間違いは誰かが気づくまで残ると書いています。
合否の出る確かめ方が 1 つも無いなら、任せる前にそれを作るところから始めます。
指示ファイルに何でも書き足す
困るたびに指示ファイルへ行を足していくと、肝心の決まりが埋もれていきます。
Claude Code のドキュメントは、指示ファイルは毎回のセッションで読み込まれ、関係の無い行も少しずつ AI の注意を使うと説明しています。
コードを読めば AI が自分で分かることは書かず、リポジトリの外にしか無い決めごとだけを書くようにします。
何を渡し、何を渡さないかを決める考え方は、コンテキストエンジニアリングの記事で書きました。
参考
参照日はいずれも 2026-11-10 です。
- Claude Code Docs「Best practices for Claude Code」
- Claude Code Docs「Choose a permission mode」
- Claude Code Docs「Keep Claude working toward a goal」
- ChatGPT Learn「Long-running work」
- ChatGPT Learn「Custom instructions with AGENTS.md」
- GitHub Docs「Best practices for using GitHub Copilot to work on tasks」
- Cursor Docs「Plan Mode」「Rules」
- Andrej Karpathy 氏の X への投稿(2025-02-02)
- Simon Willison「Not all AI-assisted programming is vibe coding (but vibe coding rocks)」(2025-03-19)
最後に
AI駆動開発は、実装を AI に任せても、何を作るかと、どう確かめるかは人が持つ進め方です。
始める順番は、確かめる手段、完成の条件、計画の確認、証拠と承認、繰り返す指摘の仕組み化です。
次回は、AI が迷わずに自分で確かめられるリポジトリの整え方として、ハーネスエンジニアリングを取り上げます。
まずは手元のリポジトリで、テストを流すコマンドを 1 行、指示ファイルに書くところから始めてみてください。
以上です。


















コメントを残す