上流工程とAI駆動開発 1208上流工程とAI駆動開発

指摘の4要素

一覧に戻る

1件の指摘は場所、事実、根拠、影響の4つで書くと、読んだ人が設計書のどこをなぜ直すのかを聞き返さずに判断できる。96秒の動画で、効果音と画面の字幕だけで進みます。

字幕の全文

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