KISS

Расшифровывается как Keep It Simple, Stupid. Это настоящий инженерный принцип от конструктора ВМС из 1960-х, и "stupid" здесь адресовано решению, а не тебе.

Вот версия, которую мне хотелось бы услышать раньше: умное решение — это то, которое потом тебя кусает.

Ты что-то строишь, и перед тобой два пути. Один очевидный и немного скучный. Другой изящный, компактный, такой, от которого чувствуешь себя умным уже за то, что до него додумался. В моменте умный вариант ощущается лучше. Но именно его потом никто не сможет прочитать, включая человека, который его написал.

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

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

Представь, что пишешь человеку дорогу к своему дому.

• Умная версия: "Третий поворот налево после ориентира, который местные называют старой мельницей, но если вторник, дорога закрыта, тогда лучше через задний проезд."
• Простая версия: "Поверни налево у заправки. Мы в синем доме."

Обе сегодня доведут человека до места. Но только одна доведет незнакомца ночью, под дождем, когда ты не можешь ответить на звонок.

С AI это важно вдвойне, потому что AI с радостью выдаст тебе умную версию, если ты позволишь. Попросишь что-нибудь, и он бодро напишет плотный, "умный" кусок кода, который технически работает. Поэтому простоту нужно прямо просить:

1. Скажи это вслух в промпте. Добавь в запрос: "сделай просто и читаемо, без хитрых трюков". AI оптимизирует под то, что ты просишь. Проси скучное.
2. Прочитай перед тем, как принять. Если ты не можешь обычными словами объяснить, что делает код, проблема не в тебе. Это знак, что решение слишком хитрое. Попроси AI переделать проще.
3. Выбери версию, которую смог бы объяснить другу. Если пришлось бы сказать "честно, я не до конца понимаю, как тут эта часть работает", удали эту часть.

Правило простое: если оба решения работают, бери то, которое легче понять, а не то, которое короче или эффектнее.

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

Сомневаешься — делай очевидное.