Como eu uso IA para entregar código

Pare de tentar escrever prompts inteligentes. Comece a fazer engenharia de contexto.

A maioria das pessoas usa a IA da maneira errada. Elas pedem um recurso em uma única frase. A IA retorna um código que utiliza as bibliotecas erradas, quebra suas convenções de nomenclatura e reintroduz bugs antigos. Você passa a tarde inteira corrigindo a bagunça.

Uma IA sem contexto é um desenvolvedor júnior que nunca leu sua base de código. Ela esquece tudo o que aconteceu ontem. Você não entregaria a um novo contratado um ticket de uma linha e esperaria um código perfeito. Você daria a ele um documento de onboarding.

Eu uso um arquivo de memória do projeto no meu repositório. Este arquivo atua como um documento de onboarding que a IA lê todas as vezes. Ele contém regras específicas do projeto que um estranho não saberia:

• Não negociáveis: Como as URLs devem ser e como os slugs devem corresponder à produção. • Regras de lógica: Derivar valores de configurações em vez de usar valores fixos (hardcoded). • Casos de borda (edge cases): Configurações específicas de CDN ou caminhos de arquivos que evitam quebras silenciosas.

Cada erro que cometo se torna uma linha neste arquivo. Isso transforma o arquivo em um ativo cumulativo. A qualidade da saída da IA melhora com o tempo porque eu paro de me repetir.

Meu fluxo de trabalho segue estes passos:

  • Bootstrap do contexto: Peça à IA para rascunhar o arquivo de memória a partir do seu código e, em seguida, você o edita.
  • Reafirme a tarefa: Peça à IA para resumir o objetivo antes de escrever o código. Isso detecta erros precocemente.
  • Melhore o prompt: Pergunte à IA o que há de ambíguo em sua solicitação.

Use IA para estas tarefas:

  • Escrever boilerplate e scaffolding.
  • Refatorações que seguem padrões.
  • Explicar código desconhecido.
  • Varreduras mecânicas em um repositório.
  • Escrever testes e fixtures.

Evite usar IA para estas tarefas:

  • Tomar decisões de arquitetura inovadoras.
  • Tomar decisões de gosto ou de produto.
  • Qualquer coisa onde estar errado seja caro.
  • Design crítico de segurança.
  • A revisão final antes da entrega.

A disciplina é simples:

  • Delimite tarefas pequenas. Não diga "construa este recurso". Diga "realize esta alteração específica".
  • Forneça o contexto antecipadamente.
  • Verifique cada saída. Execute o build e leia o diff.
  • Revise como se fosse o PR de um desenvolvedor júnior. Nunca faça commit de código sem que um humano o leia.
  • Alimente as lições de volta no seu arquivo de contexto.

A vantagem não está no prompt. A vantagem está no contexto que você mantém.

Fonte: https://dev.to/faizahmedfarooqui/how-i-actually-use-ai-to-ship-code-context-engineering-over-clever-prompts-il8

Comunidade de aprendizado opcional: https://t.me/GyaanSetuAi