---
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`