O que vai conseguir fazer
- Escrever um requisito que um agente de programação com IA não consegue interpretar mal, em três partes e sem palavras de código.
- Congelar uma lista de requisitos com uma linha de aprovação, e alterá-la apenas por nova aprovação.
- Escrever uma lista do que fica de fora e uma lista «Concluído quando» que dão um fim ao plano.
- Ligar cada peça do design e cada percurso de teste a um requisito, e cortar o que não se liga a nenhum.
- Fazer uma verificação de fim de plano que separa as lacunas a corrigir das decisões que lhe cabem a si.
Pontos-chave
- Escreva primeiro cada requisito em grande na iniciativa, um por cada coisa de que uma pessoa precisa, antes de pedir a um agente que construa o que quer que seja.
- Divida-o em linhas verificáveis: quem o faz, o que consegue fazer e como veria isso acontecer do lado de fora.
- Congele a lista com o seu sim explícito, para que ninguém além de si a possa alterar e todos os agentes construam com base nas mesmas linhas.
- Diga o que o plano não fará e quando está concluído: uma lista do que fica de fora e uma caixa «Concluído quando» por requisito.
- Faça todos os passos lerem a mesma lista: cada peça do design cita um requisito, cada percurso de teste cita um requisito palavra por palavra e a última verificação percorre o «Concluído quando» face ao que foi entregue.
Os requisitos congelados são uma lista de requisitos verificáveis, aprovada por uma pessoa e fechada antes de qualquer código, que impede um agente de programação com IA de construir para lá do plano. O scope creep de um agente de IA é o agente construir ou alterar coisas que nenhum requisito pediu, e começa quando os requisitos nunca foram verificáveis. Não deixo um agente de IA decidir onde acaba um plano. Congelo a lista, e todos os passos depois do meu sim leem-na.
No fim, terá uma lista de requisitos congelados para uma funcionalidade, uma lista do que fica de fora, uma lista «Concluído quando» e um plano de testes que cita cada linha. Cerca de 10 minutos de leitura, uma tarde para a sua primeira lista. É assim que mantemos os agentes de programação com IA dentro do âmbito na Neomanex.
Todos os exemplos usam a Fernhill Print, uma rede fictícia de gráficas cujas lojas instalam as suas próprias estações de impressão.
| Isto não é | Isso quer dizer | Aqui quer dizer |
|---|---|---|
| Scope creep de clientes de agência | Um cliente acrescenta trabalho a um contrato | Um agente acrescenta trabalho que nenhum requisito pediu |
| Acumulação de permissões ou de ferramentas | Um agente ganha acessos que não devia ter | Um agente constrói para lá do plano |
| Um pip freeze ou um code freeze | Pacotes fixados, ou nenhum merge antes de uma versão | Requisitos fixados, antes de qualquer código |
| Um ficheiro de testes só de leitura ou um snapshot de contexto | Um ficheiro que o agente não pode editar, ou o estado de uma sessão guardado | Uma lista que só uma pessoa altera |
O que são requisitos congelados, e os nove passos
A maioria das respostas diz «fixe os requisitos e o que fica de fora logo à partida». Concordo, mas fica-se por aí cedo demais: nunca diz quem os fixa, como os passos seguintes os leem nem quando o plano termina. Nove passos respondem às três perguntas.
| Passo | O que se escreve | Quem | Condiciona |
|---|---|---|---|
| 1. Escrever em grande | Uma linha por necessidade | O agente redige, eu leio | A divisão |
| 2. Dividir | Quem, o quê, como se veria | O agente redige, eu leio | O congelamento |
| 3. Cortar as palavras de código | Linhas simples | O agente redige, eu leio | O congelamento |
| 4. Congelar | Um sim com data | Eu | Todos os passos seguintes |
| 5. Fica de fora | Linhas com um porquê | O agente redige, eu aprovo | Os extras |
| 6. Concluído quando | Uma caixa por linha | O agente redige, eu aprovo | O fim |
| 7. Citar | Peças do design que citam linhas | O agente, com verificação | A construção |
| 8. Percursos | Testes que citam linhas | Agente de testes | A aceitação |
| 9. Percorrer o «Concluído quando» | Caixas face ao que foi entregue | O agente verifica, eu decido | O merge |
Ferramentas orientadas por especificações, como o GitHub Spec Kit e o Kiro, põem uma especificação antes do código. Este método acrescenta quem a congela, o que cada passo cita e como o plano termina. O fluxo de trabalho corre no ConvOps(abre num novo separador), como uma das formas como gerimos a nossa empresa com agentes de IA.
Porque é que os agentes de IA saem do âmbito
O scope creep é um problema de escrita antes de ser um problema de agentes. O trabalho voltava feito e não era o que eu queria. O agente não desobedeceu a nada: a frase que leu permitia as duas versões.
Listas de caminhos permitidos, limites de diff e hooks apanham o sintoma depois de o código existir. Nunca dizem o que construir. «Claude Code scope creep» é o mesmo problema, com qualquer agente de programação.
A verdadeira lacuna é o «feito». O «feito» de um agente é uma afirmação que ninguém consegue verificar, porque nada do que está escrito diz como é estar feito.
Fazemos todas as funcionalidades assim e mostramos todas as semanas as listas de requisitos, o congelamento e as verificações. Veja como o fazemos, por dentro, em neomanex.com/join.
Passo 1: Escreva em grande na iniciativa
Começo em grande de propósito. A iniciativa é a funcionalidade inteira, com um requisito por cada coisa de que uma pessoa precisa, e cada um diz para quem é. A Fernhill tem oito. O R-4 é para o gerente da loja:
R-4. Um fim claro quando uma estação de impressão cai a meio de um trabalho, e nunca uma impressão em duplicado. Se a estação ficar offline ou reiniciar para uma atualização, o trabalho termina no prazo de três minutos com um motivo; uma estação que volta nunca imprime esse trabalho outra vez; com as novas tentativas ativadas, o trabalho começa mais uma vez.
Essa linha contém quatro promessas: é grande demais para construir de uma vez e grande demais para testar como uma só.
Passo 2: Divida cada um em quem, o quê e como se veria
A terceira parte, como se veria, é a única que um testador consegue fazer falhar, por isso é aí que gasto o meu tempo. Nomeia um ecrã, uma mensagem ou um estado que se pode consultar. Um plano refina os requisitos que lhe pertencem e nunca acrescenta, retira nem reinterpreta a linha grande. O R-4 passa a quatro linhas, todas para o gerente da loja:
| Linha | O quê | Como se veria |
|---|---|---|
| R-4.1 | Uma estação perdida termina o trabalho de forma clara | Se a estação ficar offline a meio do trabalho, o trabalho termina no prazo de 3 minutos com o motivo «estação perdida» |
| R-4.2 | Uma estação reiniciada termina o trabalho de forma clara | Se a estação reiniciar para uma atualização a meio do trabalho, o trabalho termina no prazo de 3 minutos com o motivo «estação reiniciada» |
| R-4.3 | Nenhuma impressão em duplicado | Uma estação que volta nunca imprime esse trabalho outra vez; o histórico do trabalho mostra uma tentativa |
| R-4.4 | Nova tentativa, só uma | Com as novas tentativas ativadas, um trabalho perdido inicia exatamente mais uma tentativa; uma segunda perda termina-o de vez |
«Mais uma vez» passou a «exatamente mais uma tentativa». O passo 7 mostra porquê.

