同じ画面の要望を、文章と画面のたたき台で伝え比べてみた

要件定義
公開日 記事更新日

業務システムの画面の要望を開発会社に伝えるとき、文章だけで伝えるのと、Excel で作った粗い画面の「たたき台」を添えるのとでは、受け取る側の理解はどれだけ変わるのでしょうか。架空の卸売会社の受注の入力画面を題材に、頼む側の頭の中にある画面を31項目の正解表にしておき、伝え方を3通りに変えて、開発会社の担当の代わりをさせた生成AIに3回ずつ読ませました。正しく伝わった数、違って伝わった数、質問で返ってきた数を数えた結果と、発注する側の使い方をまとめます。

この記事でわかること

  • 文章だけ・文章+たたき台・たたき台だけで、画面の要望の伝わり方がどう違ったか
  • どの伝え方でも伝わらなかったこと(頼む側が当然と思っていたこと)
  • 文章とたたき台に、それぞれ何を書くとよいか

こんな方に

  • 業務システムの開発を頼む前に、画面の要望をまとめている総務・営業事務・現場の責任者の方
  • 開発会社に渡す資料を、文章だけにするか、画面の絵も付けるか迷っている方

先に結論

今回の試しでは、正解表31項目のうち、文章+たたき台は3回とも29項目が正しく伝わりました。文章だけは21〜23項目で、明細の列の並びやボタンの位置が違って伝わり、たたき台にしか描いていないボタンは抜けました。たたき台だけは3回とも23項目で、文章に書いた決まり(単価や締めの時刻)の多くは、質問に挙げずに決められるのではなく、質問として返ってきました。一方、頼む側が当然と思って書かなかった「誤りを項目のそばに出す」は、9回とも伝わりませんでした。たたき台には配置と項目を、文章には決まりと、まだ決めていないことを書くのがよいと考えます。

2026年11月22日時点の情報です。料金や制度は変わることがあるため、本文の公式の資料へのリンクで最新の内容を確かめてください。

業務システムを作るとき、発注する側は、使いたい画面の要望を開発会社に伝えます。そのとき、文章だけで伝えることがよくあります。「得意先を選んだら住所が出てほしい」「単価は課長だけが変えられるように」といった箇条書きのメモです。

一方で、Excel や手書きで、画面の粗い絵を描いて渡す方法もあります。この記事では、項目名と入力欄の枠、ボタンを置いただけの粗い画面の絵を「たたき台」と呼びます。

では、文章だけで伝えるのと、たたき台を添えるのとで、受け取る側の理解はどれだけ変わるのか。それを数えてみました。開発会社の担当の代わりを生成AIにさせ、同じ要望を、伝え方を変えて読ませています。

AIに画面のワイヤーフレーム(配置の図)を作らせる試しは、以前「業務システムの画面のワイヤーフレームを、AIで作れるか試してみた」で行いました。そちらは「AIが図を作れるか」を見たものです。この記事は、頼む側の「伝え方」で、受け手の理解がどう変わるかを見ます。

結論:書いたことは伝わる。書いていないことは、文章なら抜け、たたき台なら質問になった

先に結果を書きます。頼む側の頭の中にある画面を31項目の正解表にしておき、伝え方ごとに3回ずつ読ませました。

  • 文章+たたき台は、3回とも31項目のうち29項目が正しく伝わった。 文章に書いた決まりも、たたき台に描いた配置とボタンも、すべて伝わりました。
  • 文章だけは21〜23項目。 明細の列の並びとボタンの位置が3回とも違って伝わり、たたき台にしか描いていない「前回の注文を呼び出す」と「納品書を印刷」のボタンは抜けました。
  • たたき台だけは3回とも23項目。 配置とボタンはすべて伝わりました。文章に書いた決まりの一部(単価を誰が変えられるか、午後3時の締めなど)は伝わらず、今回はその多くが質問として返ってきました。
  • 頼む側が当然と思って書かなかったことは、どの伝え方でも伝わらなかった。 「入力の誤りは、その項目のそばに出す」は、9回とも違う形(画面の1か所にまとめて出す)で作られました。
  • 今回は、迷っていることを「迷っている」と書いたものが拾われた。 文章に「課長の確認を入れるか迷っている」と書いたことは、文章を渡した6回すべてで、画面に入れずに質問になりました。一方、「仕入れが間に合うこともある」とほのめかしただけの「在庫が足りないときに分けて納めるか」は、9回とも出てきませんでした(どちらも1項目ずつの結果で、書き方のほかに中身も違います)。保存後の修正や消費税の端数のような、よくある確認は、書かなくてもほぼ毎回質問に出ました。

