🔥 Иногда лучший способ улучшить собственный фреймворк — показать его другим аналитикам и получить в панамку.

В субботу проводил воркшоп в Техклубе аналитиков. Показывал ребятам свой подход к разработке продуктов с AI — Test-Driven Product Development (TDPD).

Изначально я собирал этот фреймворк исключительно под себя. Сначала формализуем потребность, потом сценарии и критерии приёмки, пишем тесты и только после этого отправляем агентов реализовывать продукт. Дальше проверки, исправления, повторная приёмка — всё как положено.

Работает неплохо. Но на воркшопе обнаружилась интересная проблема.

У меня за плечами много лет системного анализа и архитектуры, поэтому часть вещей я делаю практически автоматически. Например, думаю о границах системы, интеграционных контрактах, нефункциональных требованиях, архитектурных компромиссах.

И настолько привык это делать, что почти не отразил эти шаги в самом фреймворке.

Мне-то они вроде как не нужны. А вот человеку, который только начинает работать с агентной разработкой, очень даже.

Ребята довольно быстро подсветили эти пробелы, а заодно накидали вопросов про безопасность, архитектурные риски и качество кода. В общем, нормально так провели ревью 😁

В результате появилась TDPD v0.13, причём это уже не косметическое обновление.

⚙️ Specification Lock — явное согласование требований, архитектуры и рисков до начала реализации.

📐 Quality Attributes — измеримые нефункциональные требования вместо абстрактного «сделайте быстро и надёжно».

🏗 Architecture Review — архитектурные решения, альтернативы и компромиссы теперь фиксируются явно.

🔐 Security & Failure Review — отдельная проверка безопасности, отказоустойчивости и рисков.

🧪 Test Evidence — каждый прогон тестов сохраняет собственные результаты. Старый зелёный статус больше не считается доказательством для новой сборки.

И вот что мне особенно понравилось в этой истории.

Когда строишь инструмент для себя, очень легко забыть формализовать то, что сам умеешь делать автоматически.

А потом удивляться, почему другие люди получают не тот результат.

Поэтому огромное спасибо участникам Техклуба за вопросы и обратную связь. Именно такого взгляда со стороны мне и не хватало.

Фреймворк, кстати, открытый. Можно посмотреть изменения, попробовать у себя и, конечно, прийти с новыми замечаниями.

🔗 Release notes TDPD v0.13:
https://github.com/InnokentyB/tdpd-product-framework/blob/main/RELEASE_NOTES.md

А вы замечали за собой, что самые очевидные для вас рабочие практики почему-то оказываются совершенно неочевидными для остальных?