Архитектурный дрифт лечится спекой: ИИ-агент соблюдает правила в 9 случаях из 10

Архитектурный дрифт означает, что проект с каждой правкой понемногу уползает от исходного замысла. ИИ-агент (программа на основе нейросети, которая сама выполняет задачу по шагам) делает это особенно легко. В результате у вас будет один документ-чертёж, который агент читает перед работой, и автоматическая проверка, которая не пропускает отступлений.

Пример автор берёт из ChatGPT. Человек дал нейросети настоящую фотографию Дуэйна Джонсона с просьбой «создай точную копию этой картинки, ничего не меняй». С каждой итерацией снимок менялся до неузнаваемости и превратился в мультяшное месиво, хотя просьба на каждом шаге оставалась той же.

С кодом происходит то же самое. Агенту сказали, какой шрифт использовать, и он держит одно семейство, но размеры на каждой странице свои, и сайт теряет общий стиль. Корень проблемы, по словам автора, в том, что «разъезжается» источник правды.

Термин не новый: пару architectural drift и architectural erosion ввели Перри и Вульф в 1992 году в статье Foundations for the Study of Software Architecture. О дрифте в эпоху ИИ писали и на Хабре в апреле 2026 года.

Что понадобится?

• ИИ-агент, которому вы поручаете правки в проекте.
• Одна папка docs в корне проекта для всей документации.
• Базовый файл с правилами для агента, у автора это AGENTS.md.
• Спек-тесты: автоматические проверки кода по документации.
• Время на наведение порядка. Сколько ушло у автора, он не сообщает.

Пошаговая инструкция: три правила против дрифта

1. Назначьте истиной документацию, а не код. Это принцип единого источника правды (single source of truth): правда лежит в одном месте. Спека (спецификация, текстовое описание того, как всё должно быть устроено) служит чертежом, а код становится деталью, и деталь сверяют с чертежом, а не с другой деталью.

2. Разложите документацию по полочкам. У автора в папке docs больше 7 тысяч документов с десятью уровнями вложенности, и в 90% папок не больше 7 файлов. Он держится правила «7 плюс-минус 2»: в каждой папке не больше 9 объектов.

3. Сведите каждую тему в один файл. Все правила типографики у автора лежат в typography.md, где описаны 22 роли текста. На весь сайт два семейства шрифтов, Charis для длинного чтения и Inter для остального, и только веса 400 и 700. В спеке прямо сказано: «состояний вне реестра не бывает: новая связка = новая строка по вердикту».

4. Обяжите агента читать спеку до работы. Правило записано в AGENTS.md: перед задачей агент читает документы, которые к ней относятся. По словам автора, после этого агент в 9 случаях из 10 не нарушает правила. Полный текст своего файла автор в пересказе не приводит, поэтому ниже моя примерная формулировка:

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

1. Поставьте автоматического сторожа на десятый случай. Спек-тест работает детерминированно, то есть каждый раз проверяет одинаково, без «может быть». Он читает таблицы typography.md, собирает разрешённые пары кеглей (размеров шрифта) и обходит весь фронтенд, видимую часть сайта. Лишняя пара валит сборку и показывает имя файла и строку.

2. Разбирайте каждый пропущенный сбой. Когда документ и код разошлись, срабатывают три линии: тестирование, затем self-heal (самовосстановление на рабочей версии сайта) и только потом человек. Задача человека, по словам автора, не поймать ошибку, а понять, почему она прошла, и закрыть эту дыру.

Показательная деталь: расхождение нашлось не в работе, а при написании статьи о борьбе с ним. Чёрный список ловил только известные ошибки, а белый ловит любые.

Что делать с этим прямо сейчас, по ролям

Автору Дзена. Заведите один файл со стилем канала: тон, длина абзацев, запретные слова, оформление обложек. Прикладывайте его к каждому промпту, а не правьте текст «на глаз» от версии к версии.

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

Предпринимателю. Принцип не привязан к конкретной нейросети. Из доступных в РФ аналогов подойдут YandexGPT и GigaChat: правила в файле работают с любой моделью, которая умеет читать приложенный документ.

Запомните урок с фотографией: просьба «ничего не меняй» не работает, работает только чертёж, с которым сверяют каждую версию.