joao.goncalves
/
minions-ai-agents
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
minions-ai-agents/antigravity_brain_export/processes/protocol-planning.md

2.7 KiB
Raw Blame History

description
Protocolo Padrão de Planejamento (Efficiency First)

📝 Protocolo de Planejamento (Standard Path)

Este é o workflow padrão para 90% das tarefas (Bugs, Features, Refatoração). Ele foca em velocidade e eficiência.

Regras de Ouro

  1. Contexto Mínimo: Leia apenas o necessário (Top 3-5 arquivos).
  2. Consulta de Documentação: Se for criar algo [NOVO], você DEVE ler docs/manual_desenvolvimento/.
  3. Template Rígido: O implementation_plan.md DEVE seguir o modelo abaixo em Português.

Etapas

  1. Análise de Contexto:

    • [Read] User Request.
    • [Read] project_map.md.
    • [Tool] Usar python .agent/tools/read_context.py <arquivos> para coletar contexto de múltiplos arquivos simultaneamente.

  2. Verificação de Documentação (Compliance):

    • Se a solicitação envolve criar um componente, rota ou tabela nova:
    • [Read] docs/manual_desenvolvimento/manual_estilo_e_padroes.md (ou equivalente).
    • Não invente padrões. Siga o manual.

  3. Drafting (O Plano):

    • [Write] Criar/Atualizar implementation_plan.md.
    • USE ESTE TEMPLATE EXATO:
# [Descrição do Objetivo]
Resumo de uma frase sobre o problema e a correção.

## Análise de Risco (Revisão do Usuário Necessária)
> [!IMPORTANT] / [!WARNING]
> Decisões críticas, breaking changes ou dúvidas que bloqueiam o avanço.
> Se não houver riscos, omitir esta seção completamente.

## Mudanças Propostas
### [Nome do Componente/Grupo]
#### [NOVO] [nome_do_arquivo](caminho)
- Motivo da criação.
#### [MODIFICAR] [nome_do_arquivo](caminho)
- O que será alterado (Lógica/CSS/HTML).
- **Caminho Feliz:** O que acontece quando funciona?
- **Tratamento de Erro:** O que acontece se falhar?

## Plano de Verificação (Quality Gate)
### Verificação Automatizada (O Agente DEVE executar)
- Quais comandos de terminal serão rodados? (Build, Lint, Test).
- **Nota:** Se houver novas telas, execute `python .agent/tools/route_scanner.py` para incluí-las no teste de QA.
- O Agente deve corrigir erros de linter antes de entregar.

### Verificação Visual (O Agente DEVE executar)
- Descrever quais ferramentas serão usadas (ex: `browser_tool` para abrir a página).
- **Critério de Sucesso:** O que o Agente vai procurar no DOM ou na imagem para provar que funcionou?

### Validação Manual (Para o Usuário)
- Passos apenas para o que for impossível o Agente testar sozinho.
  1. Review:
    • [Tool] Validar plano: python .agent/tools/validate_plan.py implementation_plan.md.
    • Se o resultado for ❌, corrija o plano antes de prosseguir.
    • [Notify] Use notify_user para travar a execução até a aprovação do plano.