メインコンテンツへスキップ
見出し画像

「思っていたのと違う」を減らす要件定義は、図を見せて聞くことから始まる

    要件を文章で丁寧にまとめて、依頼者にも読んでもらって承認を得た。口頭で説明もした。それなのに、出来上がったものを見せた瞬間に「思っていたのと違う」と言われる。

    こういう経験をしたことがある人も、いるのではないでしょうか。

    最近は、AIに頼んで画面の案をすぐに出す進め方も広がっています。形があると話は早く進みます。ただ、それをどこまで信じて進めてよいのか、迷う方も多いと思います。

    私はもともと、要件定義には出来るだけ図やプロトタイプを描いて、視覚的に理解しやすいドキュメントを心がけてきました。そこで分かったのは、図や画面は「決めるための道具」ではなく、「何をしたいのかを確かめるための道具」だということです。この記事では、そのことを3つに分けて書きます。

    1. 文章で伝わらないなら、その場で図を描いて聞けばいい

    文章や口頭だけで要件をすり合わせていた頃は、同じ言葉を使っているのに、思い描いているものが少しずつずれていることが何度もありました。ずれに気づくのは後になってからで、そこからのすり合わせに時間がかかることが双方にとってストレスでした。

    そこで私は、企画会議の最中に、手書きで図を描くようにしました。使っていたのはUMLです。中身はシンプルで、たとえば次のようなものです。

    • 誰が、このシステムで何をするのかを並べた図(ユースケース図)

    • 作業がどの順番で進み、どこで分かれるのかを描いた図(アクティビティ図)

    • 人や仕組みの間で、どんな順番でやりとりが起きるのかを描いた図(シーケンス図)

    図を見せる相手に、UMLの知識はなくてもそこまで困りません。口頭で説明しながら見せるからです。

    描いたその場で相手に見せて「やりたいことは、これで合っていますか」と聞くようにしていました。図は私の答えではなく、認識が合っているかの問いです。違っていれば、相手がその場で線を足したり、消したりできます。

    会議が終わってから清書して送るのではなく、その場で聞くことにも意味がありました。持ち帰ってしまうと、相手は「たぶん伝えた通りのものが出来る」と思いがちです。目の前で一緒に図を見ていれば、その場で「ここはちょっと違う」と言ってもらいやすくなります。

    このやり方に変えてから、すり合わせはずいぶんスムーズになりました。相手に頼まれていなくても、自分の頭の整理も兼ねて、描き続けていました。

    実装も担当するエンジニアだった私には、もう一つ良いことがありました。やりとりの順番を描いた図をできるだけ細かく描いておくと、私の場合は、プログラムの中で「どの部品が、どんな仕事をするか」が自然と決まっていくことが多くありました。結果として、設計そのものにかける時間も短くなりました。

    以前の記事で、完成した姿がイメージしきれないなら聞いてよい、と書きました。図を描いて聞くのは、その「聞く」をいちばん具体的にする方法だと思っています。

    2. 図は、漏れに気づくために描く

    図を描くと、文章では見えにくかった「書いていない部分」が目に入ってきます。私が図を使い続けている一番の理由は、ここにあります。

    うまくいく流れ(正常系)は、比較的そろいやすいものです。差が出るのは、うまくいかなかったときの流れ(異常系)です。

    文章で書いていると、「普通はこうなるだろう」という暗黙の了解が抜けがちです。図にすると、矢印の行き先が描けない場所として、抜けがはっきり見えます。うまくいかないときの流れまで描いてあると、作る側も見積もりや設計を安心して進められます。

    もう一つ、図の描き方をチームでそろえておくことも大切だと考えています。描き方が人によってばらばらだと、同じ図を見ても読み取り方が変わってしまいます。決まった描き方にそろえるのは、見た目を整えるためではなく、認識をそろえるためです。

    PMの立場になってからは、細かい設計を自分で描き切ることより、その前提となる条件をはっきりさせることが仕事だと考えています。図は、その前提の抜けを見つけるための道具として、とても役に立ちます。

    3. 見た目は「確定」ではなく、「何をしたいのか」の確認

    最後に、画面の見た目やプロトタイプ(画面の試作)の話です。

    非エンジニアの依頼者と話すとき、画面の見た目はとても強い共通言語になります。文章よりずっと伝わりますし、今はAIを使えばプロトタイプもすぐに出せます。だから私も、見た目の話から入ること自体はよいと思っています。

    気をつけたいのは、見た目だけで「これで決まり」としてしまうことです。見た目で決めたことを、その通りに作ろうとすると、実は必要以上に難しい作りになってしまうことがあります。

    たとえば、プロトタイプの売上グラフが、注文が入るたびにその場で伸びていく作りになっていたとします。見た目としては分かりやすく、依頼者も「これがいい」と言ってくれるかもしれません。でも、注文のたびに集計し直して画面に送り続ける仕組みと、前日までの数字を朝にまとめて出す仕組みとでは、作る手間が大きく変わることがあります。依頼者が本当にしたかったのは「毎朝、前日までの売れ行きを確かめること」だけかもしれません。それなら、グラフが動く必要はありません。「このグラフは、毎朝に前日までの数字が出ていれば足りますか」と一言聞くだけで、作るものの重さが変わります。

    こうしたずれを見つけるために、私はプロトタイプを一緒に見ながら「このグラフは、いつの数字が出る想定です」「ここを押すと、こう動く想定です」と挙動を説明します。そのあとで、いま説明した流れを描いた図(作業の流れを描いたアクティビティ図や、データがどこからどこへ流れるかを描いた図)を見せて、もう一度確かめます。同じ流れを、画面と図という別々の道具で二度確かめるイメージです。見た目は、何をしたいのかを確かめるための入り口です。確定させるのは、その裏にある「何をしたいか」と「どう動けばよいか」のほうで、図や画面の形そのものではありません。

    そして大筋が決まったら、そのプロトタイプは、作るものの正解としてはいったん捨てます。「プロトタイプのとおりに作ればよい」にならないようにするためです。「何をしたいか」という要件を確定させたら、「どう作るか」はUX設計者や機能設計者といった専門家と一緒に考えます。プロトタイプがあると説明は楽になるので、制作側への説明に使うことはあります。ただしそのときは、「これに引きずられないで」と添えます。

    冒頭の「どこまで信じて進めてよいか」への私の答えは、ここにあります。プロトタイプは、「何をしたいか」を確かめて大筋を決めるところまでは、とても頼りになります。その形を、そのまま作るものの正解として扱い始めたときが危ういのです。AIが出してくれた画面案も同じです。確かめる材料としては頼もしいのですが、そのまま正解としては扱いません。

    おわりに

    文章で伝わらないのは、書き手の力不足だけが原因ではありません。言葉だけでは、人によって思い描くものが違ってしまうからです。

    だから、描いて、見せて、聞く。場面によって、聞き方は変わります。図なら「やりたいことは、これで合っていますか」。画面なら「この画面で、本当にしたいことは何ですか」。でも、確かめたいことはいつも一つです。「実現したいことは、これで叶いますか」。図や画面は、決めるためのものではなく、確かめるためのものです。

     
     
    Webアプリケーションを、組織で形にする専門家。一人で何でも作るエンジニアから、客先に出る立場、PMを経て、プライム上場企業で50人超の制作組織を率いています。判断できる人を増やせば、Webアプリケーションはもっと良くなるはずだ。そう考えて、組織を作っています。

    あなたへのおすすめ