Errado e certo
«O serviço de exportação está implementado» não pode falhar: ninguém consegue ver isso acontecer. «Um gerente de loja consegue transferir os trabalhos de impressão do mês num ficheiro, com uma linha por trabalho» pode: abra o ficheiro e conte as linhas. Isso é um requisito que um agente não consegue interpretar mal. Quem não programa consegue lê-lo, e um testador consegue fazê-lo falhar.

Passo 3: Corte as palavras de código
Uma palavra de código num requisito é uma decisão de design metida às escondidas antes de alguém a ter aceitado. Nada de endpoints, nada de tabelas, nada de classes. Se alguém que não programa não consegue ler a linha, ela não está pronta.
Um primeiro rascunho do R-4.1 dizia «O endpoint de heartbeat marca a linha do trabalho como falhada.» Escolhe um mecanismo e não diz nada que um gerente de loja veria. Reescrito, é o R-4.1 acima.
Passo 4: Congele-a com um sim explícito
O congelamento é uma frase minha, e conta mais do que qualquer barreira de proteção. Um agente redige; eu leio cada linha e tomo as decisões, e cada uma fica registada numa linha:
- Um trabalho enviado para uma estação nomeada que está offline é recusado, sem alternativa (R-3).
- As estações partilhadas são só de leitura para todos menos para o seu dono (R-5).
- Uma estação nova fica online em 60 segundos; um trabalho perdido termina no prazo de 3 minutos (R-1.3, R-4.1, R-4.2).
Depois, o meu sim escreve uma linha no topo: «Congelado, aprovado a 12 de março de 2025.» A lista refinada do plano é congelada da mesma forma antes de começar qualquer design. A partir daí, só eu a altero, por nova aprovação, e a alteração fica escrita na própria lista. Congelado não quer dizer que nunca muda. Quer dizer que nenhum agente a muda.

