---
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:**

```markdown
# [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.
```

4.  **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.