アジャイル開発とドキュメント

アジャイルソフトウェア開発宣言には「包括的なドキュメントよりも動くソフトウェア」という言葉があります。これは、『包括的なドキュメント』に価値があることを認めつつも、『動くソフトウェア』により高い価値を置くという意味で、包括的なドキュメントの存在価値を否定するものでなないと解釈します。

必要なドキュメント・不要なドキュメント

ソフトウェアのライフサイクルで品質や生産性の向上につながるドキュメント

ドキュメント名	内容
開発構想書	- 開発するソフトウェアがどのような現状の問題を解決するか - その解決方法の概略 - 開発するソフトウェアの存在理由 - プロジェクトで開発する機能の存在理由
プロジェクト憲章	- プロジェクトの存在意義 - プロジェクトの終わりまで変わらない基本的な事項 - 何かに迷ったときに立ち返るために必要な情報
アーキテクチャー設計書	- 開発するソフトウェアの設計や拡張の指針となる原則が分かるドキュメント - 開発するソフトウェアの全体の設計思想 - 使用するアーキテクチャパターン - 機能を追加するときの方針
CRUD	ソフトウェア全体が共有するリソースをどの部分が、作成(Create)、参照(Read)、更新(Update)、削除(Delete)するのかを表形式にまとめたドキュメント
ハイレベルユースケース	ユーザの業務の課題と、それがソフトウェアによってどのように解決されるのかを示すユースケース