05 · Passagem de bastão48 / 62

Spec

O documento que descreve o trabalho inteiro: o que está sendo construído, não como cada etapa faz a parte dela.

Onde você esbarra nisso

Quando o resultado está tecnicamente certo e não é o que você queria. Ninguém escreveu o que você queria.

Conecta com

O que é

Um documento de passagem que cobre um trabalho de várias sessões. Ele diz o que vai ser construído e por quê. Não diz como cada sessão executa a parte dela, porque isso é assunto de Ticket.

A separação é a mesma de qualquer projeto: o escopo é um documento, as tarefas são outros.

O que muda pro teu negócio

A especificação é o que impede o agente de decidir sozinho o que você queria.

Sem ela, cada sessão parte do que estiver no contexto naquele momento, e o resultado deriva. Você descobre na terceira etapa que a primeira resolveu um problema parecido, mas não o teu.

E tem um ganho que não é óbvio: escrever a especificação te obriga a decidir antes. Boa parte do tempo perdido com inteligência artificial é tempo decidindo no meio da execução, o que é o pior momento possível pra decidir.

Fontes

AI Coding Dictionary, verbete "Spec", Matt Pocock. A separação entre especificação e ticket, o que é construído contra como cada sessão faz sua parte, é dele. É a distinção que organiza trabalho longo.