Guias

Trave o scope creep dos agentes de IA com requisitos congelados

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. É assim que travo o scope creep dos agentes de IA: cada requisito diz quem, o quê e como se veria, o meu sim congela a lista e todos os passos seguintes a leem.

David Marsa

David Marsa

Founder & CEO

Intermédio10 min de leituraPublicado em 19/11/2026

Última verificação: 19/11/2026

Ferramentas e modelos abordados:ConvOpsPlaywright MCP
O plano está congelado; o agente trabalha até à linha e não vai mais longe.
Parcialmente em inglês
Algumas partes desta página ainda não estão traduzidas para português, por isso são apresentadas em inglês.

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 dizerAqui quer dizer
Scope creep de clientes de agênciaUm cliente acrescenta trabalho a um contratoUm agente acrescenta trabalho que nenhum requisito pediu
Acumulação de permissões ou de ferramentasUm agente ganha acessos que não devia terUm agente constrói para lá do plano
Um pip freeze ou um code freezePacotes fixados, ou nenhum merge antes de uma versãoRequisitos fixados, antes de qualquer código
Um ficheiro de testes só de leitura ou um snapshot de contextoUm ficheiro que o agente não pode editar, ou o estado de uma sessão guardadoUma 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.

PassoO que se escreveQuemCondiciona
1. Escrever em grandeUma linha por necessidadeO agente redige, eu leioA divisão
2. DividirQuem, o quê, como se veriaO agente redige, eu leioO congelamento
3. Cortar as palavras de códigoLinhas simplesO agente redige, eu leioO congelamento
4. CongelarUm sim com dataEuTodos os passos seguintes
5. Fica de foraLinhas com um porquêO agente redige, eu aprovoOs extras
6. Concluído quandoUma caixa por linhaO agente redige, eu aprovoO fim
7. CitarPeças do design que citam linhasO agente, com verificaçãoA construção
8. PercursosTestes que citam linhasAgente de testesA aceitação
9. Percorrer o «Concluído quando»Caixas face ao que foi entregueO agente verifica, eu decidoO 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:

LinhaO quêComo se veria
R-4.1Uma estação perdida termina o trabalho de forma claraSe 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.2Uma estação reiniciada termina o trabalho de forma claraSe 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.3Nenhuma impressão em duplicadoUma estação que volta nunca imprime esse trabalho outra vez; o histórico do trabalho mostra uma tentativa
R-4.4Nova tentativa, só umaCom 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ê.

Um requisito grande demais para testar passa a quatro linhas, cada uma com quem, o quê e como se veria.

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.

Um requisito que não se consegue ver acontecer não se pode testar; tire as palavras de código e diga o que veria.

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.

O meu sim congela a lista; a lista do que fica de fora e as caixas «Concluído quando» estão ao lado dela desde o início.

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 foraPorquê
Estações alojadas pela FernhillUm plano posterior
Um marketplace de estaçõesUm plano posterior
Passar um trabalho para outra estação a meioR-4: um trabalho perdido termina
Mais do que uma nova tentativa por trabalho perdidoO R-4.4 limita-as a uma
Imprimir a partir de telemóveisUm 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 quandoDurante a construção
R-4.1: uma estação perdida termina o trabalho no prazo de 3 minutosVazia
R-4.4: com as novas tentativas ativadas, há exatamente mais uma tentativaVazia
R-2.2: a página do trabalho indica a estação onde foi impressoVazia

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 designCita
A parte que deteta uma estação perdidaR-4.1, R-4.2
A aplicação da estaçãoR-1.3, R-4.1
Histórico de trabalhosR-2.2, R-4.3
Retoma de trabalhosNada

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.

Uma linha congelada, citada pelo design, citada pelo teste, assinalada no fim; uma peça que não cita nada é cortada.

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.

Os dados existiam, mas o requisito nomeava a página, por isso o testador conseguiu fazê-lo falhar: é um requisito que um agente não consegue interpretar mal.

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.

LacunaLinhaTipo
A página do trabalho não mostra nenhuma etiqueta para o motivo «estação reiniciada»R-4.2Correção
Uma estação muda de nome a meio do trabalho: o histórico mantém o nome antigo?R-2.2Decisã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

  1. Escreva em grande na iniciativa

    Escreva um requisito por cada coisa de que uma pessoa precisa, cada um com o seu quem.

  2. 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.

  3. Corte as palavras de código

    Retire endpoints, tabelas e classes, para que quem não programa consiga ler cada linha.

  4. 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.

  5. 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.

  6. Escreva a lista «Concluído quando»

    Escreva uma caixa «Concluído quando» por requisito: o fim do plano.

  7. 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.

  8. Escreva um percurso de teste por requisito

    Escreva um percurso de teste por requisito testado ao vivo, que o cite palavra por palavra.

  9. 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.

Aprenda isto ao vivo

Build Your AI Agent Team

Próxima edição: terça, 26/01, 04:00 (ET)

Ver o workshop

Cursos que aprofundam o tema

Ver o catálogo