つまり、今回の条件では、文章とたたき台は伝わるものが違いました。たたき台は配置と項目を、文章は決まりと、まだ決めていないことを伝えました。そして、どちらにも書かなかったことは、受け手に任されました。

試したこと

架空の卸売会社の、受注の入力画面

業務用の食品を飲食店に卸している、架空の会社を想定しました。注文は電話と FAX で受け、紙の受注票に書いてから Excel に打ち直しています。これを、受けたその場でパソコンの画面に入力できるようにしたい、という要望です。画面は、受注の入力画面の1つだけです。

発注する側がよく書く程度のメモとして、次の文章を用意しました。A4 で1枚ほど、空白を除いて838字です。

【受注の入力画面について(要望のメモ)】

当社は、業務用の食品を飲食店に卸している会社です。注文は電話とFAXで受けることが多く、メールで来ることも少しあります。いまは注文を受けた人が紙の受注票に書き、あとで事務がExcelに打ち直しています。打ち直しの手間と写し間違いが多いので、注文を受けたその場でパソコンの画面に入力できるようにしたいと考えています。

■ 使う人
・事務の3人が、会社のパソコンで入力します。
・営業の2人も、会社にいるときは入力することがあります。
・課長が1人います。

■ 入れたいこと
・注文を受けた日
・どのお店(得意先)からの注文か。得意先は200件ほどあるので、得意先のコードか、名前の一部で探して選べるようにしたいです。選んだら、そのお店の住所と電話番号を画面で確かめたいです。
・納品する日
・本店で注文を受けて、支店に届けるように、注文したお店と違うお店に届けることがあります。
・注文の中身は、商品と数量です。商品も、商品のコードか名前で探せるようにしたいです。1回の注文で、多いときは20品目くらいになります。

■ 決まりにしたいこと
・単価は得意先ごとに決まっているので、商品を選んだら、そのお店の単価が自動で出るようにしてほしいです。
・単価を変えられるのは課長だけにしたいです。
・金額と合計は、自動で計算してほしいです。
・得意先、納品日、商品(1つ以上)は、必ず入れるようにしたいです。
・納品日が、注文を受けた日より前になっていたら、入れられないようにしてほしいです。
・在庫より多い数を入れたときは、気づけるように注意を出してほしいです。ただ、仕入れが間に合うこともあるので、登録はできるようにしておきたいです。
・午後3時を過ぎてから受けた注文は、その日のうちに届けられないので、納品日が今日になっていたら注意を出してほしいです。

■ そのほか
・たまに値引きをすることがあります。
・金額の大きい注文は、課長に一度見てもらう仕組みがいるかどうかは、まだ迷っています。

画面のたたき台:Excel の方眼に、項目名と枠を置いただけ

たたき台は、Excel で作ったような粗い画面にしました。項目名、入力欄の枠、選ぶ欄の「▼」、ボタン、明細の表だけです。「自動」「必須」のような決まりの書き込みは、わざと入れていません。

試しに使った、受注の入力画面のたたき台
Excel の方眼の上に描いた受注入力の画面。上に受注番号・受注日・受け方、得意先と検索ボタン・担当、住所・電話、納品日・納品先、備考の欄が並ぶ。その下に前回の注文を呼び出すボタンと、No・商品コード・商品名・数量・単位・単価・金額・削除の列がある明細の表、行を追加のボタン、右下に小計・消費税・合計の欄、いちばん下の左に取消、右に保存と納品書を印刷のボタンがある

項目名と配置だけを描き、決まりは書いていません。文章(メモ)とたたき台は、どちらも頼む側の同じ頭の中の画面から作りました。

正解表:31項目と、まだ決めていない5つ

AIに読ませる前に、頼む側の頭の中にある画面を、31の項目に分けて正解表にしました。結果を見てから基準を変えないよう、正解表と文章、たたき台、頼む文は、AIに読ませる前に先に作っておきました。

31項目は、どの資料から読み取れるかで4つに分けました。

