Частая ловушка: спецификация решений, а не проблем

Один режим провала стоит назвать отдельно, потому что в него так легко свалиться. Когда вы садитесь писать спецификацию, возникает соблазн описать решение, которое вы уже представили: «боковая панель с вкладками», «всплывающее модальное окно», «таблица Postgres». Но спецификация, полная решений, тихо фиксирует решения, которые вы ещё не заслужили.

Сравните эти две строки:

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

Первое предложение уже выбрало боковую панель, сворачиваемые секции и компоновку — прежде чем кто-либо подтвердил, что это верные решения. Второе формулирует работу, которую нужно сделать, и оставляет AI (и вам) свободу найти самое простое, что её удовлетворяет, — а это могут оказаться всего лишь три кнопки фильтра. Описывайте желаемый результат; пусть реализация остаётся обсуждаемой как можно дольше. Решения дёшево менять в спецификации и дорого — в коде.