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

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

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

Bad:  Add a left sidebar with collapsible sections for each book status.
Good: Let me see my books grouped by status without losing the full list.

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