minions-ai-agents/antigravity_brain_export/processes/codebase-audit-sync.md

description
Auditoria de Codebase e Sincronização do Mapa (Reality Check)

🗺️ Codebase Audit & Sync

Este workflow é o "Ponto de Chegada". Ele garante que a verdade do código corresponda à verdade da documentação.

Fase 1: Escaneamento Tático (Reality Scan)

1. Levantamento de Ativos:

   • [Tool] Executar: python .agent/tools/map_project.py > .gemini/project_map.md.
   • [Search] Identificar novos arquivos fora do .gemini/project_map.md.

2. Map Sync:

   • [Instruction] Atualizar .gemini/project_map.md com qualquer discrepância encontrada.
   • Regra: O mapa deve refletir o território real.

Fase 2: Relatório de Oportunidade (The Loop)

3. Reusability Report:

   • [Tool] Executar: python .agent/tools/scanner_reusability.py docs/manual_desenvolvimento/05_Reusabilidade_Ativos.md.
   • [Analysis] O Agente deve ler o relatório gerado. Se houver componentes marcados como "Sem documentação", adicionar uma tarefa de Technical Debt para documentá-los.

4. Route & Screen Mapping:

   • [Tool] Executar: python .agent/tools/route_scanner.py
   • Efeito: Isso atualizará docs/manual_desenvolvimento/06_Rotas_E_Telas.md e reconfigurará o robô de testes (qa_routes.json) com as telas novas que você criou.

Fase 3: Conclusão do Ciclo (The Final Gate)

4. Auditoria Sistêmica (The Architect):

   • [Instruction] Executar workflow: .agent/personas/persona-the-architect.md.
   • Ação: O Arquiteto revisa a integridade de todas as camadas (Infra, Lógica, Dados, Segurança).
   • Check: Se a Decisão Final for REJECTED, voltar para Fase 1 ou acionar bug-fix-emergency.md.
   • Check: Se a Decisão Final for INTEGRATED, prosseguir.

5. Commit:

   • [Instruction] O Agente recebeu o selo do Arquiteto.
   • [Instruction] Executar IMEDIATAMENTE o workflow:
   • Next Step: .agent/workflows/git-commit-protocol.md