Продолжаю по чуть-чуть читать Джоэла. Вот он рассказывает в четырёх частях, почему пользовательские сценарии и спецификации на ПО нужно обязательно писать и поддерживать в актуальном состоянии:

https://www.joelonsoftware.com/2000/10/02/painless-functional-specifications-part-1-why-bother/

https://www.joelonsoftware.com/2000/10/03/painless-functional-specifications-part-2-whats-a-spec/

https://www.joelonsoftware.com/2000/10/04/painless-functional-specifications-part-3-but-how/

https://www.joelonsoftware.com/2000/10/15/painless-functional-specifications-part-4-tips/