設計書は全件をレビューする。指摘が集中する所に、未決の課題がある

一部だけを読むレビューでは、設計書のどこが弱いかは分かりません。全件を同じ観点で点検すると、指摘が特定の領域に集中します。そこに、まだ決まっていない課題があります。

この記事の要点

  1. 設計書の一部だけを読むレビューでは、設計書のどこが弱いかは分かりません。分かるのは、読んだ人が何を重視したかだけです。
  2. 全件を同じ観点で点検すると、指摘は特定の領域に集中します。集中している所に、まだ決まっていない課題があります。
  3. 数百件の指摘を、人がすべて読む必要はありません。人は指摘を原因ごとにまとめ、原因1つにつき、対応を1つ決めます。

設計書が60本あります。レビューの期限は来週です。レビューする人が期限までに読めるのは、10本です。どの10本を読みますか。

多くのプロジェクトでは、重要に見える設計書か、レビューする人が得意な領域の設計書を選びます。残りの50本は、誰も最後まで読まないまま次の工程に進みます。50本の中の誤りは、結合テストで見つかります。

生成AIを使うと、60本すべてを同じ観点で点検できます。効果は、誤りの見落としが減ることだけではありません。指摘が、どの領域のどの種類に集中しているかが分かります。一部だけを読むレビューでは、これは分かりません。

01一部だけ読んでも、設計書のどこが弱いかは分からない

図 19本だけ読むと、誤りが5本残る。60本すべてを読むと、残らない(誤りのある設計書が6本ある例)

9本だけ読む

読んだ 9本 見つけた誤り 1本 残った誤り 5本

60本すべてを、同じ観点で読む

読んだ 60本 見つけた誤り 6本 残った誤り 0本

朱の点線の枠が、読まれなかった誤りです。9本だけ読む方法では、誤りがどこに残っているかも分かりません。

一部だけ読むレビューには、誤りを見落とす以外の問題もあります。

レビューの指摘には、レビューする人の専門が表れます。会計に詳しい人は、勘定について指摘します。システム連携に詳しい人は、連携について指摘します。指摘の一覧に連携の指摘が多くても、設計書の連携が弱いとは限りません。連携に詳しい人が読んだだけかもしれません。

一部だけ読んだレビューの結果からは、「設計書のどこが弱いか」は言えません。言えるのは、「誰が、何を重視して読んだか」だけです。

02観点は、「はい・いいえ」で答えられる問いにする

全件を同じ基準で点検するには、点検する観点を先に決めます。観点の書き方で、結果の質が決まります。AIに「設計書をレビューして」と指示すると、AIは感想を返します。感想は、設計書の修正には使えません。

観点は、「はい・いいえ」で答えられる問いの形で書きます。

使えない観点使える観点(問いの形)
項目の定義が十分かすべての項目に、桁数・必須かどうか・初期値が書かれているか
例外処理が考慮されているか処理ごとに、エラーが起きたときの動作が1つ以上書かれているか
前提が明確か「未定」「検討中」「別途」と書かれた箇所に、決める期日と決める人が書かれているか
他の資料と整合しているか業務フローの手順のうち、この設計書に対応する記載が無いものはどれか

観点の数は、8つ程度にします。観点を増やすと指摘が増え、人が読み切れなくなります。観点を1つ追加するときは、1つ減らします。

もう1つのルールは、AIに、指摘ごとに設計書の原文を引用させることです。たとえば「3章の項目一覧に、版の桁数が未定と書かれている」と書かせます。原文の引用が無い指摘は、人が確認できないので使いません。

03指摘が集中している所に、未決の課題がある

全件の点検が終わると、数百件の指摘の一覧ができます。一覧を上から読む前に、指摘の件数を、領域と種類ごとに数えます。

図 2指摘の件数を、領域と種類ごとに数えた表(説明のための例)
項目の定義の抜け前提の記載なし例外の記載なし他の資料との食い違い
販売 9 6 11 12
購買 8 5 24集中 6
生産 31集中 7 10 13
会計 7 22集中 6 5

指摘が均等に出ていれば、どのマスも近い件数になります。朱のマスは、ほかのマスより明らかに件数が多い所です。

