文書情報 更新履歴 2010.01.10 -- 新規作成 2011.04.29 -- 最終更新 本稿の目的 システム開発において詳細設計書というドキュメントが要求されることがある。多くの場合、労力の無駄になり、保守時にも酷い足枷になる代物であるが、この業界では未だに健在である。 本稿ではそのような詳細設計書をアンチパターンと定義し、その背景と問題を追い、解決策について議論する。 「詳細設計書」とは何か 実装についてステップ単位で記述された重厚長大な技術文書 本稿で扱う「詳細設計書」とは、まるでソースコードを日本語に訳したかのようなソースコードの一行と一対一で対応したプログラムの設計書を指す。またの名を「プログラム設計書」とも言う。 どのようなプロジェクトで作られるのか 大手SI企業が関わるプロジェクトで多く見られる現象である。 詳細設計書を記述する動機 設計情報の属人化防止 詳細設計書を記