区分数例
文章だけに書いた10商品をコードか名前で探す、単価は得意先ごとに自動で入る、単価を変えられるのは課長だけ、午後3時を過ぎて納品日が今日なら注意、在庫より多い数は注意を出すが登録はできる、入力するのは事務3人と営業2人
たたき台だけに描いた12画面の上・中・下の配置、明細の列の並び、取消は左下・保存と印刷は右下、受注番号・担当・備考・単位の欄、行の追加と削除、前回の注文を呼び出すボタン、小計・消費税・合計の3つを並べること(小計と消費税の欄はたたき台にだけある。合計を自動で計算することは文章の側の項目)、納品書の印刷
両方にある6受注日、受け方(電話・FAX・メール)、得意先を探して選ぶ、住所と電話が出る、納品日、納品先
どちらにもない3担当は得意先の営業担当が自動で入る、入力の誤りは保存を押したときに項目のそばに出す、取消を押したら確かめてからやめる

「どちらにもない」3項目は、頼む側が当然と思って書き忘れたことです。実際の要望でも、こうした抜けは起こりやすいと考えます。これらが受け手にどう扱われるかも見ました。

あわせて、頼む側がまだ決めていないことを5つ置きました。

まだ決めていないこと資料での出方
U1値引きをどう入れるか文章に「たまに値引きをする」とだけ書いた
U2金額の大きい注文に課長の確認を入れるか文章に「まだ迷っている」と書いた
U3保存した注文を、あとで直したり取り消したりできるかどこにも書いていない
U4在庫が足りないとき、あるだけ送って残りをあとで送るか文章に「仕入れが間に合うこともある」とだけ書いた
U5消費税の1円未満の端数をどうするかどこにも書いていない(たたき台に消費税の欄だけ)

3つの伝え方を、3回ずつ

受け手は、Anthropic社の生成AI「Claude」(Opus 5.5)です。2026年11月22日に、Claude Code を画面なしで動かして試しました。過去のやり取りや設定は読み込ませず、回ごとに空のフォルダで動かしています。9回とも、使える道具は画像を読む道具だけにしました。たたき台を渡す回だけ、フォルダに画像を置きました。もとから入っている指示(システムプロンプト)は、「チャットで答える。ファイルは作れない」という短いものに差し替え、開発会社の担当という役は、頼む文の側で与えました。料金は9回で約8.2ドル(定価で計算)でした。

伝え方渡したもの回数
文章だけ上の文章3回
文章+たたき台上の文章と、たたき台の画像3回
たたき台だけたたき台の画像3回

文章は、文章だけの回と、文章+たたき台の回とで、一字一句同じです。頼む文も同じで、たたき台を添える回だけ「画像はここにあります」という一文を足しました。頼んだのは次の3つです。

  1. 理解した内容を、画面の上から順に、項目の一覧で書く(入力か表示か、必須か、決まりや動き、ボタンも含めて)
  2. お客様に確認したい質問を挙げる
  3. 理解した内容をもとに、画面の見本を1つの HTML で作る

1回にかかった時間は、文章だけで126〜216秒、文章+たたき台で170〜344秒、たたき台だけで104〜136秒でした。9回のうち8回は同時に動かしたので、時間は目安です。

数え方

9回の返事を、正解表の項目ごとに、一覧・質問・HTML の画面を合わせて見て、次の4つのどれかに分けました。

  • 正しく理解:意図どおりの内容が、一覧か HTML にある
  • 質問で拾った:意図どおりではないが、その点を質問に挙げた
  • 違って理解:意図と違う内容を、質問に挙げずに決めて書いた・作った(仮の印の有無は問わない)
  • 触れず:一覧にも HTML にも質問にも出てこない

配置の項目は、HTML をブラウザで開いた画面で確かめました。まだ決めていない5つは、質問に挙げたか「未定」と書いたかで数えています。

判断が分かれた所

次の項目は、数え方しだいで結果が変わります。どう数えたかを書いておきます。

  • 誤りの出し方(項目のそばに出す):たたき台だけの3回は、保存のときに誤りのある欄の枠を赤くしました。ただ、誤りの文は画面の1か所にまとめて出していたので、「違って理解」と数えました。枠を赤くしたことを「項目のそば」とみれば、この3回は「正しく理解」になります。
  • 担当の欄と、担当の入り方:文章だけの3回が置いた「受付者」「受付担当」「入力者」は、ログインした人を出す欄で、営業の担当の欄ではないと考え、担当の欄は「触れず」と数えました。担当の入り方は、担当が誰のことかを質問した回を「質問で拾った」と数えました。得意先の担当を自動で入れるかまで聞いたのは、そのうち2回です。
  • 必須の項目:意図の3つ(得意先・納品日・商品1つ以上)が必須になっていれば「正しく理解」と数えました。9回とも受注日も必須にしていて、ほかの項目を足した回もあります。足した分は数に入れていません。
  • 納品書の印刷(文章だけの3回目):「受注票や FAX での返信を紙に出す機能はいりますか」という質問は、納品書の印刷とは別のものとみて「触れず」と数えました。
  • 値引き(たたき台だけの回):2回は、単価をその場で値引きして書き換えるかを質問しました。値引きの入れ方そのものを聞いたわけではありませんが、値引きに触れたので「未定として扱えた」と数えました。

