Checklist de fluxo com IA para desenvolvedores

Um fluxo confiável com IA não é um único prompt. É um ciclo repetível: definir a tarefa, fornecer contexto seguro, pedir saída verificável, validar o resultado e registrar a evidência.

1. Defina a tarefa

Escreva a tarefa em uma frase antes de abrir a ferramenta de IA.

Bons formatos de tarefa:

• Explique este erro e liste causas prováveis.
• Rascunhe testes para este comportamento.
• Compare duas opções de implementação.
• Refatore esta função sem mudar o contrato público.
• Resuma estas notas em requisitos.

Evite prompts amplos como Build the whole feature, a menos que um agente tenha arquivos, restrições e verificações bem definidos.

2. Prepare contexto seguro

Inclua apenas o contexto necessário:

• Código, logs, docs ou requisitos relevantes.
• Comportamento esperado e comportamento atual.
• Restrições que não devem mudar.
• Comandos, testes ou exemplos existentes.

Remova segredos, dados privados de clientes, estratégia interna e código que não deve sair do seu ambiente.

3. Peça saída verificável

Facilite a revisão:

Return:
1. Short diagnosis.
2. Recommended change.
3. Risks and assumptions.
4. Verification steps.

Para trabalho estruturado, peça JSON, tabelas Markdown, SQL, casos de teste ou uma explicação em tamanho de patch. Quanto mais concreto o formato, mais fácil inspecionar.

4. Verifique antes de confiar

Use a evidência certa:

• Código: rode testes, type checks, lint e revisão manual.
• Detalhes de API ou biblioteca: confira documentação oficial.
• Trabalho sensível a segurança: use fontes confiáveis e política da equipe.
• Conteúdo: confira fonte, tom, afirmações e permissões.
• Transformações de dados: compare entrada e saída de exemplo.

Se a resposta não puder ser verificada, trate-a como ideia, não como resultado.

5. Registre o que aconteceu

Em trabalho importante, deixe uma nota curta:

AI assisted with: [task]
Verified by: [docs, tests, command, review]
Remaining risk: [known limitation]

Isso ajuda revisores futuros a entender onde houve julgamento humano.

Padrões comuns de falha

• O prompt esconde a restrição mais importante.
• O assistente muda comportamento enquanto diz que apenas refatorou.
• A resposta cita fatos precisos sem fontes.
• A tarefa inclui dados sensíveis que deveriam ter sido redigidos.
• O passo de verificação é vago, ausente ou impossível de executar.

Conclusão final

Use IA como colaboradora rápida dentro de um fluxo de engenharia. A responsabilidade por contexto, privacidade, revisão e evidência continua com você.