Uma Armadilha Comum: Especificar Soluções, Não Problemas

Um modo de falha vale a pena destacar sozinho, porque é muito fácil de cair nele. Quando você senta para escrever uma spec, a tentação é descrever a solução que você já imaginou — "uma barra lateral com abas", "um modal que aparece", "uma tabela do Postgres." Mas uma spec cheia de soluções trava silenciosamente decisões que você ainda não ganhou o direito de tomar.

Compare estas duas linhas:

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.

A primeira frase já escolheu uma barra lateral, seções recolhíveis e um layout — antes de qualquer um confirmar que essas são as escolhas certas. A segunda declara o trabalho a ser feito e deixa a IA (e você) livres para encontrar a coisa mais simples que o satisfaça, que pode ser apenas três botões de filtro. Descreva o resultado que você quer; deixe a implementação negociável pelo máximo de tempo possível. Soluções são baratas de mudar numa spec e caras de mudar em código.