結果①:文章+たたき台は、3回とも29項目が伝わった

9回の内訳は次のとおりです。

伝え方ごと・回ごとの、正解表31項目の内訳
伝え方ごとに3回ずつの横棒グラフ。文章だけは正しく理解が23・23・21項目、違って理解が3項目ずつ、触れずが3〜4項目。文章+たたき台は3回とも正しく理解が29項目、違って理解が1〜2項目。たたき台だけは3回とも正しく理解が23項目、質問で拾ったが5〜6項目

31項目を、正しく理解・質問で拾った・違って理解・触れずの4つに分けた数です。生成AI(Claude Opus 5.5)に開発会社の担当の代わりをさせ、2026年11月22日に試しました。

伝え方正しく理解質問で拾った違って理解触れず
文章だけ21〜231〜333〜4
文章+たたき台290〜11〜20
たたき台だけ235〜61〜21〜2

文章+たたき台の3回は、文章に書いた10項目、たたき台に描いた12項目、両方にある6項目の、合わせて28項目がすべて正しく伝わりました。残る1項目は、どちらにもない「取消を押したら確かめてからやめる」で、これは9回とも作られていました。

29項目に入らなかった2項目は、どちらも頼む側が書かなかったことです。それについては結果④で書きます。

伝え方による差は、何が抜けたか、抜けた所をどう扱ったかに出ました。区分ごとに分けると、違いがはっきりします。

文章に書いた決まりと、たたき台に描いた項目の伝わり方(3回の合計)
横棒グラフ。文章だけに書いた決まり10項目×3回は、文章だけと文章+たたき台で30すべて正しく理解、たたき台だけでは正しく理解12、質問で拾った13、違って理解1、触れず4。たたき台だけに描いた12項目×3回は、文章+たたき台とたたき台だけで36すべて正しく理解、文章だけでは正しく理解17、質問で拾った5、違って理解6、触れず8

3回分の合計です。資料に書いてあったことは、渡した回ではすべて伝わりました。差が出たのは、渡していない資料にしか書いていないことの扱いです。

結果②:文章だけだと、並びとボタンが違って伝わり、一部のボタンは抜けた

文章だけの3回は、文章に書いた10項目は3回ともすべて正しく伝わりました。得意先をコードか名前の一部で探す、単価は得意先ごとに自動で入り課長だけが変えられる、午後3時を過ぎて納品日が今日なら注意を出す、といった決まりは、一覧にも HTML の動きにも入っています。

違ったのは、画面の形です。

  • 明細の列の並び:3回とも、たたき台とは違う並びで作りました。3回とも在庫の列を足し、2回は「単位→在庫→数量」、1回は「在庫→数量→単位」の順でした。
  • ボタンの位置:3回とも、入力をやめるボタン(1回は「クリア」)と登録のボタンを、右下に並べました。頼む側の意図は、取消は左下、保存と印刷は右下です。
  • 抜けたボタン:「前回の注文を呼び出す」は3回とも出てきませんでした。「納品書を印刷」は2回は出てこず、1回は「受注票や納品書を印刷しますか」という質問になりました。
  • 消費税:3回とも、画面には小計・値引き・合計だけを置き、消費税を画面に出すかを質問にしました。
  • 担当:3回とも、得意先の営業担当の欄はなく、代わりに「受付者」「受付担当」「入力者」として、ログインした人を出しました。

一方で、文章にない項目を、自分で足してもいました。受注番号と単位の列は3回とも足しています。受け方と備考は、2回が「仮」「提案」の印を付けて足し、残りの1回は「入れたいものはありますか」と質問しました。値引きの欄も、3回とも仮の印を付けて置きました。

