大きめの機能

いくつかの画面にまたがる機能は、先に計画を立て、小さな段階に分けて進めます。

こんなときに使う

  • いくつかの画面にまたがる機能を作りたい
  • データの持ち方から考える必要がある
  • 1回の依頼では終わりそうにない

1回で終わる変更には、小さな変更 を使います。

進め方の考え方

大きな機能を一度に作ると、確かめるところが多すぎて、間違いに気づきにくくなります。そこで、次のように進めます。

  1. 先に、全体の計画を作る
  2. 計画を、小さな段階に分ける
  3. 段階を1つ進めるたびに、PR を作り、プレビューで確かめて、マージする

段階が1つ終わるたびに本番のアプリが少しずつ良くなり、途中で方向を変えることもできます。

ステップ1：計画を作ってもらう

Claude Code で brain-vibe-coding-platform フォルダを選び、新しい会話で、次の依頼文の【 】の部分を書き換えて送ります。

段階に分けた計画を頼む
Claudeプロンプト
【アプリ名】に、次の機能を追加したいです。 作りたいもの： 【例：忘れ物を「保管中」「返却済み」「処分済み」で絞り込めるようにしたい。あわせて、月ごとの件数を見られる画面がほしい】 1回では終わらない大きさだと思うので、次の進め方でお願いします。私はプログラミングの経験がありません。 1. まず、このアプリの CLAUDE.md と PLAN.md を読んでください 2. 作業をいくつかの小さな段階に分けた計画を作り、専門用語を使わずに説明してください。それぞれの段階が終わると、画面で何ができるようになるのかを書いてください 3. データベースの構造や shared/ 配下の変更が必要な段階には、印を付けてください 4. 私が「OK」と言うまで、ファイルは変更しないでください
プランモードを使う

Claude Code には、計画だけを立てて、ファイルを変更しない「プランモード」があります。デスクトップアプリでは、権限モードの選択から Plan を選びます。計画に納得したら、プランモードを解除して、作業を進めてもらいます。

ステップ2：計画を確かめる

次の点を確かめます。

  • それぞれの段階が終わると、何ができるようになるかが分かるか
  • 最初の段階が、小さく始められる大きさか
  • 頼んでいないものが入っていないか

データベースの変更に印が付いた段階があれば、その計画を管理者にも共有しておきます。

ステップ3：計画を保存して、最初の段階を進める

計画に納得したら、次の依頼文を送ります。

計画を保存して、最初の段階を頼む
Claudeプロンプト
この計画で OK です。次の順番で進めてください。 1. main から新しいブランチを作り、計画を【アプリ名】の ai_docs/plans/ に保存して、PLAN.md を更新してください 2. 続けて、最初の段階だけを実装し、ビルドが通ることを確認してください 3. コミットして main へのプルリクエストを作成し、PR の URL を教えてください。次の段階には、私がマージしたあとで進みます

PR ができたら、確認してマージする の手順で、プレビューを確かめてマージします。

ステップ4：次の段階を進める

前の段階をマージしたら、新しい会話で次の段階を頼みます。計画はアプリの中に保存されているので、Claude はそれを読んで続きから進めます。

次の段階を頼む
Claudeプロンプト
【アプリ名】の PLAN.md と、ai_docs/plans/ にある計画を読んでください。前の段階はマージ済みです。 main を最新にしてから新しいブランチを作り、次の段階だけを進めてください。始める前に、この段階で何をするのかを専門用語を使わずに説明し、私が「OK」と言ってから作業してください。 終わったら、ビルドが通ることを確認し、PLAN.md を更新して、main へのプルリクエストを作成し、PR の URL を教えてください。

これを、最後の段階まで繰り返します。

前の段階をマージしてから、次に進む

前の PR をマージする前に、次の段階を頼まないでください。変更が積み重なって、確認もマージもできなくなることがあります。

途中で計画を変えたくなったら

使ってみて考えが変わるのは、よくあることです。計画を直してから、続きを進めます。

計画の見直しを頼む
Claudeプロンプト
【アプリ名】の計画を見直したいです。 変えたいこと： 【例：月ごとの集計より先に、一覧を印刷できるようにしたい】 ai_docs/plans/ の計画と PLAN.md を、この内容に合わせて書き直す案を説明してください。私が「OK」と言ってから、書き直してください。

アプリを大きく作り直したいとき

アプリの作りを根本から変えたいときは、先に管理者に相談します。使っている人や、保存されているデータへの影響が大きいためです。相談の材料として、Claude に現状を調べてもらえます。

作り直しの進め方を相談する
Claudeプロンプト
【アプリ名】を大きく作り直したいと考えています。まだ作業はしないでください。 今の困りごと：【例：機能を足し続けた結果、画面が分かりにくくなった】 こうしたい：【例：よく使う3つの画面だけに整理したい】 残したいもの：【例：これまでに登録したデータ】 今のアプリの作りを調べたうえで、作り直す場合の進め方と、気をつける点を、専門用語を使わずに説明してください。

クイズ

Quiz

3つの段階に分けた計画の、最初の段階の PR をマージしました。次の段階は、どう始めますか？