dudashuai616/project-task-router

Roteador de Tarefas do Projeto

Roteie o trabalho para a menor estrutura confiável antes de produzir grandes saídas. Preserve a continuidade por meio de arquivos de projeto e transições compactas, em vez de transcrições antigas de chat.

Execute a verificação de complexidade

Classifique a tarefa com o mínimo de cerimônia necessário:

• Simples: Um resultado claro, pouco risco de dependência e nenhuma necessidade de transição durável. Execute diretamente sem mostrar um plano.
• Multi-etapas focado: Uma entrega principal com algumas etapas relacionadas. Dê um plano curto de 2 a 5 etapas e continue na mesma conversa.
• Multi-estágio: Várias entregas distintas, conjuntos de referência diferentes ou dependências claras de upstream/downstream. Proponha fases e limites de conversa antes de produzir o corpo completo do trabalho.
• Longa duração: O trabalho provavelmente abrangerá várias sessões, acumulará muitas decisões ou excederá o contexto confiável da conversa. Estabeleça fontes de verdade, status das fases e um método de transição antes da execução.

Use evidências observáveis em vez de fingir saber uma porcentagem exata de contexto restante. Sinais de alerta incluem revisões repetidas, muitos arquivos ou artefatos, dificuldade em verificar restrições iniciais, turnos anteriores resumidos e uma transição de fase que altera o conjunto de referência necessário.

Decida os limites da conversa

Mantenha o trabalho na mesma conversa quando ele for fortemente acoplado, iterar sobre o mesmo artefato ou puder ser concluído de forma confiável com o mesmo pequeno conjunto de contexto.

Recomende uma nova conversa quando pelo menos uma destas condições for verdadeira:

• a fase atual produz um artefato estável consumido por uma fase diferente;
• a próxima fase precisa de arquivos ou expertise substancialmente diferentes;
• a revisão independente de uma entrega é valiosa;
• continuar carregaria grandes quantidades de exploração descartada, logs ou rascunhos rejeitados;
• uma transição compacta baseada em arquivos pode substituir a transcrição com segurança.

Não divida mecanicamente. Uma nova conversa se justifica apenas quando reduz a carga de contexto, retrabalho ou ambiguidade. Recomende conversas separadas e forneça prompts iniciais, mas não crie ou bifurque tarefas de propriedade do usuário, a menos que o usuário solicite explicitamente.

Apresente o cartão de roteamento

Para trabalho multi-estágio ou de longa duração, pause a execução em massa e apresente um cartão de roteamento conciso contendo:

1. Objetivo geral — uma frase.
2. Fases recomendadas — ordenadas por dependência.
3. Limite da conversa — mesma ou nova conversa para cada fase, com justificativa de uma linha.
4. Entradas — arquivos upstream exatos ou decisões confirmadas a serem lidas; evite varreduras amplas de projeto.
5. Saídas — entregas nomeadas e sua localização adequada no projeto.
6. Concluído quando — critérios de conclusão observáveis.
7. Atualização da transição — qual arquivo de status, decisão ou fonte de verdade deve ser atualizado.

Se a decomposição alterar materialmente o escopo ou o sequenciamento, obtenha a concordância do usuário antes de executar as fases posteriores. Quando a primeira fase já estiver claramente autorizada, inicie apenas essa fase após apresentar a estrutura.

Preserve uma cadeia de fonte de verdade

Trate o chat como espaço de trabalho, não como arquivo autoritativo.

• Siga os AGENTS.md aplicáveis e a organização existente do projeto.
• Leia apenas os arquivos exatos necessários para a fase atual.
• Armazene os resultados aceitos em arquivos com nomes claros dentro do projeto real do conteúdo.
• Coloque cada fato durável em um local autoritativo; referencie-o em outros lugares em vez de duplicá-lo.
• Registre apenas decisões que afetam o trabalho futuro. Não preserve raciocínios ocultos, rascunhos descartados ou resumos detalhados de transcrições.
• Quando uma decisão upstream mudar, identifique as entregas downstream que exigem revisão e marque-as claramente no status do projeto.

Prefira um arquivo de status ou decisão existente do projeto. Se nenhum existir e um trabalho significativo entre sessões exigir um, proponha o menor conjunto de arquivos útil em vez de criar um índice para cada projeto.

Crie uma transição compacta

Antes de mudar de conversa, pausar trabalho inacabado ou continuar após o declínio da confiabilidade do contexto, atualize primeiro os artefatos formais e depois prepare uma transição compacta com:

• tarefa e fase atual;
• trabalho concluído e aceito;
• decisões bloqueadas;
• caminhos de arquivos autoritativos e versões;
• trabalho inacabado e bloqueadores;
• próxima ação imediata;
• arquivos exatos que a próxima conversa deve ler;
• um prompt inicial pronto para uso para a próxima conversa.

Mantenha a transição curta o suficiente para ser escaneada rapidamente. A próxima conversa deve retomar a partir dos arquivos formais e da transição, não reconstruir a transcrição antiga.

Padrão de prompt inicial

Use esta estrutura ao recomendar uma nova conversa:

Continue [projeto], fase: [nome da fase].

Leia e siga:
1. [AGENTS.md aplicável]
2. [fonte de verdade do projeto]
3. [status ou transição atual]
4. [artefato upstream exato ou seção relevante]

Não leia: [chats, pastas ou rascunhos irrelevantes].

Objetivo: [objetivo da fase única].
Saída: [entrega nomeada e localização].
Concluído quando: [critérios observáveis].
Após a conclusão: [atualizações de status/decisão/transição].

Mantenha a sobrecarga proporcional

• Não anuncie um fluxo de trabalho complexo para uma solicitação simples.
• Não crie arquivos de planejamento que não tenham consumidor futuro.
• Não releia projetos inteiros quando as fontes exatas são conhecidas.
• Não continue produzindo ativos de estágios posteriores antes que as decisões upstream necessárias estejam estáveis.
• Não use subagentes ou agentes paralelos, a menos que o usuário solicite explicitamente delegação ou instruções aplicáveis exijam.

Quando esta habilidade alterar materialmente a execução, informe brevemente ao usuário que a tarefa está sendo dividida ou transferida e o porquê.