文章だけを読んで作られた画面の例(1回目)
AIが文章だけを読んで作った受注入力の画面。注文の基本情報、得意先と納品先、注文の中身、備考の4つの枠に分かれ、明細の列は商品・商品名・単位・在庫・数量・単価・金額の順。合計の欄は小計・値引き・合計で消費税はない。前回の注文を呼び出すボタンと納品書を印刷のボタンはなく、入力をやめるボタンと登録するボタンが右下に並ぶ

文章に書いた決まりは入っていますが、明細の列の並び、ボタンの位置、ボタンの数がたたき台と違います。仮の項目には「仮」の印が付いています。

できあがった画面は、どれも筋が通っていて、使えそうに見えます。だからこそ、頼む側の頭の中の画面と違っていても、その場では気づきにくいところです。列の並びやボタンの位置は、文章で書こうとすると長くなり、書く側も省きがちです。今回の文章にも、並びや位置は書いていませんでした。

結果③:たたき台だけだと、決まりは「質問」になった

たたき台だけの3回は、たたき台に描いた12項目が、3回ともすべて正しく伝わりました。列の並びもボタンの位置も、たたき台のとおりです。HTML の画面も、たたき台とほぼ同じ配置になっています。

一方で、文章にしか書いていない10項目は、3回合わせて30のうち、正しく伝わったのが12、質問で拾ったのが13、違って伝わったのが1、触れなかったのが4でした。

正しく伝わった12は、金額は数量×単価で自動、合計は自動、必須の項目、納品日が受注日より前ならエラー、の4項目です。必須の項目は、意図の3つ(得意先・納品日・商品1つ以上)が含まれていたものを「正しく理解」と数えました。3回とも、受注日・受け方・担当も必須にしていました。また、必須と日付の決まりは、3回とも「仮」の印を付けた推測でした。推測が意図と合っていた、ということです。

質問になったものには、次のようなものがあります。

  • 単価は得意先ごとに違いますか。この画面で書き換えてもよいですか(3回とも)
  • 納品日に決まりはありますか。締めの時刻を過ぎたら翌々日から、などはありますか(3回とも)
  • 商品名から探したいこともありますか(2回)
  • 在庫が足りないときに知らせる必要はありますか(2回)

目立ったのは、質問に挙げずに決めた数が少なかったことです。文章にしか書いていない10項目で違って伝わったのは、3回で合わせて1項目(商品名の欄を表示だけにした回)でした。たたき台だけの回は、3回とも推測したところに「仮」の印を付け、質問と対応させていました。1回目は返事の初めに、画像から分かるのは項目名・配置・入力欄の形・ボタンまでで、入力か表示か、必須か、どう動くかの多くは推測だ、と書いています。仮・想定・推定といった語は、一覧までの部分に28〜36回出てきます。文章だけの回は9〜16回、文章+たたき台の回は15〜18回でした。

確認したい質問の数も、たたき台だけの回が多めでした。番号を付けた質問の数は、たたき台だけで17〜25、文章だけで12〜23、文章+たたき台で15〜20です(質問の下の箇条書きは数えていないので、数個ずれます)。

ただし、質問で拾えたのは、受け手が思いつける範囲です。入力できる人が事務3人と営業2人であることは、たたき台だけの3回とも触れていません。「課長だけが単価を変えられる」も、「書き換えてよいか」という質問にはなりましたが、課長だけという形までは出てきませんでした。

結果④:頼む側が当然と思ったことは、どの伝え方でも伝わらなかった

どちらの資料にも書かなかった3項目は、伝え方による差がほとんどありませんでした。

書かなかったこと結果
入力の誤りは、保存を押したときに項目のそばに出す9回とも、保存のときの誤りの文を、画面の1か所にまとめて出す作り。たたき台だけの3回は欄の枠も赤くし、文章+たたき台の2回は日付の誤りだけを欄のそばに出した
担当は、得意先の営業担当が自動で入る5回は、担当が誰のことか(注文を受けた人か、営業の担当か)や、得意先の担当を自動で入れるかを質問。1回はログインした人を初期値にすると決めて描いた。文章だけの3回は営業担当の欄がなかった
取消を押したら、確かめてからやめる9回とも、確かめる表示を出してから消す作り

誤りの出し方は、どれも「よくある作り」です。間違いではありません。ただ、頼む側が「項目のそば」を当然と思っていたなら、できあがってから「思っていたのと違う」になります。受け手は、書いていないことを、自分の知っている一般的な形で埋めます。そして今回は、一般的な形で埋めたことは、質問にも挙がりにくいようでした。誤りの出し方を質問に挙げた回は、9回中1回もありませんでした。

