AIにコードやサイトを作らせる前に決めておくと、手戻りが激減します。目的・完成イメージ・制約・小さく分ける単位など、ノンプログラマーがAIエージェントで実践した『前準備』のコツを実体験ベースでまとめました。
AIにコードを作らせる前に「目的・完成イメージ・制約」を決めておくと、手戻りが激減します。技術に詳しくなくても、何を・どう動かしたいかを具体的に伝えるのが鍵。大きな物は小さく分けて、1つずつ確認しながら作るのがコツです。
この記事は、ノンプログラマーがAIエージェント(Claude Code)に物づくりを任せた経験から、前準備のコツを整理したものです。
AIに物づくりを頼むとき、いきなり「作って」では迷走しがち。先に決めておくだけで、結果が大きく変わります。
実体験メモ
ノンプログラマーの私がAIにコードを書かせて学んだのは、書かせる前の「準備」で結果がほぼ決まること。目的・制約・完成イメージを曖昧にしたまま頼むと、動くけれど望みと違う物が出ます。先に決めるべき点を言葉にしてから渡すと、手戻りが激減しました。急がば回れだと実感しています。
先に決める3点
| 要素 | 内容 | 例 |
|---|---|---|
| 目的 | 何を作りたいか | 「記事を一覧表示するサイト」 |
| 完成イメージ | どう動く・見える | 「一覧→クリックで記事へ」 |
| 制約 | 守ってほしい条件 | 「無料の構成で・スマホ対応」 |
技術用語は不要。「どんな画面で・何ができて・どう操作するか」を言葉や箇条書きで伝えれば十分です。
大きな物は「小さく分ける」
一度に全部は作らせず、小さな単位に分けて、1つずつ作って確認します。
- まず一番大事な部分だけ
- 動いたら次の部分
- ズレたらその場で修正
分け方が分からなければ、「この目的を小さなステップに分けて」とAIに相談すれば道筋を作れます。
うまくいかないときの対処
- エラーや変な結果をそのままAIに見せる
- 直すのは言い回しより足りない前提
- 小さく試して直すを繰り返す
まとめ
- 作らせる前に目的・完成イメージ・制約を決める。
- 伝えるのは画面・できること・操作。技術用語は不要。
- 大きな物は小さく分けて1つずつ確認。
- 詰まったら結果をAIに見せて相談する。
依頼の組み立ては AI依頼の『ゴール・制約・評価基準』の決め方、前提の渡し方は コンテキストの渡し方で精度が激変する もどうぞ。
関連記事:AI文章ツールの選び方(3タイプ)/AIチャットツールの比較・選び方。
よくある質問(FAQ)
AIにコードを書かせる前に何を決めればいいですか?
『何を作りたいか(目的)』『完成したらどう動く・見えるか(完成イメージ)』『守ってほしい条件(制約)』の3つです。これを先に言葉にしておくと、AIが的を外しにくく、手戻りが減ります。技術的に詳しくなくても、イメージを具体的に伝えるだけで十分役立ちます。
完成イメージはどこまで具体的にすべきですか?
『どんな画面で、何ができて、どう操作するか』を、絵や箇条書きで伝えられると理想です。完璧でなくてよく、参考になるサイトを挙げる、手書きのイメージを言葉にする、でも十分です。具体的なほどAIの出力が狙いに近づきます。
大きな物を作るときのコツはありますか?
一度に全部作らせず、小さな単位に分けて、1つずつ作って確認するのがコツです。『まず一覧画面だけ』『次に詳細画面』のように進めると、ズレに早く気づけて修正も楽です。完成までの道筋もAIと相談して分解できます。
うまくいかないときはどうすればいいですか?
エラーや想定と違う結果を、そのままAIに見せて『どこが原因か』『どう直すか』を相談します。指示の言い回しを直すより、足りなかった前提(目的・条件)を補うほうが効果的です。小さく試して直す、を繰り返せば前に進みます。