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

指摘を全部直しても要件定義が通らない理由は、正しさの外にある

    要件定義のレビューで、指摘を一つ書くと、次の指摘が見えてくる。ここが抜けている。この分岐の先が書かれていない。この条件のときの扱いが決まっていない。抜けを埋めてもらえば通せる、と思って一つずつ書いていく。  

    書き終えたとき、自分が疲れていることに気づきました。通すためのレビューを書いていたのです。  

    要件定義を書くPMからは「レビューが怖い」「何をどこまで書けばいいのか分からない」という声を聞くことがあります。レビューする側にも、同じ会議の裏で、こういう疲れがあります。  

    書き手の力量も関係します。ただ、力量だけでは説明がつきません。経験のあるPMでも同じことは起きるし、経験の浅いPMでも一度で通ることがある。違いは、出来上がったものが動いている姿が、書き手の中に見えているかにあります。そしてその姿が、読む人にも見える文書になっているか。  

    要件定義に求められるのは、何を作るかを、作る前に関係者が同じ姿で見られるように書き切ることです。その上で私が求めているのは、作る価値のあるものを作る、ということです。だからレビューは、正しさを検査する場ではありません。完成した姿が見えているかをまず確かめ、見えていれば、それが本当に求められた姿なのかを一緒に問う場です。この記事では、そのための設計を3つに分けて書きます。

    1. 承認の場で最初に見るのは「完成した姿が文書に出ているか」

    要件定義が通るかどうかを、私は正解かどうかで見ていません。最初に見るのは、完成した姿が文書に出ているかです。姿が出ていると分かって初めて、それが本当に求められた姿なのか、作る価値があるのかをレビューできます。姿が見えないままでは、価値は問えません。  

    完成した姿が見えている人の要件定義には、判断が書いてあります。なぜそう動くのか。他の案を捨てた理由は何か。決まっていないことがあるなら、いつまでに誰が決めるのか。Webアプリケーションで言えば、この画面でこの操作をしたとき、この状態のデータはどう扱うのか、が書いてある。書き手の頭の中で、画面が動いているからです。  

    見えていない人の要件定義には、選択肢が並んだままになっています。「AかBか要確認」が残っている。読んでいて、書き手が何を決めたのかが分かりません。頭の中で画面が止まっているので、決めようがないのです。  

    文書の量ではありません。差し戻しのあとに返ってきた修正版で、物理名の表記が全体で揃い、確認方法の列が足され、未確定事項が一覧の表にまとめられていたことがあります。量は増えているのに、読みやすかった。どこを直したかを探さずに済み、書き手の中で完成した姿がはっきりしたことが文書から読めたからです。私はその修正を、ほとんど指摘を足さずに通しました。  

    正解を基準にすると、書き手は正解を当てにいって萎縮します。基準を「完成した姿が出ているか」に置くと、書き手がやることは一つになります。出来上がった画面を頭の中で動かし、止まったところを書くことです。

    2. 姿を鮮明にする場と、姿が出ているかを判定する場は、分ける

    冒頭の疲れの正体は、場の混在でした。  

    書き手は、完成した姿がまだぼんやりしたまま、「この方向で進めていいか」を聞きたかった。私は、実装に進めてよいかを判定する場として見ていた。判定の場にぼんやりした姿を持ち込まれると、レビュアーは姿を鮮明にする作業を指摘の形で肩代わりすることになります。それが、通すためのレビューです。  

    だから、レビューを2つに分けました。  

    事前相談は、完成した姿を一緒に鮮明にする場です。言ってみれば、ミニレビューです。未完成で構いません。悩んでいる状態のままで構いません。私の役割はティーチングとコーチングで、この場では点数をつけません。姿がイメージしきれないなら、聞きに来てください。聞くことは恥ではありません。私も、周りの人も、そうやって育ってきました。聞かずに承認に出すほうが、あとで大きく戻ります。  

    完成した姿は、PMが一人で描き切るものでもありません。要件定義には作り方を書かない、とよく言われます。それでも、作れそうかの見当がないまま書いた「何を」は、現実には形になりません。この画面遷移は実装できるのか、このデータは存在するのか、どれくらいの工数がかかりそうか。品質と費用と納期の釣り合いは、作る側の見当がなければ取れません。どうやればできそうかを想像できるエンジニアの力を借りて、機能要件をすり合わせる。  

    相手はエンジニアだけではありません。画面の流れや操作の設計は、デザイナーとすり合わせて初めて姿になります。エンジニア出身でないPMは機能要件を、エンジニア出身のPMは画面と操作の設計を、それぞれ人の力を借りて描く。相談の場は、その作業を先に済ませる場でもあります。  

    承認レビューは、姿が文書に出ているかを判定する場です。私の役割は承認者で、出ていなければ差し戻します。マイルストーンとして必須です。  

    運用のルールは3つだけです。会議を設定するとき、タイトルか依頼文に【承認】か【事前相談】かを明示する。明示がなければ承認として扱う。そして、指摘は口頭で終わらせず文書に残す。私の部署では GitHub の Issue にまとめていて、相談と承認の履歴が一か所に残ります。  

    3つ目は、自分の失敗から来ています。レビューを口頭で済ませたことがあり、後で修正版を見ると、私が伝えたはずの3点のうち1点しか反映されていませんでした。私自身も「あのとき何を言ったか」を正確には思い出せない。相談の場で姿が鮮明になりかけても、文書に残さなければ翌週には薄れます。  

    メンバーに共有した文章には、こう書きました。「事前相談を挟むことは、評価が下がることでは全くありません。迷ったら事前相談から始めてください」。

    3. 指摘のゴールは「抜けを埋める」ではなく「姿の解像度を上げる」

    レビューの設計で最後に決めるのは、指摘のゴールです。私がレビューで出す指摘には、3つの段階があります。  

    最初の段階は「ここが書かれていない」です。抜けを埋めてもらう指摘で、返ってくる反応は「書き直します」になります。冒頭の疲れは、この段階が延々と続く疲れです。  

    次の段階は「この分岐の先はどうなるか」「この例外のときは誰が何をするか」です。書いてあることを前提に、完成した姿の細部を詰める指摘です。ここに来ると、レビューは検査ではなく対話になります。  

    最後の段階は「もっと良い要件にできるのではないか」です。実現したいことに対して、この手段でいいのか。もっと軽い作り方はないか。ここまで指摘の中身が上がったとき、完成した姿は書き手と読み手の両方に見えています。  

    書き手が最初の段階に留まるとき、原因は力量よりも、指摘の意図が届いていないことにあります。成功指標の書き方を指摘して、文言だけが直って戻ってきたことがあります。私は「どう直すか」を書いて、「なぜ直すか」を書いていませんでした。文言だけが直って返ってくるのは、書き手の理解不足のサインではなく、指摘に完成した姿が書かれていなかったサインです。  

    逆に、最後の段階に着いたと分かる瞬間もあります。指摘したことがすべて本文に反映され、指摘していない不整合まで自力で見つけて直してある文書を受け取ったとき、私は細かい指摘をやめました。厳密に見れば言えることはある。でも、それより進めてほしい。書き手の中に姿が見えていることが、文書から読めたからです。  

    同じ人が相談と承認の両方をやるなら、どちらの場にいるのかを自分で切り替える。切り替えを忘れて相談の場で採点すると、書き手は次から相談に来なくなります。  

    レビューは、出来上がったものを検査する工程ではありません。完成した姿を、書き手と読み手の両方に見える形にする工程です。そう位置づけると、レビュアーの仕事は「間違いを見つけること」から「姿が見えるまで付き合うこと」に変わります。

    最後に

    要件が形になるかどうかは、完成した姿が書き手に見えているか、そしてそれが読む人にも見える文書になっているかで決まります。  

    レビューを受ける側なら、書く前に、出来上がった画面を頭の中で一度動かしてみるところから始められます。止まったところが、まだ決めていないところです。そこが残ったまま承認に出すのではなく、依頼文に【事前相談】と添えて持っていく。イメージしきれないなら、イメージしきれないと言って聞けばいい。それだけで、返ってくる指摘の中身が変わります。  

    レビューする側なら、指摘を書き始める前に、書き手に完成した姿が見えているかを一度確かめてください。見えていないなら、その会議は承認ではなく相談です。相談の場では点数をつけないと先に宣言し、指摘は「なぜ」まで添えて文書で残す。書き手の中に姿が見えていることが読めたら、細かい指摘は手放して進めてもらう。通すためのレビューを書く疲れは、そこで消えます。  

    別の記事で、憲章には「成功したらどんな世界か」を書く、と書きました。要件定義に書くのは、「完成したらどう動くか」です。世界が見え、動きが見えたとき、Webアプリケーションは組織で形になります。


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

    あなたへのおすすめ