設計書は全件をレビューする。指摘が集中する所に、未決の課題がある
一部だけを読むレビューでは、設計書のどこが弱いかは分かりません。全件を同じ観点で点検すると、指摘が特定の領域に集中します。そこに、まだ決まっていない課題があります。
この記事の要点
- 設計書の一部だけを読むレビューでは、設計書のどこが弱いかは分かりません。分かるのは、読んだ人が何を重視したかだけです。
- 全件を同じ観点で点検すると、指摘は特定の領域に集中します。集中している所に、まだ決まっていない課題があります。
- 数百件の指摘を、人がすべて読む必要はありません。人は指摘を原因ごとにまとめ、原因1つにつき、対応を1つ決めます。
設計書が60本あります。レビューの期限は来週です。レビューする人が期限までに読めるのは、10本です。どの10本を読みますか。
多くのプロジェクトでは、重要に見える設計書か、レビューする人が得意な領域の設計書を選びます。残りの50本は、誰も最後まで読まないまま次の工程に進みます。50本の中の誤りは、結合テストで見つかります。
生成AIを使うと、60本すべてを同じ観点で点検できます。効果は、誤りの見落としが減ることだけではありません。指摘が、どの領域のどの種類に集中しているかが分かります。一部だけを読むレビューでは、これは分かりません。
01一部だけ読んでも、設計書のどこが弱いかは分からない
9本だけ読む
読んだ 9本 見つけた誤り 1本 残った誤り 5本
60本すべてを、同じ観点で読む
読んだ 60本 見つけた誤り 6本 残った誤り 0本
朱の点線の枠が、読まれなかった誤りです。9本だけ読む方法では、誤りがどこに残っているかも分かりません。
一部だけ読むレビューには、誤りを見落とす以外の問題もあります。
レビューの指摘には、レビューする人の専門が表れます。会計に詳しい人は、勘定について指摘します。システム連携に詳しい人は、連携について指摘します。指摘の一覧に連携の指摘が多くても、設計書の連携が弱いとは限りません。連携に詳しい人が読んだだけかもしれません。
一部だけ読んだレビューの結果からは、「設計書のどこが弱いか」は言えません。言えるのは、「誰が、何を重視して読んだか」だけです。
02観点は、「はい・いいえ」で答えられる問いにする
全件を同じ基準で点検するには、点検する観点を先に決めます。観点の書き方で、結果の質が決まります。AIに「設計書をレビューして」と指示すると、AIは感想を返します。感想は、設計書の修正には使えません。
観点は、「はい・いいえ」で答えられる問いの形で書きます。
| 使えない観点 | 使える観点(問いの形) |
|---|---|
| 項目の定義が十分か | すべての項目に、桁数・必須かどうか・初期値が書かれているか |
| 例外処理が考慮されているか | 処理ごとに、エラーが起きたときの動作が1つ以上書かれているか |
| 前提が明確か | 「未定」「検討中」「別途」と書かれた箇所に、決める期日と決める人が書かれているか |
| 他の資料と整合しているか | 業務フローの手順のうち、この設計書に対応する記載が無いものはどれか |
観点の数は、8つ程度にします。観点を増やすと指摘が増え、人が読み切れなくなります。観点を1つ追加するときは、1つ減らします。
もう1つのルールは、AIに、指摘ごとに設計書の原文を引用させることです。たとえば「3章の項目一覧に、版の桁数が未定と書かれている」と書かせます。原文の引用が無い指摘は、人が確認できないので使いません。
03指摘が集中している所に、未決の課題がある
全件の点検が終わると、数百件の指摘の一覧ができます。一覧を上から読む前に、指摘の件数を、領域と種類ごとに数えます。
| 項目の定義の抜け | 前提の記載なし | 例外の記載なし | 他の資料との食い違い | |
|---|---|---|---|---|
| 販売 | 9 | 6 | 11 | 12 |
| 購買 | 8 | 5 | 24集中 | 6 |
| 生産 | 31集中 | 7 | 10 | 13 |
| 会計 | 7 | 22集中 | 6 | 5 |
指摘が均等に出ていれば、どのマスも近い件数になります。朱のマスは、ほかのマスより明らかに件数が多い所です。
指摘は均等には出ません。必ず、特定の領域の特定の種類に集中します。集中している所の設計書を読むと、多くの場合、同じ原因が見つかります。設計の前提が、まだ決まっていないことです。
項目の定義の抜け生産に集中
マスタや移行データの方針が、決まっていない桁数や採番のルールが決まらないので、書けない
例外の記載なし購買に集中
業務の例外が、洗い出されていない承認の例外を誰も数えていないので、書けない
前提の記載なし会計に集中
方式や基準が、決まっていない配賦の基準が決まらないまま、先に設計書を書いている
指摘が多い領域の担当者に「丁寧に書いてください」と依頼しても、指摘は減りません。設計書を書く前に決めるべきことが、決まっていないからです。
指摘が多いのは、設計書を書いた人の能力が低いからではありません。設計の前提が決まっていないからです。
このように読むと、設計書のレビューで、未決の課題を見つけられます。04指摘は、原因ごとにまとめて読む
全件を点検すると、指摘は数百件になります。人が1件ずつ読むと、一部だけ読むレビューより時間がかかります。数百件を、原因ごとにまとめて読みます。
- 同じ原因の指摘を、1つにまとめる図2の朱のマスの場合、数十件の指摘が1つのまとまりになります。
- まとまりごとに、代表の3件だけを読む3件の原文を読み、同じ原因かどうかを確認します。同じ原因なら、残りは読みません。
- まとまりごとに、対応を1つ決めるたとえば「部品表の版の管理方法を、いつ、誰が決めるか」を決めます。指摘を1件ずつ直すのではなく、原因を解決します。
- どのまとまりにも入らない指摘を、1件ずつ読むこれが、設計書そのものの誤りです。1件ずつ読む指摘は、全体の一部で済みます。
レビューの会議は、設計書を読み合わせる場から、原因ごとに対応を決める場に変わります。
05AIは指摘を出しすぎる。採用した割合で管理する
全件の点検を始めると、最初に、指摘が多すぎるという問題が起きます。AIは、観点に少しでも関係する箇所をすべて指摘します。指摘する必要のない箇所も含まれます。
対策をしないと、レビューする人は AI の指摘を信用しなくなり、読まなくなります。そこで、次の3つをプロジェクトの運用のルールにします。
- 指摘ごとに、採用するかしないかを記録する。採用しない場合は、理由を一言書きます。
- 採用しなかった指摘が多い観点を、書き直す。原因は、観点の問いがあいまいなことです。観点は増やさず、問いを具体的にします。
- 採用した指摘の割合を、点検のたびに確認する。割合が上がっていれば、観点が改善されています。下がった場合は、設計書の書き方が変わったか、観点が合わなくなっています。
「AIが見落とさないように」と観点を追加し続けると、指摘が増えます。採用する割合が下がり、やがて誰も指摘を読まなくなります。管理する数字は、指摘の件数ではありません。採用した指摘の割合です。
06設計書を直すたびに、全件を点検し直す
全件の点検は、1回では終わりません。設計書は修正され、版が上がります。設計書を修正すると、他の資料との食い違いが新しく発生します。
人のレビューでは、修正した設計書をもう一度最初から読むことは、ほとんどありません。AIは、版が上がるたびに全件を点検できます。前回の結果と比べると、「修正で増えた指摘」と「修正で消えた指摘」が分かります。
毎回の指摘の件数を記録すると、設計がどこまで確定したかを示す指標になります。
07明日は、「未定」の件数を全件で数える
- すべての設計書から、「未定」「検討中」「別途」「TBD」という語を検索し、件数を数える。AIが無くてもできる。
- 件数を領域ごとに集計する。設計書の本数で割り、1本あたりの件数にする。
- 件数が最も多い領域について、「未定」の箇所を10件読む。10件が共通して待っている決定を書き出す。
多くの場合、10件のうち半数以上が、同じ1つか2つの決定を待っています。その決定を先に行うと、設計書の「未定」がまとめて無くなります。
全件を数えると、多くの設計書に共通する原因が分かります。その原因を1つ解決すれば、設計書を1本ずつ直す必要はありません。
「未定」を数え終えたら、次に観点を8つに増やします。AIには、設計書の原文を引用して指摘を出させます。