От документа к действию: создаём инженерный гайдлайн, который понимает AI-агент

Тезисы воркшопа

• Участники разберутся, почему AI-агенту недостаточно просто дать доступ к корпоративной документации и чем инженерный гайдлайн отличается от обычной инструкции.
• Каждая команда выберет конкретное инженерное правило или повторяющееся замечание из code review и сформулирует его так, чтобы оно было понятно и разработчику, и AI-агенту.
• Участники выполнят одну и ту же инженерную задачу дважды. Сначала без дополнительного контекста, затем с подключенным гайдлайном.
• Команды научатся описывать область применения правила, ограничения, причины выбора подхода, хорошие и плохие примеры, исключения и критерии проверки результата.
• Участники проведут перекрестное ревью гайдлайнов и проверят, можно ли однозначно понять и применить написанное правило.
• Готовые гайдлайны будут загружены в Developer Book и подключены к AI-инструментам через MCP.
• Команды сравнят результаты до и после подключения контекста и определят, какие части гайдлайна действительно повлияли на поведение AI.
• Участники познакомятся с системой оценки качества гайдлайнов и поймут, как находить неоднозначности, пропущенные ограничения и непроверяемые требования.
• По итогам воркшопа каждый участник получит готовый шаблон гайдлайна, методику его проверки и артефакт, который можно адаптировать для своей команды.
• Главный результат воркшопа состоит в том, что инженерное правило перестает быть пассивной документацией и становится рабочим контекстом для разработчика и AI-агента.