Решил попробовать сегодня подключить https://openspec.dev/. Мысли потом отдельно напишу, пока надо поработать с ним

Но быстрые мысли:
1. Требования, написанные текстом намного понятнее, чем требования написанные в коде. И людям, и машине. В коде они точнее, но их нужно искать. В спецификации записаны в одном файле, виден весь набор
2. Как следствие, написать документацию по требованиям проще, чем разбираться агенту что там в коде. И даже больше того, в требованиях будут использоваться правильные слова и правильные выражения. Они же пойдут в документацию