← Voltar para Início
● Documentação Renderizada em Markdown
Manipulação Cirúrgica de Arquivos: Como Pedir Alterações Sem Quebrar seu Projeto
A principal vantagem do Google Antigravity sobre os chats comuns é que o agente enxerga e manipula seus arquivos locais diretamente. No entanto, dar instruções vagas para um agente manipular arquivos pode levar a regravações destrutivas.
🛑 O Erro Comum vs A Abordagem Cirúrgica
| Abordagem Amadora (Chatbot) | Abordagem Cirúrgica (Antigravity SOTA) |
|---|---|
| Copiar e colar 500 linhas de código no chat para pedir um ajuste | Referenciar o arquivo diretamente: src/components/Header.tsx |
| A IA regrava o arquivo inteiro apagando funções não relacionadas | A IA executa substituição cirúrgica (diffs exatos) em linhas específicas |
| Sem validação de sintaxe (código quebrado) | Validação sintática em RAM (<10ms) antes de confirmar a alteração |
🎯 As 3 Regras de Ouro para Instruir o Agente
1. Especifique o Alvo com Precisão
Sempre use o caminho relativo ou absoluto do arquivo:
No arquivo src/styles/globals.css, altere a variável --ag-bg-canvas para #0B0D13.
2. Peça o Formato Diff / Substituição
Se você deseja que o agente preserve o restante do código, exija o escopo isolado:
Altere apenas a função calculateDiscount() no arquivo cart.py sem modificar o schema do banco de dados.
3. Exija Validação Pré-Voo
Antes de encerrar uma tarefa, peça explicitamente para a IA testar o arquivo modificado:
Rode o comando de teste ou validação de tipos para garantir zero erros antes de declarar concluído.