画面の型ごとに、発注する側が決めておくこと(誤りの出し方、保存できたことの知らせ方、権限ごとの見え方など)は、「現場が迷わない業務システムの画面づくり」にまとめています。当然と思っていることを見つけるには、こうした一覧を見ながら、自社の答えを書き出していくのが近道です。

結果⑤:今回は、まだ決めていないことのうち「迷っている」と書いたものが拾われた

まだ決めていない5つを、「未定」として扱えた回の数です(3回のうち)。

まだ決めていないこと文章だけ文章+たたき台たたき台だけ
U1 値引きの入れ方332
U2 課長の確認を入れるか330
U3 保存後の修正・取り消し333
U4 在庫が足りないとき分けて納めるか000
U5 消費税の端数233

まだ決めていないことを、質問に挙げずに決めた回はありませんでした。値引きは、文章を渡した6回すべてが、注文全体から金額で引く欄を仮の印付きで置き、そのうえで、商品ごとか全体か、誰が入れられるかを質問しています。課長の確認は、文章を渡した6回とも画面には入れず、入れるならいくら以上の注文が対象かを質問しました。

一方、文章に「仕入れが間に合うこともある」とだけ書いた、分けて納めるかどうかは、9回とも出てきませんでした。比べる在庫の数をどう数えるか(ほかの注文の分や入荷の予定を考えるか)を質問した回は4回ありましたが、足りないときにどう納めるかまでは届いていません。今回は、「迷っている」とはっきり書いたものは拾われ、ほのめかしただけのものは拾われませんでした。ただし、比べたのは1項目ずつで、書き方のほかに中身も違うため、書き方だけの差とは言い切れません。

なお、どこにも書かなかった2つのうち、保存した注文の修正や取り消しは9回とも、消費税の端数は9回中8回、質問に出ました。どちらも、受注の画面ではよくある確認です。受け手が思いつきやすいことは、書かなくても拾われやすく、その会社ならではの事情(今回の分けて納めるか)は拾われにくいのかもしれません。

文章とたたき台の両方を渡した回では、ほかにも気づいたことがあります。3回のうち2回は、項目ごとに、文章から読んだのか、たたき台から読んだのか、推定なのかを書き分けました。その2回は、値引きや在庫の数のように、文章にあってたたき台にないものを挙げて、どう扱うかを質問しています。2つの資料のずれが、そのまま確認の材料になっていました。

読み取ったこと

9回の結果から読み取れることを、4つにまとめます。

  1. 今回は、資料に書いたことは、渡せば伝わった。 文章に書いた決まりは、文章を渡した6回ですべて伝わりました。たたき台に描いた項目は、たたき台を渡した6回ですべて伝わりました。
  2. 文章は配置を、たたき台は決まりを伝えにくい。 文章だけでは、列の並びやボタンの位置が違って伝わりました。たたき台だけでは、単価や締めの時刻といった決まりは伝わりませんでした。
  3. 抜けたときの扱いが違う。 文章だけの回は、抜けた所を画面の上で埋めて描き、違って伝わったのは3回とも3項目ずつでした。たたき台だけの回は、抜けた所の多くを質問にしました。たたき台は、受け手に「ここは分からない」と気づかせやすいのかもしれません。
  4. どちらにも書かなかったことは、受け手が一般的な形で埋める。 誤りの出し方のように、頼む側が当然と思うことは、どの伝え方でも伝わりませんでした。

発注する側の使い方:文章とたたき台に、役割を分けて書く

明るいオフィスの窓ぎわの席で、紺のセーターの男性がノートパソコンの横に置いた手書きの格子の紙を指で押さえ、紙を見比べている

今回の結果をもとに、画面の要望を開発会社に渡すときの分け方を考えます。

たたき台に描くもの:配置と、項目と、ボタン

  • 画面の上・中・下に何を置くか
  • 項目の名前と並び(明細なら列の順番)
  • ボタンの名前と位置
  • 選ぶ欄か、書く欄か、表示だけの欄か(「▼」や下線だけの欄で描き分けると伝わります)

Excel の方眼でも、手書きを写真に撮ったものでも十分です。今回のたたき台も、色も飾りもない粗いものでした。見た目を作り込む必要はありません。

