Главная / Блог / Код AI-сборки расползается от правки к правке

Код AI-сборки расползается от правки к правке: почему корректные задачи складываются в неуправляемую систему

Агент закрывает каждую задачу по ее локальным критериям: промокод применился, доставка посчиталась, страница прошла проверку. Система при этом теряет управляемость, потому что условия, которые обязаны сохраняться между задачами, никто не проверяет. Инвариант нарушен, задача закрыта, следующая задача опирается уже на нарушенное состояние.

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

Дрейф и технический долг - разные характеристики, а не противоположности

Технический долг отвечает на вопрос, сколько будут стоить будущие изменения. Дрейф отвечает на вопрос, почему фактическое устройство кода перестало соответствовать решениям, которые должны сохраняться. Это разные оси состояния кодовой базы, а не два вида одного явления.

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

СвязьКак выглядит
Дрейф создает долглокальные правки расходятся, будущие изменения дорожают
Долг ускоряет дрейфв запутанном месте следующему агенту проще добавить исключение, чем восстановить границу
Долг без дрейфаизвестный компромисс, последствия которого учитываются при планировании изменений
Дрейф без нового долгаграницы уже поплыли, цена еще не проявилась

Практический вывод из таблицы один: искать нужно не долг или дрейф, а конкретный нарушенный инвариант и его цену.

Почему локальная корректность не сохраняет архитектуру

Современный агент умеет искать использования, читать соседние модули и находить соглашения в репозитории. Объем контекста здесь не главная причина. Главная причина - в критериях задачи нет обязательной проверки условий, которые обязаны сохраняться после изменения. Агент может иметь доступ ко всему коду и все равно нарушить инвариант, если постановка его не требует.

Отсюда два механизма деградации.

Первый - приемка по результату задачи, а не по сохранению условий. Проверка подтверждает, что новый сценарий работает, но не подтверждает, что старые границы уцелели. Нарушение проходит, потому что его никто не искал.

Второй работает в два последовательных шага. Сначала агент восстанавливает намерение по коду: в репозитории записано, что сделано, но не записано, почему сделано именно так, поэтому ближайшее похожее место считывается как образец, а временный прием выглядит как принятое правило. Затем следующая задача закрепляет этот прецедент как паттерн: однократное исключение копируется уже как норма, после двух повторений в коде два равноправных способа решать одну задачу, и третий агент вынужден поддерживать оба.

Дубли, условия поверх условий и мертвый код - следствия этих механизмов, а не их причины.

Три задачи, после которых сумма считается в двух местах

Инвариант для примера строгий: итоговая сумма рассчитывается только модулем pricing на основе корзины, промокода и условий доставки. Компоненты только вызывают расчет и не содержат собственной арифметики скидок и доставки. Условие обязано оставаться истинным при любых изменениях корзины.

Исходное состояние ему соответствует. Модуль сразу принимает все входы итога, поэтому расширять правила нужно внутри него, а не в компонентах:

// pricing.js - единственная точка расчета
export function calcTotal(cart, promo, delivery) {
  const subtotal = cart.items.reduce(
    (sum, item) => sum + item.price * item.qty,
    0
  );

  const discounted = promo
    ? subtotal * 0.9
    : subtotal;

  const shipping = discounted >= 5000 ? 0 : delivery.cost;

  return discounted + shipping;
}

// Checkout.jsx - только вызывает
const total = calcTotal(cart, promo, delivery);

Задача 1: изменить размер скидки с 10% на 15%. Правильное место - множитель 0.9 внутри pricing. Агент неверно интерпретировал возвращаемое значение функции: решил по имени вызова, что calcTotal возвращает сумму до скидки, и добавил свою скидку поверх готового итога. Это не изменение правила, а дополнительная скидка поверх существующей:

// Checkout.jsx после задачи 1 - обход модуля
const base = calcTotal(cart, promo, delivery);
const total = promo ? base * 0.85 : base;

Локальная проверка прошла: сумма со скидкой стала меньше. Проверка не подтвердила соответствие бизнес-правилу, она зафиксировала только изменение суммы. Инвариант уже нарушен: скидка применена повторно к результату, который уже содержит старую скидку, скидка легла и на стоимость доставки, изменение правила в pricing не выполнено.

Задача 2: изменить порог бесплатной доставки с 5000 до 7000. Правильное место - условие в ветке shipping внутри pricing. Агент оставляет pricing без изменений и добавляет параллельную проверку в компонент уже с новым значением:

// Checkout.jsx после задачи 2 - второй обход
const base = calcTotal(cart, promo, delivery);
const withPromo = promo ? base * 0.85 : base;
const total = withPromo >= 7000 ? withPromo : withPromo + 500;

Здесь два дефекта сразу. Во-первых, правило продублировано: pricing по-прежнему считает бесплатную доставку от 5000, компонент - от 7000, в коде два действующих порога. Во-вторых, нарушен порядок применения бизнес-правил: компонент сначала повторно применяет скидку к результату calcTotal, который уже содержит скидку 10% и стоимость доставки, а затем проверяет полученную сумму на соответствие порогу 7000. Поэтому право на бесплатную доставку определяется по промежуточному итогу с повторной скидкой. Например, при исходной стоимости корзины 8500 старая скидка 10% дает 7650. calcTotal считает доставку бесплатной по старому порогу 5000. Компонент повторно применяет скидку 15% и получает 6502,50. Эта сумма меньше 7000, поэтому компонент добавляет 500 за доставку. При правильном применении новой скидки 15% сумма составила бы 7225, и доставка осталась бы бесплатной. В результате компонент начисляет доставку вопреки бизнес-правилу, одновременно занижая общую сумму из-за повторного применения скидки.

