AIを使って、自分のサービスや作りたいものを形にしたい。そう思ってClaude Codeに依頼したものの、画面や機能をまとめて作ってもらったら、うまく動かない。直そうとして別のところまで変わり、何が原因なのか分からなくなる。そんな経験はありませんか。
受講生のWさんも、最初から一気に作ろうとして、仕組みが複雑になり、どこを直せばよいか分からなくなることがありました。AIに頼めば、思い描いたものをすぐに完成できるように感じるかもしれません。しかし、作る範囲が広いほど、問題が起きたときに原因を見つけにくくなります。
まずは、完成形を一度に作るのではなく、動く部分を小さく作って確かめる。この記事では、その進め方と、途中で戻れる状態を保つための工夫を紹介します。
最初に作るのは、完成版ではなく動く一部分
たとえば、記録を残すサービスを作りたいなら、最初からログイン、検索、グラフ、通知まで揃えようとしなくて構いません。まずは、入力した内容を画面に表示するところまでを作る。次に、内容を保存する。その後で、必要な機能を一つずつ加えていきます。
大切なのは、作業のたびに「何ができたら次へ進むか」を決めておくことです。「入力欄を作る」だけではなく、「入力した文字が画面に表示される」と確認できる状態を目標にします。できたかどうかを自分で確かめられると、うまくいかなかったときも、問題が起きた範囲を絞りやすくなります。
一つの変更を加えたら、実際に動かして確かめる。問題がなければ、次の変更に進む。この繰り返しなら、どの作業を境に動かなくなったのかを見つけやすくなります。


AIへの依頼も、小さく区切る
AIに「サービスを全部作って」と頼むと、画面やデータの扱いなど、複数の変更が一度に進むことがあります。その結果、動かない部分が出ても、どの変更が原因なのか判断しづらくなります。
依頼するときは、作りたいもの全体ではなく、直近の作業に絞って伝えましょう。たとえば、「入力欄に書いた内容を画面に表示してください。今回は保存機能を追加しないでください」のように、やることと、今回やらないことを分けます。
変更後には、どのファイルを変更したか、何を確認すればよいかも尋ねておくと、結果を追いやすくなります。AIの回答をそのまま受け入れるのではなく、変更内容を見て、実際に動かして確認することも大切です。
依頼の内容や確認した結果を短く記録しておけば、次に作業を再開するときにも役立ちます。「前回どこまで進めたか」「次に何を試すか」が分かるだけでも、同じ説明を何度もやり直す負担を減らせます。
変更を戻せる状態を保つ
小さく進めていても、変更によって別の部分が動かなくなることはあります。そこで、作業の区切りごとにファイルを保存し、変更履歴を残しておきましょう。Gitなどの履歴管理を使う方法もありますが、最初から仕組みを完璧に理解する必要はありません。まずは、正常に動いている状態を区別できるようにしておくことが大切です。
変更前の状態に戻せると、修正を試す心理的な負担も下がります。逆に、動いている状態を残さずに作業を重ねると、不具合が出たときに「何を戻せばよいか」から調べることになり、原因の切り分けが難しくなります。
Wさんの経験からも、複雑になってから全体を直そうとするより、動く部分を確認しながら足していくほうが、問題に気づきやすいと分かります。とはいえ、慣れないうちは「ここだけ直したいのに、どこを見ればいいのか分からない」という場面もあります。自分だけで原因を切り分けるのは、思った以上に時間がかかることがあります。
まず一つ、動く状態を作る
AIを使った開発では、最初に完成形を作るより、確かめられる小さな機能から始めるほうが、次の判断をしやすくなります。AIへの依頼を一つずつに分け、動作を確かめ、問題がなければ履歴を残して次へ進む。シンプルですが、複雑になって身動きが取れなくなるのを防ぐ助けになります。
どこから作り始めるか、どう小さく区切るか。一人だと全体を一度に抱えて手が止まることがあります。AIで自分のサービスややりたいことを形にしたい方は、最初に作る範囲から相談してみる方法もあります。ZELK IT・AI相談所では、作って確かめる進め方を、1対1で一緒に組み立てています。