Passo 5: Escreva o que fica de fora
A lista do que fica de fora é onde respondo às melhores ideias do agente antes de ele as ter. Cada linha diz porquê.
| Fica de fora | Porquê |
|---|---|
| Estações alojadas pela Fernhill | Um plano posterior |
| Um marketplace de estações | Um plano posterior |
| Passar um trabalho para outra estação a meio | R-4: um trabalho perdido termina |
| Mais do que uma nova tentativa por trabalho perdido | O R-4.4 limita-as a uma |
| Imprimir a partir de telemóveis | Um plano posterior |
Se um agente quiser construir uma destas coisas, a resposta já está escrita.
Passo 6: Escreva a lista «Concluído quando», o fim do plano
Concluído não é uma sensação nem uma mensagem de um agente. A minha definição de concluído para um agente de programação com IA é uma caixa curta por requisito, escrita antes da construção.
| Concluído quando | Durante a construção |
|---|---|
| R-4.1: uma estação perdida termina o trabalho no prazo de 3 minutos | Vazia |
| R-4.4: com as novas tentativas ativadas, há exatamente mais uma tentativa | Vazia |
| R-2.2: a página do trabalho indica a estação onde foi impresso | Vazia |
As caixas ficam vazias durante a construção, e o plano nunca termina só porque um agente o diz.
Passo 7: Faça cada peça do design citar um requisito
Uma peça do design que não serve nenhum requisito é scope creep com diagrama. Todos os passos depois do congelamento leem a mesma lista, e cada peça aponta para a linha que serve.
| Peça do design | Cita |
|---|---|
| A parte que deteta uma estação perdida | R-4.1, R-4.2 |
| A aplicação da estação | R-1.3, R-4.1 |
| Histórico de trabalhos | R-2.2, R-4.3 |
| Retoma de trabalhos | Nada |
Uma peça que não cita nada, como a retoma de trabalhos, é cortada, ou pedem-me um requisito novo. Antes do código, listam-se também as regras escritas que se aplicam, e uma que falte é decidida por mim e escrita primeiro.
A verificação que apanhou uma palavra
Antes do código, uma passagem lê os requisitos e o design lado a lado. O R-4 dizia «mais uma vez», e o design da funcionalidade nunca dizia quantas vezes, por isso uma estação que estivesse sempre a cair voltaria a tentar para sempre. A verificação enviou isso para o plano: quando o plano dividiu o R-4, a sua linha passou a dizer «exatamente mais uma tentativa», e o meu sim congelou-a. O próprio R-4 continua a dizer «mais uma vez»: está congelado, e o plano refina-o. Todas as quantidades vagas recebem um número antes do código, e as mudanças de redação são minhas.

