ComposioHQ/criar-plano

Criar Plano

Objetivo

Transformar a solicitação do usuário em um plano único e acionável entregue na mensagem final do assistente.

Fluxo de trabalho mínimo

Durante todo o fluxo de trabalho, opere em modo somente leitura. Não escreva nem atualize arquivos.

1. Escaneie o contexto rapidamente

   • Leia README.md e quaisquer documentações óbvias (docs/, CONTRIBUTING.md, ARCHITECTURE.md).
   • Folheie os arquivos relevantes (aqueles com maior probabilidade de serem modificados).
   • Identifique restrições (linguagem, frameworks, comandos de CI/teste, formato de implantação).

2. Faça perguntas de acompanhamento apenas se forem bloqueantes

   • Faça no máximo 1 a 2 perguntas.
   • Pergunte apenas se não puder planejar de forma responsável sem a resposta; prefira múltipla escolha.
   • Se não tiver certeza, mas não estiver bloqueado, faça uma suposição razoável e prossiga.

3. Crie um plano usando o template abaixo

   • Comece com 1 parágrafo curto descrevendo a intenção e a abordagem.
   • Indique claramente o que está no escopo e o que não está no escopo de forma resumida.
   • Em seguida, forneça uma pequena checklist de itens de ação (padrão de 6 a 10 itens).
     • Cada item da checklist deve ser uma ação concreta e, quando útil, mencionar arquivos/comandos.
     • Torne os itens atômicos e ordenados: descoberta → mudanças → testes → implantação.
     • Verbo primeiro: “Adicionar…”, “Refatorar…”, “Verificar…”, “Implantar…”.
     • Inclua pelo menos um item para testes/validação e um para casos extremos/risco, quando aplicável.
   • Se houver incógnitas, inclua uma pequena seção de Perguntas em aberto (no máximo 3).

4. Não preceda o plano com explicações meta; produza apenas o plano conforme o template

Template do plano (siga exatamente)

# Plano

<1 a 3 frases: o que estamos fazendo, por que e a abordagem de alto nível.>

## Escopo
- Dentro:
- Fora:

## Itens de ação
[ ] <Passo 1>
[ ] <Passo 2>
[ ] <Passo 3>
[ ] <Passo 4>
[ ] <Passo 5>
[ ] <Passo 6>

## Perguntas em aberto
- <Pergunta 1>
- <Pergunta 2>
- <Pergunta 3>

Orientações para itens da checklist

Bons itens de checklist:

• Apontam para arquivos/módulos prováveis: src/..., app/..., services/...
• Nomeiam validações concretas: “Executar npm test”, “Adicionar testes unitários para X”
• Incluem implantação segura quando relevante: feature flag, plano de migração, nota de reversão

Evite:

• Etapas vagas (“lidar com backend”, “fazer autenticação”)
• Muitos micro-passos
• Escrever trechos de código (mantenha o plano independente de implementação)