指摘は均等には出ません。必ず、特定の領域の特定の種類に集中します。集中している所の設計書を読むと、多くの場合、同じ原因が見つかります。設計の前提が、まだ決まっていないことです。

図 3指摘の種類から、何が決まっていないかが分かる

項目の定義の抜け生産に集中

マスタや移行データの方針が、決まっていない桁数や採番のルールが決まらないので、書けない

例外の記載なし購買に集中

業務の例外が、洗い出されていない承認の例外を誰も数えていないので、書けない

前提の記載なし会計に集中

方式や基準が、決まっていない配賦の基準が決まらないまま、先に設計書を書いている

指摘が多い領域の担当者に「丁寧に書いてください」と依頼しても、指摘は減りません。設計書を書く前に決めるべきことが、決まっていないからです。

指摘が多いのは、設計書を書いた人の能力が低いからではありません。設計の前提が決まっていないからです。

このように読むと、設計書のレビューで、未決の課題を見つけられます。

04指摘は、原因ごとにまとめて読む

全件を点検すると、指摘は数百件になります。人が1件ずつ読むと、一部だけ読むレビューより時間がかかります。数百件を、原因ごとにまとめて読みます。

  1. 同じ原因の指摘を、1つにまとめる図2の朱のマスの場合、数十件の指摘が1つのまとまりになります。
  2. まとまりごとに、代表の3件だけを読む3件の原文を読み、同じ原因かどうかを確認します。同じ原因なら、残りは読みません。
  3. まとまりごとに、対応を1つ決めるたとえば「部品表の版の管理方法を、いつ、誰が決めるか」を決めます。指摘を1件ずつ直すのではなく、原因を解決します。
  4. どのまとまりにも入らない指摘を、1件ずつ読むこれが、設計書そのものの誤りです。1件ずつ読む指摘は、全体の一部で済みます。
図 4全件を点検すると、レビューの時間を「読む」から「決める」に使える
一部だけ読むレビュー
読む・探す決める
全件を点検したあと
読む決める

レビューの会議は、設計書を読み合わせる場から、原因ごとに対応を決める場に変わります。

05AIは指摘を出しすぎる。採用した割合で管理する

全件の点検を始めると、最初に、指摘が多すぎるという問題が起きます。AIは、観点に少しでも関係する箇所をすべて指摘します。指摘する必要のない箇所も含まれます。

対策をしないと、レビューする人は AI の指摘を信用しなくなり、読まなくなります。そこで、次の3つをプロジェクトの運用のルールにします。

落とし穴

「AIが見落とさないように」と観点を追加し続けると、指摘が増えます。採用する割合が下がり、やがて誰も指摘を読まなくなります。管理する数字は、指摘の件数ではありません。採用した指摘の割合です。

06設計書を直すたびに、全件を点検し直す

全件の点検は、1回では終わりません。設計書は修正され、版が上がります。設計書を修正すると、他の資料との食い違いが新しく発生します。

人のレビューでは、修正した設計書をもう一度最初から読むことは、ほとんどありません。AIは、版が上がるたびに全件を点検できます。前回の結果と比べると、「修正で増えた指摘」と「修正で消えた指摘」が分かります。

毎回の指摘の件数を記録すると、設計がどこまで確定したかを示す指標になります。

07明日は、「未定」の件数を全件で数える

半日でできる、3つの確認
  1. すべての設計書から、「未定」「検討中」「別途」「TBD」という語を検索し、件数を数える。AIが無くてもできる。
  2. 件数を領域ごとに集計する。設計書の本数で割り、1本あたりの件数にする。
  3. 件数が最も多い領域について、「未定」の箇所を10件読む。10件が共通して待っている決定を書き出す。

多くの場合、10件のうち半数以上が、同じ1つか2つの決定を待っています。その決定を先に行うと、設計書の「未定」がまとめて無くなります。

全件を数えると、多くの設計書に共通する原因が分かります。その原因を1つ解決すれば、設計書を1本ずつ直す必要はありません。

「未定」を数え終えたら、次に観点を8つに増やします。AIには、設計書の原文を引用して指摘を出させます。