ドキュメントとして何を書くか？

僕の考えは、以下のような感じ。 (1) ドキュメント（設計書だろうが仕様書だろうが）は、「誰に何をどう伝えるべきか」を考えれば、何を揃えればいいかは自然と決まってくる。そして、誰が読んでも意味がないと判断されるドキュメントは意味がないので書かない。 (2) 「基本設計書」や「詳細設計書」や「外部設計書」や「内部設計書」という言葉があるが、肝心なのは「誰に何を伝えるか」であり、伝えたいことや認識あわせの単位でドキュメントが作られればそれでいい。それらをまとめて「○○設計書」とするかどうかは、顧客がそうしたければ好きにすれば良い（そこまでやる義務は開発側にはないと思う）。 (3) アーキテクトの仕事は、各作業者が何をしたらいいか迷うことなく作業ができるように「決めごとをしていくこと」。その決めごとは、すべてドキュメント化されるべきであり、そのためには「誰に何をどう伝えるべきか」を考えていけば、

[lizy]

こういう場面こそトヨタ式？の出番かなぁ。前工程からの押し出し（基本設計書、詳細設計書…）ではなく、後工程からの引き取り（ある機能を作るのに必要なものだけ作る）というイメージ

[kjkw]

ドキュメントの対象読者と書いた目的は堅くない文書には良く書くな/『アーキテクトの仕事は（略）「決めごとをしていくこと」』

[katzchang]

「誰が」が必ず入る点にはかなり同意。一般的に(3)はマネジメントの領域だろうけど、設計論と開発プロセスは切り離せない派なのかな。