Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Iterar progressivamente

Aula 7 de 14 Atualizada a 29 de julho de 2026 Programador
Nesta página
  1. Desenvolvimento iterativo com IA
  2. Por que iterar?
  3. Estratégia de iteração
  4. Referenciar falhas anteriores
  5. Ajustar o contexto ao longo do caminho
  6. Quando pedir tudo de uma vez
  7. Pontos-chave

Desenvolvimento iterativo com IA

É tentador pedir tudo num único prompt. No entanto, com o grok-build-0.1, tal como com qualquer modelo de código, uma abordagem iterativa produz melhores resultados. Constrói-se progressivamente, validando cada passo antes de avançar para o seguinte.

Por que iterar?

Os limites de um único prompt

Um prompt que solicite a criação de um sistema de autenticação completo com JWT, tokens de atualização, middleware, rotas, testes e documentação gerará um volume de saída difícil de verificar e provavelmente incompleto em algumas áreas.

A vantagem da iteração

Dividir o mesmo pedido em etapas altera três fatores que se reforçam mutuamente. Valida-se cada passo antes de continuar: um erro nas fundações — uma escolha inadequada de estrutura de dados, uma assinatura de função instável — é corrigido quando custa apenas cinco minutos, em vez de se propagar por todo o código gerado subsequentemente. Ajusta-se o rumo no caminho: se a primeira iteração revelar um problema de arquitetura, resolve-se antes de avançar, exatamente como numa revisão de design. E mantém-se o modelo focado: um prompt curto e direcionado produz sistematicamente respostas melhores do que uma especificação dispersa onde o modelo tem de arbitrar entre dez requisitos por si só; cada turno coloca apenas uma questão, e o modelo responde-lhe bem.

Estratégia de iteração

Passo 1: A fundação

Comece pela estrutura básica, sem detalhes:

“Crie o esquema da tabela de utilizadores com Drizzle ORM: id, email, passwordHash, createdAt. Adicione os tipos TypeScript correspondentes.”

Valide, teste e avance.

Passo 2: Lógica de negócio

Adicione a lógica sobre a fundação validada:

“Agora, crie o serviço de registo em @src/services/auth.ts. Deve fazer hash da palavra-passe com bcrypt, verificar se o email já não existe e inserir o utilizador. Utilize o esquema @src/db/schema.ts que acabámos de criar.”

Passo 3: Refinamento

Com a lógica implementada, refine:

“Adicione validação de entrada com Zod ao serviço de registo. O email deve ser válido e a palavra-passe deve ter pelo menos 8 caracteres, incluindo uma letra maiúscula e um dígito.”

Passo 4: Casos limite

Por fim, trate os casos limite:

“O que acontece se a ligação à base de dados falhar durante o registo? Adicione tratamento de erros adequado com mensagens claras para o utilizador.”

Referenciar falhas anteriores

A iteração inclui também aprender com os erros. Se uma sugestão do modelo não funcionar, indique-o explicitamente:

“A solução anterior não funciona porque o TypeORM não suporta esta sintaxe na versão 0.3. O erro é: [colar erro]. Proponha uma alternativa compatível.”

O modelo utiliza esta informação para evitar reproduzir o mesmo erro e para compreender melhor o seu ambiente.

Ajustar o contexto ao longo do caminho

A iteração tem um benefício menos visível, mas igualmente valioso: o contexto refina-se ao longo dos turnos. Descobre durante o desenvolvimento que um ficheiro de configuração controla o comportamento que está a modificar — adicione-o no próximo turno. Surge uma restrição que não tinha identificado — o middleware deve também gerir chaves de API, não apenas JWTs — especifique-a quando se tornar relevante. Uma hipótese inicial revela-se falsa — corrija-a explicitamente em vez de deixar o modelo continuar a construir sobre ela. Num único prompt monolítico, todas estas descobertas chegariam tarde demais.

“Na verdade, o middleware de autenticação deve também gerir chaves de API além dos JWTs. Eis o formato atual da chave em @src/config/api-keys.ts.”

Quando pedir tudo de uma vez

A iteração nem sempre é necessária. Para tarefas simples e bem definidas, um único prompt é suficiente:

  • Renomear uma variável em todo um ficheiro
  • Converter um callback para async/await
  • Adicionar tipos TypeScript a uma função JavaScript existente
  • Gerar um teste unitário para uma função pura

Pontos-chave

  • Divida pedidos complexos em etapas validadas progressivamente
  • Cada iteração constrói sobre a anterior após verificação
  • Referencie erros anteriores para evitar repetições
  • Ajuste o contexto à medida que faz descobertas
  • Tarefas simples não requerem iteração