Claude Codeアプリ開発で学ぶAIと協働する要件整理術

Claude Codeアプリ開発で大切なのは、AIに「アプリを作って」と頼むことだけではありません。使う人の不安や習慣、言葉になっていない希望を観察し、AIが理解できる要件へ変換する力が必要です。本書の紹介からは、コード生成の技術だけでなく、AIと一緒に価値を生み出すための考え方を学べます。

Claude Codeアプリ開発で最初に考えるべきことは何か

最初に考えるべきなのは、どんなコードを書くかではなく、誰のどんな困りごとを解決するかです。目的が曖昧なまま依頼すると、動くアプリができても、利用者にとって使いやすいものになるとは限りません。

AIは、入力された指示をもとに形を作る道具です。人間同士なら表情や声の調子から補える曖昧さも、文章だけの指示では十分に伝わらない場合があります。そのため、「家族が毎日使う」「初めてでも迷わない」といった背景まで言葉にすることが重要になります。

投稿で紹介されている本では、Claude Codeが書かれた指示を正確に形にするからこそ、指示を作る側の理解が問われると説明されています。これは、AIの性能だけに期待するのではなく、依頼する人が問題を整理する必要があるという意味です。

機能より先に利用場面を決める

たとえば「予定を管理するアプリ」と考えるだけでは、必要な画面や操作方法は決まりません。外出前に短時間で確認するのか、家族と共有するのか、入力が苦手な人でも使うのかによって、必要な設計は変わります。

• 誰が使うのか
• いつ、どこで使うのか
• 何に困っているのか
• 使い終わったとき、どんな状態になればよいのか

このような問いに答えると、単なる機能一覧ではなく、利用者の行動に結びついた要件になります。初心者は、まず一人の具体的な利用者を思い浮かべると整理しやすいでしょう。

利用者の不安や習慣を要件へ変える方法

利用者の要望を要件へ変えるには、表面的な発言だけでなく、その背景にある不安や習慣を読み取ることが大切です。観察した内容を「利用者の状況」「困りごと」「必要な支援」に分けると、AIに伝えやすい形になります。

本書の紹介では、奈央が父親の反応を見ながらプロンプトを書き直す姿が描かれています。ここで示されているのは、最初の指示を一度出して終わるのではなく、実際の反応を手がかりに改善する姿勢です。

たとえば、父親がボタンの意味を理解できなかったなら、「説明を追加する」だけでなく、文字の大きさ、配置、言葉の選び方、操作の順番を見直す必要があります。反応は失敗の証拠ではなく、要件を具体化するための貴重な情報です。

この表のように、観察を具体的な設計条件に置き換えると、Claude Codeへの依頼も明確になります。「高齢者向けにして」とだけ伝えるより、「重要な操作は画面上部に置き、専門用語を避け、入力後に内容を確認できるようにする」と伝えるほうが、意図が共有されやすくなります。

AIへのプロンプトを改善するための考え方

良いプロンプトは、命令文を長くすることではなく、AIが判断に必要な前提を過不足なく含めた指示です。目的、利用者、場面、守る条件、確認したい結果を順番に整理すると、修正しやすい依頼になります。

プロンプト（AIへの指示文）を作るときは、次の順番が役立ちます。まずアプリの目的を示し、次に対象となる利用者を説明します。そのうえで必要な機能、避けたいこと、完成後に確認したいポイントを加えます。

1. アプリで解決したい問題を書く
2. 主な利用者と利用場面を説明する
3. 必要な画面や操作を箇条書きにする
4. 使いやすさや避けたい表現などの条件を加える
5. AIの提案を確認し、足りない点を次の指示で修正する

重要なのは、最初から完璧な指示を書こうとしすぎないことです。AIが作ったものを確認し、利用者がどこで戸惑うかを見つけたら、その観察結果を次のプロンプトへ反映します。これは、会話を重ねながら設計を育てる作業だと考えると分かりやすいでしょう。

曖昧な言葉を具体化する

「簡単に」「見やすく」「便利に」といった言葉は便利ですが、解釈が人によって異なります。「一つの画面に表示する項目を絞る」「初めて使う人が次の操作を判断できる」といった観察可能な条件に置き換えると、AIへ伝えやすくなります。

さらに、優先順位も示しましょう。すべての要望を同じ重さで並べると、AIがどの機能を先に整えるべきか判断しにくくなります。安全性、分かりやすさ、必要最低限の機能など、何を優先するかを明らかにすることが大切です。

Claude Codeとの協働で人間が担う役割

Claude Codeとの協働で人間が担う役割は、単にコードを入力することではありません。利用者の課題を見つけ、要件を決め、AIの出力が目的に合っているか判断することが中心になります。

AIは指示に沿ってコードや画面の形を作れますが、そのアプリが本当に必要か、利用者が安心して使えるか、目的から外れていないかを最終的に考えるのは人間です。完成したように見えることと、価値があることは同じではありません。

この関係は、AIを万能な代行者として扱うより、設計を一緒に進める相手として捉えると理解しやすいでしょう。人間は方向性や判断を担い、AIは具体化や修正を支援します。役割を分けることで、AIの力を活かしながら人間らしい視点も保てます。

この分担を意識すると、「AIが作ってくれるはずなのに思った通りにならない」という戸惑いを減らせます。うまくいかないときは、AIを責めるのではなく、目的や条件が十分に伝わっているかを見直してみましょう。

AIを使う側から価値を生む側へ進むステップ

AIを使う側から価値を生む側へ進むには、生成された結果を受け取るだけでなく、課題の発見から改善まで関わることが必要です。小さなアプリを題材に、観察、要件化、依頼、確認、改善の循環を作ると実践しやすくなります。

最初から大きなサービスを完成させる必要はありません。身近な人が困っている場面を一つ選び、最小限の機能で試せる形を考えます。その後、利用者の反応を確認し、必要な部分だけを修正していく方法が現実的です。

1. 身近な利用者の困りごとを一つ選ぶ
2. 困りごとが起きる場面と望ましい状態を整理する
3. 必要最小限の機能をClaude Codeへ依頼する
4. 画面や操作を確認し、迷う点を記録する
5. 観察結果を具体的なプロンプトにして改善する

この流れでは、技術知識だけでなく、聞く力と見る力が重要になります。利用者の反応を「分かっていない」と片づけず、なぜその反応が起きたのかを考えることで、より良い要件を作れるからです。

投稿で紹介されている本が伝えているのは、AIに任せれば何でも自動的に完成するという話ではありません。Claude Codeアプリ開発を通じて、使う人の視点を持ち、言葉にならない希望を具体的な指示へ変換し、AIと対話しながら価値を形にする考え方です。

AIの出力を受け取るだけでなく、利用者の反応を見て問いを更新することが、協働の出発点になります。

これからAIを使ってアプリを作るなら、まず「何を作るか」ではなく「誰の、どんな不便を減らすか」を書き出してみてください。その一歩が、AIを操作する人から、AIと一緒に価値を生み出す人へ変わるきっかけになります。

出典: Amazon掲載ページ（紹介されている書籍）

よくある質問