ママ「AIコーディングは"段取り八分"よ💋 迷子にならないワークフローを教えてあげるわ」
はじめに
👩🎤ちぃママ： ママぁ〜、アタシ最近AIでコーディングしてるんだケドッ、なんかいっつも途中で迷子になるんですぅ💦
👩ママ： あら〜〜〜〜ッ、またアンタ、地図も持たずに冒険に出たの？
👩🎤ちぃママ： えっ、地図⁉️ AIに「作って〜」って言えば作ってくれるんじゃないんですかぁ⁉️
👩ママ： やだぁ‼️ それじゃあ目隠しでダーツ投げて「どこか当たるでしょ」って言ってるようなものよ💋 AIコーディングにも作法ってものがあるの。今日はそれを教えてあげるわね✨
⚠️ この記事の前提条件
👩🎤ちぃママ： ママ、この方法って誰でもすぐできるんですかぁ？
👩ママ： ちょっと待って💋 大事なことを先に言っておくわね。このワークフローを回すには、開発ドキュメントが整備されていることが前提なの。
👩🎤ちぃママ： 開発ドキュメント…？
👩ママ： そう。AIに「既存コードを参照して」「ガイドラインに沿って」ってお願いするでしょ？ その参照先がないと、AIも困るのよ👀
このワークフローの前提条件
- 開発ドキュメントが整備されていること（設計書、仕様書など）
- コーディングガイドラインが存在すること
- テストガイドラインが定義されていること
- PR粒度のルールがチーム内で共有されていること
これらがない状態でAIに「ドキュメント参照して」と言っても、AIは途方に暮れるだけよ💦
👩🎤ちぃママ： うちのプロジェクト、ドキュメントほとんどないかも…💦
👩ママ： だったらまずドキュメント整備からよ。料理するのに冷蔵庫が空っぽじゃ、何も作れないでしょ？ AIコーディングも同じ。**材料（ドキュメント）を揃えてから調理（実装）**なの💋
👩🎤ちぃママ： なるほど〜！ 先に準備が必要なんですねぇ✨
👩ママ： そういうこと。ドキュメントがあれば、AIは一貫性のあるコードを書けるし、レビューも基準が明確になるわ。逆にドキュメントがないと、毎回AIに説明し直しで、結局効率悪いのよ👀
🗺️ 全体の流れ〜迷子にならないためのロードマップ〜
👩🎤ちぃママ： 作法って、なんかお茶みたいですねぇ🍵
👩ママ： そうね、お茶と同じで順番が大事なのよ。AIコーディングの基本は5ステップよ👀
| ステップ | やること | ポイント |
|---|---|---|
| ① | プランニング | 全体像を把握してから動く |
| ② | PR粒度でタスク分割 | 小さく切って確実に進める |
| ③ | 実装サイクル | 説明→確認→実装→レビュー |
| ④ | コミット＆プルリク | 区切りをつけて成果を残す |
| ⑤ | レビュー対応 | 指摘を受けて磨き上げる |
👩🎤ちぃママ： へぇ〜🎵 でもアタシ、いきなり③から始めてましたぁ💦
👩ママ： フッフッフッフッフッフッ〜〜〜〜😤💨 それじゃあ基礎工事なしで家を建てるようなものよ。だから途中で崩れるのよ、アンタの実装は💋
📋 ステップ①：プランニング〜「走る前に考える」の哲学〜
👩🎤ちぃママ： プランニングってなんですかぁ？
👩ママ： 簡単に言うと、実装を始める前に計画を立てるってことよ。AIに「Planモードで計画を作成して」ってお願いするの。
👩🎤ちぃママ： えぇぇ⁉️ 計画⁉️ めんどくさ〜い💦
👩ママ： ちょっとぉ‼️ 旅行に行くとき、いきなり空港に行く？ 行き先決めるでしょ？ホテル予約するでしょ？
👩🎤ちぃママ： そ、そうですねぇ…
👩ママ： AIコーディングも同じよ。目的、実装内容、完成イメージを最初に整理するの。こうやってお願いするのよ👀
下記のタスクの実装計画を作成してください。
開発ドキュメントや既存コードベースを参照してください。
【タスク】
・◯◯機能の追加
・△△の修正
👩🎤ちぃママ： おぉ〜！ なんかちゃんとしてる感じがしますぅ✨
👩ママ： でしょ？ この段階で指示漏れや理解のズレをなくしておくのが肝心なの。後で「あ、これも必要だった」ってなるのが一番のタイムロスよ💋
ポイント：プランニングで確認すべきこと
- タスクの全体像と目的は明確か？
- 既存コードとの整合性は取れているか？
- 依存関係や影響範囲は把握できているか？
- 完了条件は具体的に定義されているか？
✂️ ステップ②：PR粒度でタスク分割〜大きな象は一口ずつ〜
👩🎤ちぃママ： PR粒度ってなんですぅ？
👩ママ： Pull Request（プルリクエスト）を1つ出せる単位で作業を分けるってことよ。大きなタスクを小さく切り分けるの。
👩🎤ちぃママ： アタシ、全部まとめて1個のPRにしてましたぁ！ 効率的でしょ⁉️
👩ママ： ちょっとアンタァァァ‼️‼️ それ、1000行のPR作る気⁉️ レビュアーに殺意を抱かせる気⁉️
👩🎤ちぃママ： ぎゃー‼️ そ、そんなつもりは…💦
👩ママ： PRは小さく、意味のある単位で切るのよ。目安としてはこんな感じね👀
| PR粒度 | 例 | レビューしやすさ |
|---|---|---|
| 1機能 = 1PR | 「ログイン機能の追加」 | ◎ |
| 1修正 = 1PR | 「バグ修正：nullチェック追加」 | ◎ |
| 複数機能 = 1PR | 「ログインと決済と通知を追加」 | ✕ |
👩🎤ちぃママ： な… ななななななな、わかりましたぁ💦
👩ママ： PRを分割したら、それぞれに対して③〜④のサイクルを回していくのよ。一歩一歩着実にね💋
🔁 ステップ③：実装サイクル〜確認してから動く、動いたら確認〜
👩ママ： さて、いよいよ実装に入るわよ。でもここにも順番があるの✨
3-1. AIに実装内容を説明させる
👩🎤ちぃママ： えっ、説明させるんですかぁ？ 説明するのはアタシじゃなくて？
👩ママ： そうよ。AIに「これからどう実装するか説明して」って聞くの。そうすると、AIが理解している内容と、アンタが期待している内容にズレがないか確認できるわ👀
このPRで実装する内容を説明してください。
修正するファイルと変更内容を具体的に教えてください。
👩🎤ちぃママ： へぇ〜、確認してから進むんですねぇ🎵
3-2. 問題なければ実装（コミット前まで）
👩ママ： 説明を聞いて問題なければ、こう指示するのよ👀
問題ありません。コミット前まで計画を実行してください。
👩🎤ちぃママ： 「コミット前まで」ってところがミソですかぁ？
👩ママ： そうよ💋 いきなりコミットさせないの。実装が終わったらレビューを挟むのよ。
3-3. ローカルでレビュー
👩ママ： 実装が終わったら、テストガイドラインを参照させながらローカルでチェックするの。
👩🎤ちぃママ： テスト⁉️ めんどくさ〜い💦
👩ママ： アンタねぇ…💢 テストしないで本番にデプロイして、夜中に電話鳴らされたいの⁉️
👩🎤ちぃママ： ぜ、絶対イヤですぅ💦
👩ママ： でしょ？ だから、こうやってレビューを依頼するのよ👀
テストガイドラインを参照して、実装内容をレビューしてください。
ローカルでの動作確認も行ってください。
レビューで確認すべきこと
- コードスタイルは統一されているか？
- エラーハンドリングは適切か？
- テストは書かれているか・パスするか？
- パフォーマンスに問題はないか？
📝 ステップ④：コミット＆プルリク作成〜区切りをつける美学〜
👩🎤ちぃママ： やっとコミットですねぇ✨
👩ママ： そうよ。レビューで問題なければ、コミットしてプルリクを作成するの。
問題なければコミットしてプルリクエストを作成してください。
👩🎤ちぃママ： コミットメッセージってどうすればいいんですかぁ？
👩ママ： AIに任せてもいいけど、何を変更したか一目でわかるメッセージにするのが基本よ。
| NG例 | OK例 |
|---|---|
fix |
fix: ログイン時のnullチェックを追加 |
update |
feat: ユーザー通知機能を追加 |
修正 |
refactor: 認証ロジックをServiceに分離 |
👩🎤ちぃママ： アタシ、全部「fix」にしてましたぁ…💦
👩ママ： まぁ〜💋 アンタの「fix」、全然直ってないものまで含まれてそうね👀
🔍 ステップ⑤：レビュー対応〜磨き上げの時間〜
👩🎤ちぃママ： プルリク作ったら終わりじゃないんですかぁ⁉️
👩ママ： やだぁ‼️ ここからが本番よ‼️ Copilotレビューや人間レビューが入るでしょ？
5-1. Copilotレビューへの対応
👩ママ： GitHub Copilotがレビューコメントをつけてきたら、こうやって対応するの👀
Copilotのレビューコメントを確認してください。
対応が必要なものをプランニングして、コミット前まで実施してください。
👩🎤ちぃママ： また「コミット前まで」ですねぇ！
👩ママ： そう。対応が終わったらまたレビューして、問題なければコミット＆プッシュ。このサイクルよ💋
5-2. 人間レビューへの対応
👩ママ： 人間のレビュアーからコメントが来たときも同じ流れよ。
レビューコメントを確認してください。
指摘事項への対応をプランニングして、実装してください。
👩🎤ちぃママ： 人間のレビューって緊張しますぅ💦
👩ママ： 大丈夫よ。レビューは敵じゃなくて味方なの。コードをより良くするための愛のムチよ💋
🔄 全体のワークフローまとめ
👩ママ： じゃあ、全体の流れをまとめてあげるわね💋
🌹 ママのひとこと
👩🎤ちぃママ： ママ、なんかAIコーディングって、思ってたより段取りが大事なんですねぇ…
👩ママ： そうよ。AIは魔法の杖じゃないの。優秀なアシスタントよ。でもアシスタントも、指示が曖昧だと困るでしょ？
👩🎤ちぃママ： たしかに…アタシも「なんかいい感じにして」って言われたら困りますぅ💦
👩ママ： でしょ？ AIに何をしてほしいか明確に伝える。やったことを確認する。区切りをつける。この繰り返しよ。
👩🎤ちぃママ： なんか、人間同士のコミュニケーションと同じですねぇ🎵
👩ママ： そうなの✨ 結局ね、技術は変わっても、大事なことは変わらないのよ。
段取り八分、仕上げ二分。
準備に時間をかけた分だけ、本番がスムーズに進むの💋
AIコーディングも、急がば回れ。
焦って走り出すより、まず地図を広げなさいな✨
👩🎤ちぃママ： ママ、今日もありがとうございましたぁ！ アタシ、明日から段取りちゃんとしますぅ✨
👩ママ： フッフッフッフッフッフッ〜〜〜〜😤💨 アンタの「明日から」は信用できないけど、まぁ、頑張んなさいな💋
👩🎤ちぃママ： えぇぇ⁉️ 信用してくださいよぉ‼️
👩ママ： 信用は行動で勝ち取るものよ、ちぃママ💄
今日の教訓
AIコーディングは「段取り八分」。
プランニング→分割→確認→実装→レビューのサイクルを回せば、迷子にならないわ💋
参考リンク
Bar Fatal Error より愛を込めて💋
技術は道具、使うのはアナタ。
でも道具の使い方を知らなきゃ、宝の持ち腐れよ✨