worktrail

Worktrail é um sistema de orquestração de tarefas projetado para ser agnóstico ao formato de especificação, permitindo a execução paralela em git worktrees, classificação de rota determinística e transferência de fila de trabalho. Ele foi extraído do marketplace de plugins Claude Code `developer-kit` para ser consumido por qualquer harness com qualquer formato de tarefa via a interface de adaptador `TaskSource`. O sistema compreende múltiplos formatos de tarefa, incluindo arquivos de tarefa DevKit, alterações OpenSpec e tarefas de recurso GitHub Spec Kit. Inclui um hook Stop de execução única por sessão que captura ideias excepcionais de próximos passos após o trabalho substantivo. Principais recursos de operação autônoma: - `worktrail-drain` executa a fila de trabalho de forma não assistida, gerando execuções one-shot headless (Claude, Codex ou OpenCode) que reivindicam briefs na fila, realizam o trabalho e abrem PRs. - Pré-passagem de triagem de entrada: Avalia briefs de entrada em relação a alterações ativas, propõe vereditos (ex: fold-into-change, propose-change) e aplica ações aprovadas (desativado por padrão). - Semeadura de backlog: Converte o backlog de planejamento (ex: especificações no estágio `needs-tasks`) em briefs de fila (ativado por padrão), com semeadura determinística e deduplicada. - Fila de decisão humana: Quando uma decisão de produto é necessária, registra um registro estruturado e aguarda a entrada humana via comandos `worktrail-decision` ou edições de arquivo. - Configuração do operador: Utiliza `~/.worktrail/routing.yaml` para definições de alvo e nível, que governam a seleção de provedor/modelo durante as operações de drain. - Manipulação de estado retomável: Varre e recupera estados interrompidos (ex: orçamento esgotado, verificação pendente). O sistema também fornece `worktrail-check-provider-commands` para validar comandos gerados contra parsers de CLI sem autenticação.