Atualização editorial em : atribuições e orientações corrigidas com fontes; a data da publicação original foi preservada.
Registrar uma decisão do projeto só ajuda um assistente de programação se a informação chegar ao contexto certo e continuar válida. Um arquivo chamado MEMORIA.md, por si só, não demonstra que a ferramenta o carregou nem que aprendeu permanentemente com seu conteúdo. A versão anterior atribuía a criação desse arquivo e seus resultados ao autor sem confirmação.
Use um mecanismo documentado
No GitHub Copilot no GitHub, instruções gerais do repositório são definidas em .github/copilot-instructions.md. Também há instruções por caminho em .github/instructions/NAME.instructions.md; o suporte depende do recurso utilizado. Essa convenção é específica do produto, não um nome universal para toda ferramenta de IA. Documentação do GitHub sobre instruções de repositório.
A mesma documentação informa que o Copilot Chat inclui o arquivo nas referências da resposta quando usa instruções do repositório. Conferir essa referência ajuda a verificar o contexto fornecido; não prova que todas as regras foram obedecidas ou que o código está correto. GitHub: custom instructions in use.
Transforme uma lição em um contrato verificável
Em vez de acumular o histórico inteiro de conversas, a proposta é registrar decisões que ainda orientam o código. Cada regra deve indicar onde se aplica e como será conferida. Este exemplo é hipotético e precisa ser adaptado ao projeto:
Escopo: alteracoes no calculo de frete.
Contrato: nao modificar o valor de um pedido ja confirmado.
Referencia: localizar a regra vigente e os testes do dominio.
Validacao: executar os testes do calculo e do pedido confirmado.
Relato: informar comandos executados, resultados e o que nao foi testado.
Limite: nao registrar clientes, credenciais ou dados de pedidos reais.
A instrução não cria a regra de negócio. Antes de adotá-la, confirme se o comportamento pertence ao sistema. Substitua a referência genérica pelo caminho real da regra e dos testes. Uma preferência desatualizada pode orientar a alteração errada mesmo quando o assistente a segue perfeitamente.
- Selecione uma mudança pequena e defina o comportamento esperado e o que deve permanecer igual.
- Verifique o mecanismo de instruções da ferramenta e, quando disponível, a indicação de que o arquivo foi usado.
- Revise o diff: confirme escopo, regras preservadas e ausência de alterações incidentais.
- Execute as verificações pertinentes e guarde o resultado real, inclusive falhas e testes não executados.
- Atualize a instrução quando o contrato mudar. Um comentário antigo não deve prevalecer sobre a decisão vigente sem investigação.
Histórico, paralelismo e revisão
O histórico de versões registra as mudanças no código. Uma nota de decisão explica por que uma regra existe. Um changelog de produto comunica mudanças relevantes ao usuário. Não é necessário duplicar cada edição nos três lugares; escolha o registro conforme sua finalidade.
Não há uma conclusão universal neste artigo de que todo trabalho com agentes deve ser sequencial. A decisão proposta é observar se as tarefas disputam arquivos, dados ou ambientes mutáveis. Trabalho independente pode ser separado; alterações no mesmo estado exigem coordenação e verificação de integração.
Uma segunda revisão assistida pode levantar hipóteses de falha. O aceite deve depender de evidência adequada à alteração, não da concordância entre duas respostas de IA. No exemplo do frete, isso inclui verificar o pedido confirmado, não apenas receber uma avaliação textual favorável.
Limites
Não foi conduzido experimento de produtividade nem sessão de Copilot para este texto. As convenções do GitHub foram conferidas na documentação; o roteiro de frete é proposto e não foi executado. Instruções em contexto não são evidência de treinamento permanente do modelo. Este é um guia baseado em fontes, sem técnicas atribuídas à vivência pessoal de Anderson Damasio.