5 passos que dei para começar a usar IA em um projeto Delphi legado

Projeto Delphi legado tem um problema em comum: quase nada está escrito. O conhecimento mora na cabeça de quem já passou por ali.

No meu caso, havia mais um obstáculo: estava usando uma versão mais antiga do Delphi, sem chat de IA dentro da IDE. Como já uso o VS Code há bastante tempo em projetos web, resolvi fazer uma experiência: levar o projeto Delphi para lá, com o GitHub Copilot. O resultado me surpreendeu, e este post conta como cheguei nele.

Quando decidi trabalhar com IA nesse projeto, percebi que o ponto de partida não era pedir código. Era dar contexto. Estes são os 5 passos que segui. Trabalhei no VS Code com um plugin de Pascal, e o RAD Studio ficou só para compilar e mexer em forms.

1. Pedir à IA um prompt de análise (ainda fora do projeto)

Antes de abrir o projeto, conversei com a IA em um chat comum. Descrevi a stack, o tipo de sistema e o que eu queria: entender a estrutura sem ler tudo na mão. Pedi que ela escrevesse o prompt de análise por mim.

O prompt sai mais completo do que o que eu escreveria sozinho, e nenhum código é exposto nessa etapa.

2. Rodar o prompt dentro do projeto

Com o prompt pronto, abri o projeto no VS Code e pedi a análise ao Copilot, já com acesso aos arquivos. A IA entendeu bem o projeto, sem erros relevantes na leitura.

Um conselho: salve a saída em um arquivo do repositório. Se ficar só no chat, você perde tudo na próxima sessão.

3. Gerar o README

Com a análise em mãos, pedi um README do projeto. Aqui tem uma regra: o resumo do que o produto faz vem de você. A IA entende a estrutura do código, mas não a regra de negócio. Eu passei um resumo do produto e ela organizou o documento em torno dele.

Revise tudo. Texto bem escrito não garante texto correto.

4. Gerar o AGENTS.md (as regras do projeto)

Este foi o passo que mais rendeu. O arquivo de instruções diz à IA o que ela deve e o que não deve fazer. Alguns exemplos de regras que coloquei:

## Nomenclatura
- Variáveis locais começam com `l`: `lNome`, `lDescricao`.
- Não usar caracteres especiais em nomes de identificadores.
- Prefixos de componentes:
  - `edt` para edits e calcedits
  - `grd` para qualquer grid
  - `dtp` para datetimepicker e componentes de data em geral


 Não fazer refactor fora do escopo da tarefa.
 Não fazer refactors grandes demais.