文章に書くもの:決まりと、誰が、と、まだ決めていないこと

  • 自動で入るもの、自動で計算するもの
  • 必ず入れる項目と、入れられない値(日付の前後など)
  • 注意を出すだけか、止めるか(今回の「在庫より多いと注意、登録はできる」のように)
  • 誰が使い、誰が何を変えられるか
  • まだ決めていないこと。迷っていることは「まだ迷っている」と書く

どちらにも書きにくいものは、一覧で洗い出す

今回、どの伝え方でも伝わらなかったのは、頼む側が当然と思っていたことでした。誤りの出し方、取り消しの確認、担当の初期値などです。こうしたことは、書こうと思わないと書けません。画面の型ごとに決めることの一覧を見ながら、「うちはどうしたいか」を1行ずつ書き足すのがよいと考えます。

受け取った返事は、3つに分けて読む

開発会社から返ってきた理解の一覧や画面の見本は、次の3つに分けて読むと、確かめやすくなります。

  • 資料のとおりか:書いたこと・描いたことが、そのとおりに入っているか
  • 仮に決めたこと:「仮」「想定」などの印が付いたものは、本当にそれでよいか
  • 印のない決めごと:印も質問もないのに、資料に書いていないことが決まっていないか。今回の誤りの出し方のように、ここがいちばん見落としやすい所です

この試しの限界

今回の結果は、次の条件のもとでのものです。

  • 受け手は人ではなく、生成AIの代役:開発会社の担当の代わりを、1つの生成AIにさせました。人の担当なら、打ち合わせで聞き返したり、業界の経験から補ったりします。人の開発会社でも同じ結果になるとは言い切れません。
  • 題材は1つ、回数は少ない:架空の会社の、受注の入力画面1つだけです。伝え方ごとに3回で、合わせて9回です。画面が増えたり、業務が複雑になったりすると、結果は変わる可能性があります。
  • 正解表もたたき台も、同じ側が作った:何をどちらの資料に書くかは、こちらで決めています。文章をもっと詳しく書けば、文章だけでも配置は伝わるかもしれません。今回の文章は、発注する側がよく書く程度のメモを想定したものです。
  • 採点は人ではなく生成AIが行った:採点は、正解表と決まりに沿って生成AI(Claude)が行いました。そのあと別の生成AIが記録を照らし合わせ、1か所の判定を直しています。「質問で拾った」か「違って理解」かの線引きには判断が入ります。判断が分かれた所は「判断が分かれた所」に書きました。採点の記録は公開していません。
  • 頼む文が質問を求めた:頼む文で「確認したい質問を挙げる」ように求めたので、質問が出やすい条件でした。質問を頼まなければ、質問に挙げずに決める回が増える可能性があります。
  • システムプロンプトを差し替えた:Claude Code にもとから入っている指示を、短いものに差し替えて試しました。ふだんの使い方とは条件が違います。
  • たたき台が文章より有利な作りになっている面がある:たたき台に描いた項目(12)は、文章だけに書いた項目(10)より多く、配置の項目は文章では伝えにくいものです。区分ごとの数も合わせて見てください。

クリーヴァに相談するとき

クリーヴァは、業務システムの要件の整理から、開発、公開後の保守までをお手伝いしています。手元にあるのが走り書きのメモや、Excel で描いた粗い画面の絵だけ、という段階からご相談いただけます。一緒に、文章とたたき台のどちらに何を書くか、どこがまだ決まっていないかを整理するところから始められます。

おわりに

同じ画面の要望を、文章だけ、文章+たたき台、たたき台だけの3通りで伝えたところ、今回の条件では、文章+たたき台が3回とも31項目のうち29項目を伝えました。文章だけでは配置とボタンが、たたき台だけでは決まりが伝わりにくく、どちらにも書かなかったことは、どの伝え方でも伝わりませんでした。

画面の要望を伝えるときは、たたき台に配置と項目を、文章に決まりと、まだ決めていないことを書く。そのうえで、当然と思っていることを一覧で洗い出す。今回の条件では、粗いたたき台を1枚添えると、配置とボタンが伝わりました。

よくある質問

画面のたたき台は、どんな道具で作ればよいですか

今回は、Excel の方眼の上に、項目名と入力欄の枠、ボタンを置いただけの粗いものを使いました。それでも、たたき台を添えた回は、配置とボタンが3回とも伝わりました。手書きを写真に撮ったものでも、スライドでもかまいません。大事なのは見た目の作り込みではなく、項目名と並び、ボタンの位置が分かることです。