Задача 3: показать ту же сумму в мини-корзине в шапке. Это не отдельная независимая ошибка, а прямое следствие нарушения из задач 1-2. Агент использует существующий calcTotal, который формально остался в pricing, но больше не соответствует заявленной ответственности модуля: вызов возвращает сумму со старой скидкой 10% и доставкой по старому порогу 5000, а оформление добавляет поверх вторую проверку с новым порогом 7000 и дополнительную скидку 15% поверх итога. Поэтому шапка встает перед уже раздвоенным расчетом, а не перед чистой задачей чтения. Быстрое исправление - записать локальный итог оформления в общее хранилище при его изменении и подписать шапку на это состояние:

// Checkout.jsx - запись при изменении локального итога, не во время рендера
useEffect(() => {
  store.setTotal(total);
}, [total]);

// HeaderCart.jsx - подписка на общее состояние
const headerTotal = useSyncExternalStore(store.subscribe, store.getTotal);

Хранилище обновляется из эффекта оформления, который зависит от локального total. Если исходные данные меняются в другом месте, а локальный итог оформления не пересчитывается, хранилище сохраняет прежнее значение. Подписка в шапке сообщает об изменениях хранилища, но не отслеживает исходные данные корзины. Поэтому она гарантирует получение обновлений хранилища, а не актуальность самой суммы. При прямой загрузке страницы без оформления или при восстановлении состояния хранилище также может содержать значение, рассчитанное по другой логике. Так нарушение инварианта расчета порождает вторую проблему - рассинхронизацию производного состояния.

Локальная проверка каждой задачи прошла. Вместе задачи дали split ответственности: часть логики в pricing, часть в Checkout, синхронизация через хранилище по подписке. Следующая правка правил вынуждена менять оба места и учитывать задержку синхронизации.

Такие инварианты встречаются и в других доменах: состояние хранится в одном слое, компонент не определяет права доступа самостоятельно, все запросы к ресурсу идут через общий слой. Форма одна: условие, которое обязано оставаться истинным, и единственное место, которое за него отвечает.

Про карту сайта и фиксацию таких условий - отдельная статья: AI-агенты пишут код быстро.

Как из механики следуют условия приемки

Если инвариант не назван в задаче, проверять его нечего. Поэтому в постановке фиксируют не править только здесь, а само условие и его владельца. Пример для корзины: после изменения calcTotal остается единственной точкой расчета, Checkout передает туда cart, promo и delivery и не считает сам. Приемка - поиском: вхождений * 0.85 и расчета доставки вне pricing нет, оба экрана показывают результат одного вызова.

Оценка зависимости строится так же от последствий, а не от факта согласия. В задаче фиксируют, зачем зависимость нужна, есть ли решение без нее, сколько стоит ее обновление и как ее удалят при ненадобности. Согласие без этих ответов архитектурного качества не дает.

Проверка идет от контракта к симптому. Сначала типы и тесты расчетного слоя, затем поиск соседних использований, затем визуальная проверка. Браузер подтверждает симптом, устройство подтверждают типы, поиск дублей и повторный прогон правил. Маленький шаг снижает риск одной правки, но системные последствия проверяет только эта цепочка.

Ревизия: инструмент дает кандидатов, решение принимает человек

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

Поэтому вывод агента читают как список кандидатов с адресами, а не как карту проблем:

ВопросЧто дает инструментЧто решает человек
Дубли расчетапохожие формулы с файлами и строкамикакие реализации объединить, удалить или сохранить с разными контрактами
Состояниеместа записи флага или суммыкакие данные являются источником истины, а какие - производными
Границыграф импортов спорного модулякакие зависимости допустимы, какие лишние
Мертвый коднеиспользуемые экспорты по статикечто реально не вызывается с учетом динамики и логов

Проверка кандидата устроена одинаково: открыть оба места, назвать каноническое, показать поиском все вызовы второго, удалить второе из кода без комментирования, прогнать типы и тесты обоих экранов. Ревизия закрыта, когда для каждого кандидата принято решение: объединить, удалить или сохранить с объяснением различий. Решение подтверждено проверкой использований и тестами.

Частые вопросы

Чтобы не пропустить новые материалы

Короткий дайджест вечером в понедельник. Без спама.

Выберите, что получать

Обсудим ваш проект

Расскажите о вашем бизнесе, покажите текущий сайт или просто опишите задачу в свободной форме. Я изучу вводные, предложу решение и сориентирую по срокам и смете.

Отвечаю в течение нескольких часов в рабочее время.

Защита от спама – Yandex SmartCaptcha

Если вам удобнее обсудить всё текстом без заполнения форм – напишите напрямую: в Telegram или на sergei@kruglov.net

Удобнее голосом? Напишите пару слов о задаче - договоримся об удобном времени созвона на 15-20 минут, и я пришлю свой номер телефона.