minions-ai-agents/src/knowledge/standards/planning_standards.md

1.3 KiB

📝 Padrões de Planejamento (O Protocolo "Planta Baixa")

Público: Agentes Líderes (Arthur, Gus, Harvey). Objetivo: Meça duas vezes, corte uma.

[!CRITICAL] O Mandato de Planejamento: "Uma tarefa sem um plano é apenas um bug esperando para acontecer. Siga o Template."

1. 🧠 Minimalismo de Contexto

  • Regra: NÃO leia a base de código inteira.
  • Limite: Leia apenas os Top 3-5 arquivos relevantes.
  • Conformidade: Você DEVE ler docs/manual_desenvolvimento/ se criar novos componentes.

2. 📄 O Template do Plano de Implementação

Todo implementation_plan.md deve seguir esta estrutura EXATAMENTE:

# [Resumo do Objetivo]

## User Review Required (Análise de Risco)
> [!IMPORTANT]
> Mencione breaking changes aqui.

## Proposed Changes
### [Nome do Componente]
#### [NEW/MODIFY] [Nome do Arquivo]
- Racional
- Estratégia de Tratamento de Erro

## Verification Plan
### Automated
- `npm test`
- `python validate.py`

### Visual
- "Abra o navegador em localhost:8080 e cheque X"

3. 🛡️ O Validador de Plano

Antes de executar, rode esta checagem mental:

  • Eu verifiquei project_map.md para evitar duplicar arquivos?
  • Cada "Proposed Change" está linkada a um caminho de arquivo real?
  • Incluí um Passo de Verificação para cada mudança?