Когнитивный долг

Когнитивный долг — это расхождение между кодом и твоим мнением о нём.

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

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

Суть — граница ответственности говорит о замысле больше, чем список функций:

• за что код отвечает;
• чего он сознательно не делает.

Границы — где код заканчивается и начинается остальная система:

• с чем код взаимодействует снаружи;
• что прячет внутри;
• как предполагается его расширять.

Контракты — что код обещает тому, кто к нему обращается:

• что код принимает на входе;
• что отдаёт на выходе.

Понять все три помогает короткая петля обратной связи с агентом:

1. сначала агент описывает суть, границы и контракты — это его интерпретация кода;
2. затем вы в свободной форме, вслух, своими словами проговариваете всё, что поняли;
3. агент отвечает снова: соглашается, поправляет, достраивает то, что вы упустили.

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

P.S. Это упражнение удобно завернуть в отдельный скилл прямо в проекте и запускать время от времени — особенно после крупных порций сгенерированного кода.