仕様書ではないですが、ある案件でざっくり3週間程度で見積もったら毎日進捗を管理することにしたから細かく予定を埋めろと言われた。 どうやらコスト管理に目覚めたらしい。 仕方がないので依存や影響範囲などまで細かく数日で調査して完璧()なスケジュール出したら遅いと言われた。理不尽だった。

結局のところ設計書の類、 ・誰（どんなロールの人）が ・何をどれくらいの粒度で知りたくて 読むのか？となるので、"知りたい粒度がコードと同等ならコード読めば良いじゃん"となってしまうんですよね。

このドキュメントの工数を最小化して手に入る「爆速開発」を行うには経営陣による「リスクの許容」が必要だが。 多くの業務系システムの開発現場では開発速度とドキュメントの網羅性を維持することのメリデメを判断できる人が経営陣におらずシステムの特性を無視してドキュメントの量を追い続けた。

日本語でSQLをわかりやすく書く能力を磨く仕事をした事があります。ここはSQLを直接書きたいという要望は却下されました。あまりにも不毛なお仕事でした。以来、コードが詳細仕様書と言う主張を続けています。

完成度の高いプロトタイプ作ってツールで出力