Iterar progressivamente
Nesta página
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