メインコンテンツへスキップ
見出し画像

個人開発の進め方:AIと一緒に進める、今の僕の開発フロー

    個人開発をAIと進めるとき、僕が大切にしたいのは、実装を任せることだけでなく、着手前の確認から検証、その後の改善までを一つの流れとして考えることです。

    この記事では、僕がAIと個人開発を進めるうえで大切にしている方針を紹介します。いつも完璧にできているというより、こう進めたいと考えている流れです。

    この記事の要点

    • 進め方:着手前の確認から、計画、実装、検証、改善までをつなげて進める方針です。

    • AIの役割分担:全体をまとめるAIを中心に、工程ごとの作業を別のAIへ任せ、結論を戻してもらうようにしています。

    • 検証と承認:動作確認とコードレビューを行い、変更の取り込みや公開は承認後に進める方針です。

    • 確認結果の整理:確認できたことと、まだ確認できていないことを分けて、次に必要な作業を明確にします。

    AIと進める個人開発の全体像

    僕が考えている流れは、着手前の確認 → 計画 → 実装 → 検証 → 改善です。AIにコードを書いてもらう前と後にも、作業を置いています。

    たとえば新しい機能を加える場合なら、似た作業や過去の注意点を探してから、何をつくるかを整理します。その後、小さく実装し、動作の確認とレビューを経て、次にも役立つ気づきを残す、という考え方です。

    全体をまとめるAIと作業を分担するAIの役割

    全体をまとめるAIを一つ置き、設計、実装、確認などを別のAIへ分担させる方針です。分担したAIから結論を戻してもらい、全体をまとめるAIが次の作業につなげる形です。

    たとえば、ある機能を追加するときは、関連するコードを調べる役と、変更内容を確認する役を分けることを考えます。全体をまとめる役には、各作業の結論を受け取り、何が決まり、何がまだ不明かを整理してもらいます。

    役割を分けるのは、AIを増やすこと自体が目的ではありません。それぞれに何を任せ、どの結果をもとに次へ進むかを明確にするための方針です。

    着手前と設計:過去の履歴を探し、方針を固める

    実装に入る前に、似た作業の履歴と、これまでに繰り返し起きた問題を確認する方針です。何をつくるかが曖昧なときは、そのままコードを書き始めず、対話しながら範囲を整理します。

    過去の作業を検索し、必要な部分だけ読む

    以前の作業に似たものがあるか、まず履歴を検索します。たとえばログイン画面の変更なら、過去に認証まわりを扱った作業を探し、関連するやり取りや変更の経緯を確認するイメージです。

    履歴を最初から最後まで読むのではなく、検索で候補を見つけてから、必要な箇所を確認する方針です。実装の細部や失敗したときの経緯も、必要に応じて振り返ります。

    履歴を探す目的は、以前の答えをそのまま使うことではありません。今の変更に関係する判断や注意点がないかを確かめ、改めて考えるための材料を集めます。

    曖昧な点と過去につまずいた点を整理してから設計する

    「使いやすくしたい」のように依頼の輪郭が広いときは、対象となる画面、誰が使うか、どんな状態を目指すかを対話で具体化します。決まっていないことが残っていれば、そのまま決めつけずに確認します。

    そのうえで、何を変更し、何は今回の範囲に含めないか、どの順番で進めるかを計画します。過去に繰り返した問題をまとめた記録も、関係する部分を先に確認する方針です。

    たとえば外部サービスとの連携を考えるなら、画面の表示だけを先につくるのか、データの取得まで含めるのかを分けて考えます。過去の注意点は、今の作業にも当てはまるかを確かめるための手がかりとして使います。

    実装:小さく進め、迷ったら原因を切り分ける

    実装では、処理のテストを先に考え、失敗したら原因を調べる方針です。また、外部サービスや課金との連携は後に回し、まず仮の仕組みで一連の流れを確かめます。

    テストを先に書き、失敗の原因を調べる

    計算や条件分岐など、処理の仕組みをつくるときは、先にテストを書く方針です。テストとは、ある入力に対して期待した結果が返るかを確かめるためのコードです。

    たとえば、入力した値に応じて表示を切り替える処理なら、「この値のときに何が表示されるか」を先に決めます。そのうえで、期待した結果になるように処理を実装します。

    テストや実行に失敗したときは、AIに何度も修正を推測させるのではなく、エラーの内容や再現する条件を見ながら原因を切り分けるよう指示しています。入力の問題なのか、処理の問題なのか、外部との接続の問題なのか。確認できた範囲を狭めながら、次に調べる場所を決めるイメージです。

    仮の仕組みで一度つなぎ、作業を分ける

    外部サービスや課金を使う機能は、すぐに本物の接続へ進むのではなく、まず仮のデータや応答を返す仕組みで、画面から結果までの流れをつなぐ方針です。たとえば外部から情報を取得する画面なら、先に決めたサンプルデータを表示し、その後に実際の取得処理へ差し替えます。

    仮の仕組みで確認できるのは、あくまでその条件下での流れです。実際の外部サービスとの接続や課金の動作まで確認できたことにはならないので、後の検証で分けて扱います。

    変更は機能ごとに作業用の枝を分けて進める方針です。枝とは、元のコードから変更を分けて扱うための仕組みです。独立した作業は並行してAIに任せ、同じファイルを触る作業を並行する場合は、それぞれ別の作業場所を用意します。

    検証とレビュー:完了の判断を曖昧にしない

    実装が終わったら、動く状態にできるか、型やテストに問題がないか、実際に動作するかを確認し、その後でコードレビューを行う方針です。「コードを書いた」と「確認が終わった」を分けて考えます。

    機械的な確認とコードレビューを分ける

    主に次の確認を行う方針です。

    • ビルド:アプリを動かすための準備ができるか。

    • 型の確認:データの種類や受け渡し方に、検出できる問題がないか。

    • テスト:用意した条件で、期待した結果になるか。

    • 実行時の確認:実際に動かしたときに、確認した範囲で想定どおりに動くか。

    その後、変更したコードの読みやすさや見落としなどを確認するレビューを行う方針です。レビューで指摘された内容も、すべてを自動的に採用するのではなく、一つずつ妥当性を見てから対応します。

    型の確認やコードの自動点検、テスト、ビルドは、まとめて実行できるようにしておくと、確認漏れを防ぐための助けになります。

    検証済み・未検証を報告し、承認を待つ

    確認が終わったら、できたことだけでなく、まだ確認できていないことも分けて報告する方針です。たとえば「用意したテストは通ったが、実際の外部サービスとの接続は未確認」のように書けば、次に何を確かめる必要があるかが見えます。

    変更を元のコードへ取り込むこと、共有先へ送ること、公開することは、僕自身が確認してから行う方針です。AIが「完了」と報告しても、その内容と未確認の範囲を見てから、次へ進むかを判断できるようにしておきます。

    改善:繰り返した問題を次の作業に生かす

    開発中に気づいたことは、何でも記録するのではなく、繰り返し起きた問題を中心に残す方針です。次に似た作業をするとき、必要な部分を読み返せる形を目指しています。

    繰り返す問題だけを記録に残す

    2回以上つまずいた問題は、あとから参照できるようにまとめる方針です。反対に、一度きりの出来事や、その場面に固有すぎる細部は増やさないようにします。

    記録するときは、「何をしていたか」「どこでつまずいたか」「どう対処したか」を、次の作業で判断できる程度に整理します。たとえば、同じ種類の外部連携で似た確認漏れを繰り返したなら、作業前に確かめたい点として残すイメージです。

    この記録は、次回の作業を始める前に確認するものでもあります。残すだけで終わらせず、関係する作業が来たときに参照する流れまで含めて、方針にしています。

    必要な情報だけを読み、扱う情報を絞る

    過去の履歴や大きなファイルは、関連する箇所に絞って読む方針です。広い範囲を調べる必要がある場合は、作業を分担するAIに調査を任せ、全体をまとめるAIには結論を返してもらいます。

    たとえば、変更に関係する処理を探すときは、まず該当箇所を見つけ、その周辺を確認します。細かな経緯が必要になったら、そこで履歴を追加で読みます。

    最初からすべての情報を渡すのではなく、作業に必要なものを選び、不足が見つかったら調べる。そうした進め方を、AIへの指示に組み込んでいます。

    まとめ

    僕がAIに伝えている個人開発の方針は、実装だけを任せるのではなく、着手前の確認から、計画、実装、検証、改善までをつなぐものです。完璧に進めることよりも、それぞれの段階で何を確認し、どう次につなげるかを大切にしています。

    もし自分の開発に取り入れるなら、まずは作業の終わりに「確認できたこと」と「まだ確認していないこと」を一行ずつ書いてみるのもよさそうです。AIに任せた部分と、自分で判断したい部分が見えるところから、進め方を少しずつ整えていけたらと思います。

    あなたへのおすすめ