BDD, ADR, PRD, WTF: фиксируем решения для людей и AI
BDD, ADR, PRD, WTF: Capturing Decisions for Humans and AI Alike — Michal Cichra, Safe Intelligence
Решения, требования и поведение продукта стоит записывать в документы, которые проверяются кодом, а не полагаться на промпты и память агента.
- Архитектурные правила в линтере — ADR фиксирует, зачем запрещён импорт между модулями, а import linter падает с подсказкой и ссылкой на документ. Агент сам открывает эту ссылку и исправляет код.
- Git hooks с теми же проверками, что в CI — линтеры, проверка дублирования, архитектурные проверки и линт документов запускаются и локально, и на CI, поэтому агент, пропустивший проверку, получает отказ при коммите.
- E2E-тесты без доступа к базе — сценарии Cucumber работают только через браузер: модулям запрещён импорт кода для работы с базой, а шаблоны не ходят в базу, что, по словам спикера, исключает N+1 запросы.
- Дизайн-система с автоматической проверкой — правило «одна основная кнопка на странице» и запрет inline-стилей проверяются кодом, а не на ревью, чтобы агенты не отходили от визуального языка.
Кому полезно: тем, кто ведёт большой продукт с агентами для кодинга и хочет, чтобы правила жили в линтерах и тестах, а не в промптах.
Статья по теме
На какие вопросы отвечает доклад
Как сохранить архитектурные решения, чтобы агент для кодинга находил их после compaction контекста?
Решения записываются в ADR с причиной правила и способом исправления, а PRD описывает цель фичи и пользовательский путь. Агент заново открывает эти документы в длинных сессиях, где бывает до пятидесяти compaction.
▶ 2:03ADR, архитектурные границы и требования к продуктуКак запретить модулю тестов ходить в базу данных и предотвратить N+1 запросы архитектурными правилами?
Импорты проверяются линтером: модули E2E-тестов не могут импортировать код, работающий с базой, а из шаблонов нельзя обращаться к БД. Так проблема предотвращается полностью, а не ищется после появления.
▶ 9:00Сквозные тесты с изолированной базой данных и итоговый синтезПочему поведенческие тесты на Cucumber проще ревьюить, чем обычные тесты, сгенерированные AI?
Сценарии Cucumber описывают поведение продукта на человеческом языке и выполняются как код. Их можно связать с PRD и критичными пользовательскими путями, и они закрывают разрыв, который оставляет Spec-Driven Development.
▶ 4:07Исполняемые спецификации BDD с CucumberКак заставить агента для кодинга выполнять линтинг и архитектурные проверки до пуша?
Git hooks запускают те же задачи, что и CI: линтинг, типы, дублирование кода, архитектура, линтинг документов. Агент, который пропустил проверку, получает отказ коммита со ссылкой на нужный документ и исправляет код.
▶ 6:00Дизайн-системы и автоматический контроль с помощью хуков GitКак поддерживать единый дизайн интерфейса, если UI генерирует AI-агент?
Дизайн-система описывает правила, например один primary button на странице, а компоненты показываются в превью, которые видит и агент. Правила проверяются автоматически, а не на ревью.
▶ 6:00Дизайн-системы и автоматический контроль с помощью хуков Git
Главы
Похожие доклады
Spec-driven-разработка для production-процессов
AI Engineer World's Fair 2026
Близко по содержанию
Важно ли качество кода? Всё зависит от этого
Близко по содержанию
Как покончить с ревью кода
AI Engineer World's Fair 2026
Близко по содержанию
Создавайте системы, а не код
AI Engineer World's Fair 2026
Близко по содержанию

