← Каталог

· AI Engineer Europe 2026

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

Главы

Похожие доклады