【Claude Code 失敗談 #3】「いい感じにして」が、うまく伝わらなくなりがちな話

社員ブログ

※Claude Codeを使用して記事を作成しています。

シリーズ:Claude Codeを使ったAndroidアプリ開発 失敗談

  • #1:指示が曖昧だと、全然違うものができあがりがちな話
  • #2:一度に大きすぎる指示を出すと、収拾がつかなくなりがちな話
  • #3:「いい感じにして」が、うまく伝わらなくなりがちな話 ← 今回

※この記事の事例は、Claude Codeを使った開発で起こりがちなケースをもとにした想定例です。
Claude Codeの出力やエラーの内容は、環境や指示の内容によって異なります。

はじめに

#1・#2で「指示は具体的に、小さく分けて」と学んでも、具体的に書きにくい場面があります。
それがデザインです。

「このアプリをいい感じにしてほしい」

この一言が、地雷になりやすい理由を整理します。

起こりがちなケース

機能の実装が一通り終わり、デザインを整えようとして、次のように指示したとします。

アプリ全体のデザインをいい感じにしてください。

Claude Codeは、いくつかの変更を加えてくれるはずです。
ただし、動かしてみると、次のようなことが起こりえます。

  • フォントが小さくなり、読みにくい
  • ボタンの色が、アプリのイメージと違う
  • 余白がなくなり、詰まって見える
  • すでに整えた画面のデザインまで、変わってしまう

「いい感じ」の解釈が、頭の中のイメージと違う、というケースです。

「いい感じ」が失敗しやすい理由

「いい感じ」という言葉は、人によって意味が違います。

Claude Codeは、「いい感じ」に対して、自分なりの判断で動きます。
その判断が、自分の好みと一致する保証はありません。

さらに「全体のデザインを」という指示は、#2の「大きすぎる指示」とも重なっています。
変更範囲が広すぎて、意図しない部分まで変わりやすくなります。

何が足りないのか

「いい感じ」を言語化すると、何になるのかを整理します。

漠然とした言葉具体的に伝えるべきこと
いい感じどんなアプリのイメージか(シンプル・ポップ・高級感など)
おしゃれ何色をメインにするか、フォントの雰囲気
見やすく文字サイズ・コントラスト・余白の量
統一感を出してどの画面を基準にするか

対策:変える場所・変え方・変えない場所を明確にする

「いい感じ」をやめて、変える場所・変え方・変えない場所を書きます。

メイン画面のデザインだけ変更してください。
ログイン画面と設定画面は今回触らないでください。

変更してほしい内容:
・背景色を白から薄いグレー(#F5F5F5)に変える
・メモ一覧の各アイテムを白いカード(角丸8dp・影あり)で囲む
・「+」ボタンの色を青(#1976D2)にする
・文字サイズは今のまま変えないでください

こうすると、意図した範囲だけを、変更してもらいやすくなります。

デザイン指示で使えるフレーズ集

「いい感じ」の代わりに使えるフレーズをまとめます。

色の伝え方:

・テーマカラーを青系(#1565C0)にしてください
・落ち着いたトーンで、白・グレー・ネイビーの3色でまとめてください
・今の配色は維持してください

レイアウトの伝え方:

・各要素の間に16dpの余白を入れてください
・カード形式(角丸・薄い影あり)で囲んでください
・リストの行の高さを今より少し広めにしてください

変更範囲の限定:

・〇〇画面だけ変えてください。他の画面は触らないでください
・ボタンのデザインだけ変えて、テキストや色は維持してください

「参考にしてほしいアプリ」を伝えるのも有効

具体的な言葉が浮かばないときは、参考アプリのイメージを伝える方法もあります。

Googleの公式アプリ(GmailやGoogle Keepなど)のような
シンプルでフラットなデザインにしてください。
過度な装飾は不要です。
メモ帳アプリらしい、落ち着いた和風テイストにしてください。
ベージュ・ブラウン系でまとめてほしいです。

まとめ

「いい感じ」「おしゃれに」「きれいに」という言葉は、Claude Codeに対して、ほとんど何も伝えていないに等しいです。

デザインに関しては特に、具体的な色・サイズ・変更範囲を明示する必要があります。
また、「変えない場所」を明示するのも、同じくらい重要です。

頭の中のイメージを言語化するのは、最初は難しいですが、「なぜそのデザインがよいのか」を言葉にしていくと、指示もうまくなっていきます。

次回:【Claude Code 失敗談 #4】前の会話の文脈が消えて、同じ失敗を繰り返しがちな話

タイトルとURLをコピーしました