67 lines
2.7 KiB
Markdown
67 lines
2.7 KiB
Markdown
---
|
|
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.
|