AI-агенты копят когнитивный долг: почему каждый второй коммит - тушение пожара

Ты отдаёшь задачу AI-агенту, он выдаёт готовый код, ты его вмерживаешь и идёшь дальше. Красота. А через три месяца открываешь историю коммитов и понимаешь, что почти половина из них - это фиксы твоих же фич. Код пишется в разы быстрее, чем ты успеваешь его понять, и вот этот разрыв как раз и копится в тёмном углу. Называется когнитивный долг, и платить по нему всё равно придётся.

Триггером для меня стал разбор Валеры Ковальского (@neuraldeep): человек прогнал свой рабочий репозиторий за 90 дней и показал цифры, от которых чуть кофе на клавиатуру не выронил. Я полез в свой пайплайн агентов - и нашёл ровно те же грабли. Давай по порядку.

Что такое когнитивный долг простыми словами

Когнитивный долг - это накопленный разрыв между скоростью, с которой код появляется, и скоростью, с которой человек успевает построить у себя в голове его модель. AI-агент генерирует условные 140-200 строк в минуту, а разработчик осмысляет 20-40. Получается разрыв в 5-7 раз: код растёт куда быстрее, чем понимание того, как он вообще работает.

Технический долг живёт в коде - это костыли, дубли, захардкоженные значения. Когнитивный долг живёт в людях: команда отгружает то, что уже не помещается никому в голову. В марте 2026 Маргарет-Энн Стори (ACM Queue) формализовала это в "тройной долг": технический - в коде, когнитивный - в людях, и долг намерения - когда нигде не записано, ПОЧЕМУ код такой. Агент отлично закрывает первый вид долга скоростью и так же отлично раздувает два остальных.

Почему код от AI-агента обрастает техдолгом быстрее

Причина не в том, что агент тупой. Причина в том, что агент - это усилитель. Он множит и продуктивность, и бардак с одинаковым коэффициентом, а тормозит этот процесс обычно человек, который что-то держит в голове и говорит "стоп, так не делаем". Убираешь человека из центра решений - тормоза больше нет.

Вот что нашёл Валера в своём репо за 90 дней (данные @neuraldeep, июль 2026):

• 1069 коммитов, из них 416 - багфиксы. Это 39%, каждый второй-третий коммит уходит на тушение пожара.
• 44 коммита за один день. Ни один живой человек столько не отревьюит вдумчиво, значит, никто и не ревьюил.
• номер модели захардкожен в 4 разных местах с 4 разными значениями (10, 13, 14, 30). Классика: агент дописал ещё одну константу вместо того, чтобы найти существующую.

Ключевой вывод автора я бы вытатуировал: долг копится строго там, где ты убрал себя из центра. Не там, где агент "ошибся", а там, где ты перестал смотреть.

Куда прячется причина 500-х: проглоченные исключения и god-файлы

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

Съеденное исключение - это когда в коде стоит except Exception без повторного проброса ошибки. Падение происходит, но наружу не выходит: пользователь ловит 500, а в логах пусто, потому что агент "обработал" ошибку тем, что её проглотил. В том же репо Валеры нашлось 1436 таких голых except Exception, и только около 10% из них корректно пробрасывали ошибку дальше. Остальные - тихие могилы для багов.

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

Что показывают исследования про AI-агентов и качество кода

Отдельные ощущения - это одно, но тут уже набралась статистика, и она невесёлая. Скорость есть, а вот с качеством и даже с реальной продуктивностью всё неоднозначно.

METR в июле 2025 провёл рандомизированный эксперимент: опытные open-source разработчики с доступом к AI выполняли реальные задачи на 19% МЕДЛЕННЕЕ, чем без него. Самое смешное - сами они были уверены, что AI ускорил их процентов на 20. Разрыв между ощущением скорости и фактом - это ровно то место, где долг набегает незаметно.

GitClear в отчёте за 2025 год прошёлся по 211 миллионам изменённых строк. Доля скопипащенного кода выросла с 8,3% в 2021-м до 12,3% в 2024-м, а доля рефакторинга (когда код не плодят, а причёсывают) просела с 25% до менее чем 10%. Code churn - строки, которые переписывают в первые пару недель после добавления - вырос примерно с 3,3% до пандемии AI до 7,1% в 2025-м. По сути удвоился. Агенты охотнее вставляют новый блок, чем ищут, что можно переиспользовать - контекста не хватает.

Складываем: медленнее по факту, больше копипасты, меньше рефакторинга, вдвое больше переписанного. Это не приговор инструменту, это счёт, который приходит, если пустить его без присмотра.

Как остаться владельцем архитектуры, когда код пишет нейросеть

Ответ грубый, но рабочий: не убирай себя из центра. Агент пишет руками, но решения об архитектуре, границах модулей и о том, что считать "готово", остаются на тебе. Как только ты отдаёшь эти решения тоже - долг начинает капать.

Что реально помогает на практике:

• Кросс-ревью другой моделью. Прогони код, который написал один агент, через второго на другой модели с промптом "найди проглоченные исключения, дубли констант, разросшиеся файлы". Разные модели слепнут в разных местах, и один ловит то, что второй прошляпил.
• Регулярный греп по маркерам долга. except Exception без re-raise, одинаковые магические числа в разных файлах, файлы длиннее N строк. Это ищется автоматом и вешается в CI, чтобы не копилось молча.
• Держать потолок на скорость слияния. Если за день в мейн улетело 44 коммита - это не суперпродуктивность, это отсутствие ревью. Лучше меньше, но с человеком в контуре.
• Заставлять агента объяснять ПОЧЕМУ, а не только ЧТО. Тот самый долг намерения. Одна строчка "зачем так" в PR экономит потом полдня археологии.

Что я поменял у себя

Честно - я запустил тот же греп по своему парку агентов и приготовился увидеть красивое. Увидел знакомое: голые except, пара захардкоженных лимитов в трёх местах, один файлик, который явно пора пилить. Точные цифры пока собираю, но паттерн ровно тот же, что у Валеры, хотя код я вроде как контролирую.

Вывод, который забираю себе: AI-агент не создаёт долг из воздуха, он просто с бешеной скоростью проявляет твою же расхлябанность. Где ты был владельцем архитектуры - там всё чисто. Где ты сказал "да норм, вмержу" не глядя - там и растёт god-файл с проглоченными пятисотками. Так что дело не в том, чтобы писать код руками. Дело в том, чтобы руками держать решения.

А я пойду допиливать свой линтер на маркеры долга. Следите за новостями.