Ideia principal

Uma especificação, um PRD, um protótipo são acusados de mentir assim que se descobre a distância entre o que anunciam e o que o produto faz. A acusação mira no objeto errado: esses documentos não erraram, eles deixaram de ocupar a função para a qual foram escritos.

Antes da entrada em produção, uma especificação serve ao diálogo. Ela dá ao Product Manager, aos desenvolvedores e às áreas de negócio algo a contestar: permite explorar uma hipótese, delimitar um escopo, fazer aparecer um desacordo antes que ele custe caro, decidir. O valor dela não está na exatidão, mas na capacidade de provocar objeções — um documento que ninguém discutiu fracassou, mesmo que descreva exatamente o que será entregue.

A entrada em produção retira essa função. Os acordos feitos durante o desenvolvimento, os casos limite descobertos, as decisões tomadas num merge request entraram no produto sem passar de novo pelo documento. O que ele dizia do comportamento não é mais uma proposta a discutir: é uma descrição concorrente da que o repositório carrega, e perdedora. O artefato não se torna falso, ele se torna regenerável — o que ele enuncia do comportamento se reconstrói a partir do código, e mantê-lo à mão é o mesmo que cuidar de uma duplicata que deriva.

A virada tem, portanto, uma data, e não é a data de redação. Um mesmo documento é legítimo antes da entrega, ilegítimo depois, sem que uma única frase dele tenha mudado.

Por que isso importa

Isso desfaz o falso dilema entre "precisamos de specs melhores" e "precisamos parar de escrevê-las". Os dois lados supõem que a especificação tem um status único; ela tem dois, e o erro comum é prolongar o primeiro depois do momento em que ele expira.

Isso também reorienta o esforço: em vez de reescrever um documento depois de cada entrega para que ele continue verdadeiro, você o escreve francamente para a conversa que ele deve abrir, e aceita que ele fique desatualizado assim que entrar em produção. O cuidado se desloca para a qualidade da discussão antes e para a capacidade de regeneração depois — duas coisas que, ao contrário da atualização manual, não se degradam com o tempo.

Nuances e limites

A virada só diz respeito à parte descritiva. Uma especificação quase sempre contém, misturadas nos mesmos parágrafos, a descrição de um comportamento e a razão que o fez ser escolhido — a segunda não se regenera a partir de nenhum repositório e precisa sobreviver ao documento.

Uma especificação pode, além disso, ser oponível: anexo de um contrato com cliente, peça de um processo regulatório, compromisso escrito de uma licitação. Ela mantém então uma autoridade jurídica que a entrada em produção não lhe retira, mesmo quando o produto se afasta dela — e é justamente a diferença que vira o assunto.

Por fim, "a entrada em produção" supõe uma fronteira nítida. Uma implantação progressiva atrás de um feature flag, uma entrega para alguns clientes piloto, um rollback espalham o momento da virada em vez de marcá-lo.

Questões em aberto

• O que, concretamente, marca essa mudança de status no próprio documento, para que um leitor que o reabra oito meses depois saiba qual dos dois regimes está consultando?
• Uma especificação escrita sabendo que ficará desatualizada na entrega se escreve de outro jeito — mais curta sobre o comportamento, mais longa sobre as alternativas descartadas?