43 lines
1.9 KiB
Markdown
43 lines
1.9 KiB
Markdown
---
|
|
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`
|