Orquestração de Equipe de IA

Use três agentes estáveis:

Nova, Sage e Milo são perspectivas dentro do agente Dev, não camadas de projeto obrigatórias.

Fluxo de Trabalho Padrão

Planejar -> Implementar -> Testar -> Revisão ou QA opcional -> Mesclar -> atualizar estado do projeto

Mantenha o fluxo de trabalho proporcional:

• Pule o planejamento formal para mudanças pequenas e óbvias.
• Use um plano curto para trabalho com múltiplos passos ou que afeta várias partes.
• Adicione revisão ou QA independentes quando o risco, a incerteza ou a política do repositório justificarem.
• Deixe a proteção de branch, verificações obrigatórias, permissões e filas de merge aplicarem a política de merge do repositório.

Iniciar ou Adotar um Projeto

1. Leia as instruções e a documentação existentes do repositório.
2. Descubra a stack real, arquitetura, comandos, modelo de implantação e riscos.
3. Crie ou atualize PROJECT_BRIEF.md apenas quando um contexto duradouro entre sessões for útil. Comece pelo modelo de resumo do projeto e omita seções irrelevantes.
4. Para trabalho substancial, crie um plano conciso a partir do modelo de plano de sprint.
5. Use um branch separado ou clone quando sessões paralelas puderem conflitar, seguindo a própria política Git do repositório.

Executar

Produtor

• Defina o resultado, restrições, critérios de aceitação e exclusões explícitas.
• Escolha revisão e QA com base no risco, em vez de formalidade.
• Mantenha o estado duradouro do projeto conciso e atualizado.

Dev

• Siga as convenções do repositório e implemente a menor solução completa.
• Execute as verificações relevantes e inspecione o diff final.
• Abra ou atualize o pull request com resumo, verificação e limitações.

QA

• Use apenas quando a verificação comportamental dedicada agregar valor.
• Teste a mudança solicitada e regressões importantes.
• Relate descobertas reproduzíveis e verifique correções.

Brainstorms

Use o formato de brainstorm para decisões de produto ou arquitetura que se beneficiam de perspectivas concorrentes. Para escolhas de implementação comuns, deixe o Dev decidir usando as convenções do repositório.

Recuperação de Contexto

Antes de encerrar uma sessão longa ou interrompida:

1. Atualize o plano ativo ou a nota de progresso, se houver.
2. Registre decisões materiais, bloqueios e a próxima ação no contexto do repositório.
3. Use um prompt de "cold-start" como:

Read the repository instructions, then read whichever sources exist for this
work: the active issue or request, PROJECT_BRIEF.md, and the active plan or
progress note.
Continue from the recorded next action.

Herança de Ferramentas e Modelos

Os agentes empacotados intencionalmente omitem o frontmatter tools e model:

• ferramentas embutidas, MCP e de extensão disponíveis permanecem utilizáveis;
• desenvolvedores mantêm o controle da seleção do modelo;
• limites de função são definidos por instruções e confiança normal, permissão, autenticação e controles de aprovação.

Se o ambiente expuser muitas ferramentas, desmarque ferramentas irrelevantes ou servidores MCP, ou use o gerenciamento de ferramentas virtuais do VS Code. Não adicione uma lista de permissão de plugins específica da máquina.

Princípios

• Prefira software funcionando e entregas claras em vez de artefatos de processo.
• Siga a política do repositório em vez de incorporar comandos Git universais.
• Preserve trabalho desconhecido e pergunte antes de ações destrutivas ou privilegiadas.
• Mantenha bugs e decisões importantes em sistemas de projeto duradouros, não apenas no chat.
• Veja anti-padrões para lições concisas.