上流工程とAI駆動開発 1208上流工程とAI駆動開発
指摘の4要素
1件の指摘は場所、事実、根拠、影響の4つで書くと、読んだ人が設計書のどこをなぜ直すのかを聞き返さずに判断できる。96秒の動画で、効果音と画面の字幕だけで進みます。
字幕の全文
- 設計者が「人数の上限を見直してください。」という指摘を受け取ったとします
- この1文だけで、設計者はどの行をどう直すかを決められるでしょうか
- どのシートのどの行か、何と食い違うのかが、この文には書いてありません
- そのため設計者は、指摘した人に聞き返すことになります
- そこで1件の指摘を、4つの要素に分けて書きましょう
- 1つ目は場所で、シート名と行を「項目定義No.8」のように書きます
- 2つ目は事実で、そこに書いてあることを書きます
- この例の事実は、「予約人数の上限は50人」です
- 3つ目は根拠で、食い違う相手を書きます
- ここでは「要件一覧REQ-012は100人」が、食い違う相手です
- 根拠には、別のシートの行や、ヒアリングメモの行も使えます
- 4つ目は影響で、直さないと作る人や使う人に何が起きるかを書きます
- この例の影響は、「大会議室の予約が画面で止まる」です
- 4つをつなぐと、どこをなぜ直すのかが、1件の指摘で伝わります
- 設計者は聞き返さずに、項目定義のNo.8と要件一覧を開いて確かめられます
- ただし、場所をExcelの行番号で書くと、Markdown版では同じ行を探せません
- 場所は、項目IDやNoのように、表の中に書いてある番号で指しましょう
- そうすれば、Excel版とMarkdown版のどちらでも同じ行を開けます
- 指摘を書いたら、場所、事実、根拠、影響の4つがそろったかを確かめましょう