はじめに
要件定義のドキュメントって、正直、書くのがしんどいですよね。
・時間がかかる
・誰がどこまで読むのか分からない
・書いたあとも修正が入る
それでも実務では、このドキュメントに何度も助けられる瞬間があります。
今回は自分が要件定義を書くときに意識しているスタンスについて書きます。
きれいに書こうとすると、だいたい失敗する
最初の頃は、
・漏れなく
・正確に
・きれいに
書こうとしていました。でもそうすると、
・手が止まる
・進まない
・結局、共有が遅れる
という状態になりがちでした。
要件定義は最初から完成させるものじゃない。
最近はそう割り切っています。
ドキュメントは「思考のログ」
今は要件定義のドキュメントを思考のログとして書いています。
・なぜそう考えたのか
・どこで迷ったのか
・何が未確定なのか
これを書いておくだけで、あとからのレビューや修正がかなり楽になります。
「決まっていないこと」を書いておく
意外と大事なのが、決まっていないことをちゃんと書くことです。
・保留中
・要確認
・仮置き
これが書いていないと、「決まっている前提」で話が進んでしまいます。
未確定を残すのは悪いことじゃなく、ズレを防ぐための保険だと思っています。
誰のために書いているか
要件定義のドキュメントは、顧客のためだけのものではありません。
・未来の自分
・後から入るメンバー
・レビューする人
こういう人たちが「状況を追えるかどうか」が大事です。
まとめ
要件定義のドキュメントは、完璧な説明書である必要はありません。
・どう考えたか
・何が決まっていないか
・どこを注意してほしいか
これが分かるだけで、ドキュメントは一気に使えるものになります。
要件定義は書いた瞬間よりもあとで読み返したときに価値が出る工程と考えるようになってから、ドキュメントを書くことへの抵抗感はかなり減りました。
次回は『要件定義とスケジュール感のすり合わせ』について書く予定です。