たたき台があれば、文章の説明はいりませんか

今回の試しでは、たたき台だけでは、単価を誰が変えられるか、午後3時の締めといった決まりは伝わらず、質問として返ってきました。決まりや権限、まだ決めていないことは、絵には描けません。たたき台に配置と項目を、文章に決まりを、と役割を分けて両方を渡すのがよいと考えます。

この結果は、人の開発会社にも当てはまりますか

言い切れません。今回の受け手は、開発会社の担当の代わりをさせた生成AIで、題材は1つの画面、回数は伝え方ごとに3回です。人なら、打ち合わせで聞き返したり、業界の慣れから補ったりします。ただ、資料に書いていないことは受け手が推測するしかない、という点は、人でも同じだと考えます。

宮﨑 達也

この記事を書いた人・監修

宮﨑 達也

クリーヴァ株式会社 代表

2004年から20年以上、大手通信会社・インターネットサービス企業・エンターテインメント企業などで、映像配信・デジタルコンテンツ・家計簿サービスの企画や開発のリーダーを務める。2019年にクリーヴァ株式会社を設立し、業務システムと SaaS の要件定義・設計から開発、公開後の改善までをリードしている。業務の整理から、システムの開発と保守、AI の活用まで、現場で使われ続ける仕組みづくりを支援している。

経歴を見る

宮﨑 達也

クリーヴァ株式会社 代表

2004年から20年以上、通信・エンタメ・金融・建築・不動産・電力などの領域で、サービスの企画、要件定義、設計、開発ディレクションに携わってきました。ユーザー向けのサービスと業務システムの両方を経験し、認証・決済・外部サービスとの連携・クラウドまでを見渡して、技術の選び方と開発の進め方を決めます。2019年にクリーヴァ株式会社を設立し、業務システムと SaaS の開発をリードしています。このサイトの「業務改善の教科書」と記事の多くを、書き手・監修者として担当しています。

経歴

  1. 2019年9月〜クリーヴァ株式会社(設立、代表取締役社長)BtoB の業務システムと、お客様専用の SaaS の開発をリード。要件定義・設計から開発・公開後の改善まで担当。
  2. 2019年3月〜8月インターネットサービス企業(出向)金融部門で、メッセージアプリ上と iOS・Android アプリの家計簿サービスの企画を担当(新機能のディレクション、事業計画、チームづくり)。
  3. 2012年5月〜2019年2月大手通信会社映像のストリーミングサービスを提供する合弁会社の立ち上げに参加。映像配信プラットフォームと、デジタルマーケティング(MA・DMP)のシステム開発のリーダー。
  4. 2007年4月〜2012年4月エンターテインメント企業モバイル向けのデジタルコンテンツ配信サイトの企画・開発の技術リーダー。スマートフォン向けのサイトとアプリの企画・開発ディレクション。
  5. 2006年4月〜2007年3月エンターテインメント企業(グループ会社)モバイル向けの月額会員制サイトのデザイン・制作・企画・保守運用。
  6. 2004年4月〜2006年3月システム開発会社BtoB の開発案件で、設計・開発を担当。

クリーヴァで担当した主な開発

  • 助成財団法人の業務 DX(Access で属人化していた業務を、申請者・審査委員・事務局の管理画面とバックエンドに置き換え)
  • 紙の書類を OCR で電子保管する SaaS(PM。ユーザーストーリーづくりから担当)
  • 建築業界向けのシフト管理(LINE ミニアプリ。PM とエンジニアを担当)
  • EV の充電設備のサービス(PM。上流工程と画面設計の一部を担当)
  • 住宅・不動産業界向けの顧客満足度の可視化クラウド(顧客管理・CMS・LINE 連携)
  • 電力データを活用するサービス(PM。依頼元の開発の進め方の改善も担当)
  • パスキーに対応した認証基盤、エンタメ系の動画配信、オンラインくじのプラットフォーム(認証・課金決済・配送伝票の連携)
私たちについてのページで見る

お問い合わせ・ご相談

「何が課題かまだ整理できていない」という段階でも問題ありません。
まずはお気軽にご相談ください。一緒に状況を整理するところから始めます。

無料相談を申し込む

資料ダウンロード

まだ検討中の段階でも、社内にどう説明したらいいかわからないという場面でも。
前進するための資料を、無料でご用意しています。

資料をダウンロードする