Passo 8: Escreva um percurso de teste por requisito, citado palavra por palavra
As falhas são a parte boa: uma frase concreta o suficiente para falhar é uma frase que um agente não consegue interpretar mal. Cada requisito testado ao vivo recebe um percurso que o cita palavra por palavra; os testes automáticos cobrem o resto.
O percurso J-4.1 cita o R-4.1: iniciar um trabalho na estação «Back Office 1», desligá-la a meio do trabalho e voltar a ligá-la. Passa se o trabalho tiver terminado no prazo de 3 minutos como «estação perdida» e o histórico mostrar uma tentativa, o que prova também o R-4.3.
A reviravolta: a frase dizia a página
O R-2.2 diz «A página do trabalho indica a estação onde foi impresso.» Na primeira ronda de aceitação, o J-2.2 abriu o trabalho «Spring flyers» e falhou. A página não mostrava nenhuma estação, mas a resposta do sistema tinha-a: Front Counter 2. A frase dizia a página do trabalho, por isso o testador conseguiu fazê-la falhar. «Mostrar a informação da estação» teria passado.
A linha ficou. A página foi corrigida e testada outra vez até o J-2.2 passar. A lição: diga o que veria, na superfície onde o veria. Uma ronda só passa quando todos os percursos passam, e nenhuma correção se certifica a si própria. Como correm os agentes de testes: testes de aceitação com o Playwright MCP.

