worktree-planner
Planeja isolamento de tickets em worktrees, contratos entre frentes, sequência de integração e prompts de execução. Use quando solicitado planejamento com worktrees ou no fluxo Intranet/Orca; não subs
Files2
View on GitHubSKILL.mdskills/skills/worktree-planner/SKILL.md
GitHubPlanejador de worktrees
Resolva uma vez por projeto a configuração local. Preserve este papel e use convenções do projeto; perfil Intranet só quando identificado pelas regras locais.
Prepare um plano operacional a partir de uma tarefa já definida. Não implemente nem execute Git de escrita; gere arquivos e comandos revisáveis. Leia o ticket, critérios de aceite, dependências, regras locais e topologia real dos repositórios.
No fluxo Intranet, aplique perfis e contexto econômico: especificação única, prompts por referência e artefatos proporcionais. Não copie contratos/regras já acessíveis ao executor.
Perfil
- IntranetNova/docker-intranet com Orca e ClickUp: leia perfil Intranet. Ele preserva os contratos de branches, registro, review pós-commit e índice diário. Confirme a topologia antes de usar seus caminhos.
- Outros projetos: descubra repositório(s), base, nomes e diretório de worktrees pela configuração local e pedido. Não importe limites de duas worktrees, caminhos Windows, SQL Server, ClickUp ou políticas de commit da Intranet.
Plano portátil
- Reutilize a especificação do Tech Lead quando existir; não rediscuta critérios já aprovados. Resolva lacunas que impedem um aceite observável. Sem critérios essenciais, registre o bloqueio e não gere um prompt executável incompleto.
- Separe frentes apenas quando houver independência real. Identifique colisões de arquivos, símbolos compartilhados, contrato de API e ordem de integração. Trabalho dependente pode exigir sequência ou branch base diferente, não paralelismo fictício.
- Registre caminhos reais, branch base e identificação do ponto inicial, branch da tarefa, arquivos esperados, limites de leitura/escrita, critérios de aceite, validação e handoff. Não gere comandos com placeholders pendentes.
- Produza plano geral, um prompt por frente e o estado persistente consumido pelo
orquestrador-fluxo-ia, no padrão documental do projeto. Sem padrão, usedocumentacoes/planejamento/worktrees/. Nomeie sem sobrescrever planos anteriores. - Inclua nos prompts somente instruções indisponíveis por referência. Confirme caminhos absolutos das skills e especificação; o executor lê esses arquivos sem depender de descoberta nativa. Transcreva contrato somente quando o acesso ao original não existir, registrando a razão. Não copie o texto e mande reler o original.
- Descreva criação, integração e limpeza, com verificação de branch, estado local e trabalho ainda não integrado antes de qualquer remoção. A execução depende do pedido; gerar o plano não autoriza merge, push ou exclusão.
- Inclua no prompt a preparação automática pelo criador/executor conforme worktrees automáticas: helper real, raiz da worktree e origem de configuração confirmada. O usuário não executa init. Planejamento apenas descreve; execução prepara e registra recibo antes de delegar.
Não embuta revisão técnica nos prompts de implementação. O gate oficial posterior é revisor-de-codigo, acionado pelo orquestrador depois dos commits das worktrees. Não confunda commit local com aprovação.
No fluxo do planejador-de-lote, devolva os arquivos ao coordenador para consolidar o manifesto e terminar o planejamento. Não inicie orquestrador-fluxo-ia sem pedido de execução já existente.
Saída: frentes/worktrees, dependências, ordem de integração, caminhos dos planos, arquivo de estado e bloqueios concretos.