Почему API‑First уже недостаточно и что меняется, когда SDD строится на.md‑файлах и обязательном участии агентов?
В агентном SDD спецификация становится не пояснением к коду, а рабочим контекстом, из которого агент строит план, тесты и реализацию. Это ускоряет разработку — и одновременно увеличивает цену неоднозначности. Разбираем, как превратить.md из документации в управляемый контракт.
Мы привыкли объяснять неудачный результат агента «галлюцинациями модели». В агентном SDD причина часто прозаичнее: агент получил неполную, противоречивую или слишком свободную спецификацию — и последовательно реализовал одну из возможных трактовок. Чем лучше агент исполняет инструкции, тем быстрее такая ошибка распространяется по коду, тестам и документации.
API‑First решил только часть проблемы