Passo 9: Percorra a lista «Concluído quando» face ao que foi entregue
A última verificação encontra lacunas, e as que importam voltam para mim, porque o âmbito é decisão minha. Um agente percorre cada caixa face à funcionalidade entregue, e cada lacuna é de um de dois tipos.
| Lacuna | Linha | Tipo |
|---|---|---|
| A página do trabalho não mostra nenhuma etiqueta para o motivo «estação reiniciada» | R-4.2 | Correção |
| Uma estação muda de nome a meio do trabalho: o histórico mantém o nome antigo? | R-2.2 | Decisão minha |
A verificação relata e devolve; nunca decide o âmbito. O plano está concluído quando cada lacuna tem resposta: uma é uma correção, a outra é uma decisão minha, mesmo quando a decisão é deixá-la para um plano posterior. O merge espera pelo meu sim. A mesma lista, do meu sim à última verificação.
Quer o fluxo de trabalho que corre estes nove passos, pronto a importar? Tenha acesso a este fluxo de trabalho, e a todos os outros com que trabalhamos, em neomanex.com/join.
Passos
Escreva em grande na iniciativa
Escreva um requisito por cada coisa de que uma pessoa precisa, cada um com o seu quem.
Divida cada um em quem, o quê e como se veria
Divida cada requisito em linhas de quem, o quê e como se veria do lado de fora.
Corte as palavras de código
Retire endpoints, tabelas e classes, para que quem não programa consiga ler cada linha.
Congele a lista com um sim explícito
Congele a lista com o seu sim explícito; a partir daí só pode ser alterada por si, por nova aprovação.
Escreva a lista do que fica de fora
Liste o que o plano não fará, com cada linha ligada ao requisito ou ao plano posterior que a explica.
Escreva a lista «Concluído quando»
Escreva uma caixa «Concluído quando» por requisito: o fim do plano.
Faça cada peça do design citar um requisito
Aponte cada peça do design para o requisito que serve, e corte qualquer peça que não cite nenhum.
Escreva um percurso de teste por requisito
Escreva um percurso de teste por requisito testado ao vivo, que o cite palavra por palavra.
Percorra a lista «Concluído quando» face ao que foi entregue
Percorra cada caixa «Concluído quando» face ao que foi entregue, e decida cada lacuna que lhe for devolvida.
Perguntas frequentes
O que são requisitos congelados para agentes de programação com IA?
Os requisitos congelados são uma lista de requisitos verificáveis, aprovada por uma pessoa e fechada antes de qualquer código, que impede um agente de programação com IA de construir para lá do plano. Cada linha diz para quem é, o que essa pessoa consegue fazer e como isso se veria do lado de fora. Um sim explícito de uma pessoa congela a lista, e só uma nova aprovação a altera. Não é um pip freeze nem um ficheiro de testes só de leitura.
Que exemplos há de scope creep em agentes de IA?
O scope creep de um agente de IA é, por exemplo, um agente acrescentar um modo de novas tentativas que ninguém pediu, construir uma página de definições que ninguém pediu ou mudar o nome a código que funciona durante a correção de um erro. Todos os casos têm a mesma causa: nenhum requisito verificável descrevia o trabalho, e nenhuma linha da lista do que fica de fora excluía o extra. O agente preencheu a lacuna com o seu próprio critério.
Para quem são os requisitos congelados?
Os requisitos congelados são para programadores e fundadores técnicos que constroem com agentes de programação com IA, seja o Claude Code ou outro, e recebem constantemente trabalho que está feito mas não é o que queriam. A lista dá ao agente linhas que ele não consegue esticar. Dá à pessoa um plano com fim: uma caixa «Concluído quando» por requisito, percorrida face ao que foi entregue.
Como mantenho um agente de programação com IA dentro do âmbito?
Escreva um requisito por cada coisa de que uma pessoa precisa, a dizer para quem é. Divida cada um em quem, o quê e como se veria, sem palavras de código. Congele a lista com o seu sim explícito. Acrescente uma lista do que fica de fora e uma caixa «Concluído quando» por requisito. Faça cada peça do design citar uma linha e cada teste citar uma. As barreiras de proteção sobre o diff complementam isto depois de o código existir.
Como é que os requisitos congelados evitam o scope creep em projetos de programação com IA?
Os requisitos congelados evitam o scope creep porque dão a todos os passos seguintes uma única lista fixa para ler. Cada peça do design tem de citar um requisito, e uma peça que não cita nenhum é cortada ou devolvida à pessoa como pedido de uma linha nova. A lista do que fica de fora responde aos extras antes de serem construídos. A lista «Concluído quando» termina o plano. Um agente não consegue alargar uma lista que só uma pessoa altera.
O que deve incluir uma lista «Concluído quando» para um agente de programação com IA?
Uma lista «Concluído quando» tem uma caixa por requisito, cada uma com uma única linha que nomeia um estado observável, como uma estação perdida terminar o trabalho no prazo de 3 minutos. As caixas ficam vazias durante a construção. No fim, um agente percorre cada caixa face ao que foi entregue. Cada lacuna volta como uma correção ou como uma decisão para a pessoa responsável pelo âmbito.
Posso alterar um requisito depois de congelado?
Sim, um requisito congelado só muda por nova aprovação. A pessoa que congelou a lista aprova a alteração, e a alteração fica escrita na própria lista. Um agente de programação com IA nunca edita sozinho um requisito congelado, nem quando essa edição faria passar uma verificação.
Em que diferem os requisitos congelados dos critérios de aceitação e do desenvolvimento orientado por especificações?
Os requisitos congelados contêm critérios de aceitação: a parte de cada linha que diz como se veria é o critério. No desenvolvimento orientado por especificações, a especificação é o documento inteiro a partir do qual um agente constrói. Os requisitos congelados acrescentam-lhe quatro coisas: um congelamento explícito por uma pessoa, uma lista do que fica de fora, uma lista «Concluído quando» que termina o plano e uma cadeia de citações em que cada peça do design e cada teste apontam para uma linha.
