Код работает. Но команда не понимает почему

PR принят. Тесты зелёные. Решение уже в проде.

Но через месяц появляется новое требование — и выясняется, что никто не хочет трогать этот код.

Не потому, что он плохо написан. Просто команда не может уверенно ответить:

— почему выбрали именно это решение; — какие предположения в него заложены; — где проходят его границы; — что сломается при изменении требований.

AI заметно ускорил путь от задачи до работающего кода. Но вместе с этим появился новый вид долга — долг понимания, или comprehension debt.

Это не совсем обычный технический долг.

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

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

Особенно опасна фраза: «Это AI предложил, мы проверили — работает». Проверка результата не равна пониманию решения.

Как тимлиду не допустить накопления такого долга?

На ревью обсуждать не только код, но и решение:

1. Почему выбран этот подход? 2. Какие альтернативы рассматривались? 3. На каких предположениях всё держится? 4. Где решение перестанет работать? 5. Сможет ли автор объяснить его без ссылки на чат с AI?

Не каждый PR должен превращаться в архитектурный трактат. Но чем выше цена ошибки, тем важнее зафиксировать ход мысли: в описании PR, ADR, комментарии к тесту или короткой схеме.

AI может генерировать код быстрее, чем команда успевает строить его ментальную модель. Поэтому новая задача тимлида — следить не только за скоростью разработки и качеством кода, но и за тем, остаётся ли понимание внутри команды.

Потому что код, который никто не понимает, — это уже не ускорение.

Это отложенный инцидент.