仕様ではなく意図を共有する

ドキュメントに書かれた仕様をただ実装するだけでなく、

ここは変更が起きやすいだろうな、ここはこうした方が良いな、

のような判断を実装者にも委ねられる

変更する時に役立つ

設計書や仕様書などを書く際に、その仕様の背景も一緒に記述する

淡々と仕様の項目を一覧するより、読み手のイメージできる幅が広がる

その仕様が存在する意図を明確に伝える

添えると良さそうなもの

どういう課題があったか

ユーザーから◯◯という要望があった

想定する利用シーンの詳細

効能

開発者に詳細を想像させることができる

開発者に能動性を与えられる

開発者が自分で考えて細部を作り込むことができる

将来の変更度合いなどもイメージできる

仕様に書いていない部分を想像できる

仕様に書いていても、不要かもという判断ができる

仕様を超えた仕様を想像できる

参考