Communitygithub.com

Orquestrador Jig

Face produtizada do conjunto agentic-workflow-kit: pacotes, produtos de suporte e ciclo de aprendizado.

O que é Orquestrador Jig?

O Orquestrador Jig é uma skill para agentes de IA (como Codex) que coordena a execução de trabalho baseada em contratos de design. Ela age como um runbook de composição local, não como uma implementação de runtime, CLI ou adaptador de provedor. A skill garante que o plano de execução — que já deve conter histórias, dependências, limites de trabalho, critérios de conclusão, evidências e referências de políticas — seja seguido rigorosamente. Ela pode rejeitar, vincular, agendar, parar ou relatar, mas nunca inventar histórias, revisar dependências ou enfraquecer políticas. Os registros são a única evidência aceita: cada decisão, autorização, parada e ação deve ser registrada de acordo com o contrato de observabilidade. A skill suporta plataformas como Cursor, Codex e Claude Code, e funciona por meio de um ciclo de pré-verificação, vinculação de fatos de runtime, separação estrita entre ações do worker (leitura/edição) e do runner (ações privilegiadas como push e merge), e uma porta de evidências. Stops nomeados são preferidos a execução improvisada, garantindo rastreabilidade e segurança.

Funciona com~Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add agentic-workflow-kit/jig

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Orquestrador Jig faz?

Contrato

Coordenar trabalho em forma de execução a partir dos contratos de design atuais do Jig. Esta skill é um runbook de composição local, não uma implementação de runtime Jig, CLI, adaptador de provedor ou repositório de registros. Ela pode organizar uma execução assistida por humano/Codex apenas até onde os inputs aprovados, a superfície de ferramentas atual, a postura de política e a capacidade de registro permitirem.

O plano de execução é dono do escopo. Ele já deve conter o conjunto de histórias, dependências, limites de trabalho, requisitos de conclusão e evidência, expectativas de autoridade, referências a política/perfil de trabalho/piso do repositório, restrições e postura de compatibilidade descritos em docs/design/contracts/execution-plan-contract-v0.md. Esta skill pode rejeitar, vincular, agendar, parar ou relatar. Ela não deve inventar histórias, revisar dependências, enfraquecer política, adicionar critérios de aceitação, escolher evidência de conclusão, reinterpretar superfícies fora do escopo ou converter fatos ausentes do plano em decisões de runtime.

Os registros são a evidência. Cada decisão governada, autorização, parada, observação de evidência, resultado de revisão e ação de propriedade do runner deve ser registrável sob docs/design/contracts/observability-records-contract-v0.md antes de ser tratado como verdadeiro. Uma narrativa separada, resumo de chat, checklist ou relatório de worker nunca substitui o pacote de evidência registrável.

Limite de Referência

A skill de entrega orquestrada workflow-kit aposentada é arte anterior apenas. Carregue estas lições quando elas preservarem os próprios contratos do Jig:

  • pré-validar o input de execução antes do despacho;
  • vincular fatos de runtime após a pré-validação, não durante o planejamento;
  • manter a mudança produzida pelo worker separada das ações privilegiadas do runner;
  • exigir evidência independente antes do estado concluído ou finalizado;
  • deixar uma parada nomeada e recuperável em vez de adivinhar através de capacidade faltante.

Não importe os caminhos de pacote de execução do workflow-kit, esquema de rastreador, pastas de prompt por história, tabelas de roteamento de modelo, layout de pacote de provedor, política de branch v-next, regras antigas de publicação de PR ou reivindicações antigas de runtime. Se uma regra de arte anterior não mapear para as propriedades do plano v0 ou de registro do Jig, ignore-a e nomeie a parada ou lacuna de design em vez disso.

Inputs

Exija todos estes antes de qualquer despacho de worker ou ação privilegiada:

  • um plano de execução aprovado compatível com execution-plan-contract-v0;
  • a referência de política, referência de perfil de trabalho e referência de piso do repositório às quais o plano se vincula;
  • aprovação do proprietário para iniciar ou pré-visualizar no limite solicitado;
  • fatos atuais do repositório/árvore de trabalho para o local de execução;
  • para limites de início, execução ou finalização: fatos atuais do driver/interface para Agente, Host de Execução, Forja e Fonte de Trabalho, ou uma parada explícita se uma interface necessária não puder ser inspecionada;
  • para limites apenas de pré-visualização: fatos de vinculação suficientes para registrar run.previewed sem exigir uma identidade de execução, alocação de workspace, configuração de provedor ou efeitos colaterais privilegiados;
  • comandos de verificação atuais e requisitos de evidência do plano e da política;
  • um caminho de registro, armazenamento de registros ou formato de pacote de registro durável que possa preservar as propriedades de observability-records-contract-v0 para esta execução local.

Fatos de runtime desconhecidos permanecem desconhecidos até serem inspecionados. Fatos de plano ausentes não são fatos de runtime; eles são falhas de pré-validação do plano.

Pré-validação

Execute esta barreira antes de despacho, edições, push, PR, merge, postagem de status ou qualquer afirmação de que o Jig iniciou.

  1. Confirme que as instruções do repositório e os documentos fonte da verdade foram lidos para a superfície tocada: AGENTS.md, docs/product/jig.md, docs/product/guarantees.md, docs/product/concepts.md, docs/design/README.md, docs/design/contracts/execution-plan-contract-v0.md, docs/design/contracts/observability-records-contract-v0.md, docs/design/core/orchestration.md e docs/design/core/records.md.
  2. Verifique se o plano é aprovado pelo proprietário ou pela etapa de planejamento proprietária. Se a aprovação estiver ausente, pare como plan-not-approved.
  3. Verifique se o plano possui as propriedades necessárias da v0:
    • identidade e proveniência do plano;
    • vinculação de faixa;
    • conjunto de histórias;
    • modelo de dependência e elegibilidade;
    • requisitos de conclusão e evidência;
    • necessidades de autoridade e aprovação;
    • referências de política e perfil de trabalho;
    • requisitos de interface de pilha;
    • restrições e limites.
  4. Verifique se a versão do plano ou marcador de compatibilidade é compreendido. Se não, pare como plan-format-unsupported.
  5. Verifique se cada história selecionada tem um ID estável, limite pretendido, lista de dependências, requisitos de evidência e expectativas de autoridade. Se alguma história selecionada pedir ao runner ou worker para inferir escopo, pare como plan-scope-incomplete.
  6. Verifique se a ordem de dependência pode ser derivada sem reescrever o plano. Se o grafo for cíclico, contraditório ou precisar de ordenação inventada, pare como plan-dependency-invalid.
  7. Verifique se as referências de política, perfil de trabalho e piso do repositório estão presentes e são compatíveis com a execução solicitada. Se estiverem ausentes, incompatíveis ou enfraquecerem a política no momento do lançamento, pare como binding-input-missing.
  8. Verifique se o limite solicitado é suportado: pré-visualização, coordenação de execução local, coleta de evidência, publicação de propriedade do runner ou parada. Pré-visualização não é comprometedora: ela requer carregar, validar, vincular e um evento run.previewed registrável, mas nenhuma identidade de execução, workspace, provedor ou efeito colateral privilegiado. Se o usuário solicitar comportamento Jig real que não existe no repositório atual, pare como jig-runtime-unavailable.

A pré-validação pode produzir uma sequência de execução proposta, uma recusa ou uma parada nomeada. Ela não deve reparar plano.

Vinculação de Runtime

Após a pré-validação passar, vincule apenas fatos atuais:

  • caminho da árvore de trabalho, raiz do repositório, branch, base e limpeza;
  • referências de política, perfil de trabalho e piso do repositório em vigor;
  • histórias selecionadas e histórias atualmente elegíveis do grafo do plano;
  • comandos de verificação atuais, requisitos de revisão e requisitos de prova de capacidade;
  • estado atual de aprovação do proprietário e limite de parada solicitado;
  • para limites de início, execução ou finalização: disponibilidade do driver Agente, Host de Execução, Forja e Fonte de Trabalho e postura de atestado;
  • para limites apenas de pré-visualização: postura de vinculação de pré-visualização e a base registrável run.previewed, sem forçar configuração de provedor;
  • destino do registro ou localização do pacote de registro e sua postura de redação/exportação;
  • ações de propriedade do runner disponíveis na superfície atual, como push, criação de PR, postagem de status/comentário e merge.

Registre essas vinculações antes do lançamento. As vinculações de lançamento são imutáveis durante a retomada: uma retomada pode continuar de uma execução parada, mas não pode trocar silenciosamente fatos de política, perfil de trabalho, piso do repositório, plano ou driver. Suposições alteradas relevantes para segurança exigem nova aprovação do proprietário e nova evidência antes de continuar.

Limite do Runner e do Worker

Preserve o limite de autoridade do produto de docs/product/concepts.md e docs/design/core/orchestration.md.

  • O worker pode ler, editar, executar verificações não privilegiadas, produzir um diff, produzir evidência e relatar bloqueadores apenas dentro do limite de história autorizado.
  • O worker não deve fazer push, abrir ou atualizar PRs, postar status/comentários, fazer merge, ampliar autoridade, editar pisos de política, marcar histórias como finalizadas ou criar registros como a autoridade do que aconteceu.
  • O runner coordena elegibilidade, autorização, avaliação de evidência, registros, escalonamento para o proprietário, push, criação de PR, postagem de status/comentário, merge, parada, retomada e exportação.
  • Ações privilegiadas exigem autoridade do runner mais base de política/evidência. Um auto-relato do worker nunca é suficiente para marcar uma ação privilegiada como concluída.
  • Uma solicitação fora da autoridade declarada falha fechada ou é roteada para o proprietário; ela nunca se torna uma concessão implícita mais ampla.

Se a superfície atual não puder manter essa separação real, pare como authority-boundary-unsupported.

Ciclo de Coordenação

Use o grafo do plano e os termos do ciclo de vida do Jig sem adicionar novos estados.

  1. Inicie apenas histórias cujos pré-requisitos foram finalizados de acordo com o plano e os registros atuais.
  2. Mantenha histórias inelegíveis esperando; não peça aos workers que tomem suas próprias decisões de dependência.
  3. Para uma história elegível, despache o worker com o limite da história, referências do plano, expectativas de autoridade, requisitos de evidência, comandos de verificação, não-objetivos e limites de mutação.
  4. Trate a saída do worker como trabalho proposto e evidência, não como autoridade de estado.
  5. Avalie a conclusão apenas a partir de evidência alinhada à política observada pelo runner ou revisor delegado.
  6. Preserve done e landed como marcos separados: uma história pode ser considerada concluída quando a evidência é atendida enquanto o merge permanece retido por revisão, proteção de branch, conflito, fila ou limite do proprietário.
  7. Finalize apenas por ação de propriedade do runner após evidência necessária, aprovação do proprietário/revisor quando necessário, e acréscimo de registro/preparação de pacote terem todos sucesso.
  8. Se uma história bloquear, registre o motivo e as histórias downstream afetadas; irmãos independentes podem continuar quando política e capacidade permitirem.

Não adicione um rastreador, pacote de história, pacote de prompt ou modelo de merge-back a menos que um futuro contrato de design do Jig introduza um.

Barreira de Evidência e Registros

Antes de tratar uma transição de estado ou decisão governada como aceita, prepare um pacote registrável com as propriedades v0 que se aplicam ao limite solicitado:

  • para caminhos de início/retomada/execução comprometidos: identidade de execução, identidade de tentativa, referência do plano, referência de faixa, referências de política/perfil de trabalho/piso do repositório e contexto do driver;
  • para caminhos apenas de pré-visualização: referência do plano, referência de faixa, referências de política/perfil de trabalho/piso do repositório e a base não comprometedora run.previewed, sem inventar uma identidade de execução ou contexto do driver;
  • família de evento e resultado usando a altitude atual de família de evento do Jig;
  • ator ou componente responsável: worker, runner, proprietário, revisor delegado ou driver;
  • base: regra de política, observação de evidência, aprovação, prova de capacidade, evento anterior ou referência do plano;
  • ID da história quando aplicável;
  • postura de redação/exportação;
  • informações de ordenação suficientes para repetição ou retomada;
  • qualquer bloqueio, parada, notificação, ponto de verificação de retomada ou base de não-efeito-duplo.

Verificações automatizadas, revisões e atestados de capacidade devem ser observados ou verificados independentemente. Se a evidência estiver faltando, desatualizada, apenas auto-relatada, não verificável ou não registrável, a história não está concluída e deve parar como evidence-insufficient.

Paradas

Prefira paradas nomeadas em vez de execução improvisada. Um relatório de parada deve incluir o nome da parada, execução ou história afetada, barreira falhada, base registrável, ponto de verificação de retomada seguro quando disponível e próxima ação do proprietário.

Use estes nomes de parada a menos que exista um nome mais específico de propriedade do plano:

  • plan-not-approved — nenhum plano de execução aprovado ou aprovação de início.
  • plan-format-unsupported — marcador de compatibilidade ou forma do plano é desconhecido.
  • plan-scope-incomplete — escopo da história selecionada, limite, evidência ou necessidades de autoridade estão faltando.
  • plan-dependency-invalid — grafo de dependência não pode ser executado como escrito.
  • binding-input-missing — referências de política, perfil de trabalho, piso do repositório ou compatibilidade estão ausentes ou incompatíveis.
  • jig-runtime-unavailable — o comportamento solicitado requer capacidade de runtime Jig além do atual CLI local de simulação (jig preview / jig run / jig inspect).
  • driver-capability-unavailable — uma capacidade necessária de Agente, Host de Execução, Forja ou Fonte de Trabalho não pode ser comprovada.
  • authority-boundary-unsupported — a superfície atual não pode preservar ações privilegiadas do runner e autoridade contida do worker.
  • records-store-unavailable — nenhum armazenamento de registro durável ou pacote registrável pode preservar as propriedades de registro v0.
  • evidence-insufficient — evidência necessária está faltando, não verificável, desatualizada ou apenas auto-relatada.
  • owner-decision-required — a política roteia uma decisão estreita para o proprietário.
  • safety-reapproval-required — inputs que governam regras ou relevantes para segurança mudaram antes da retomada ou finalização.

Parar é um resultado válido. Não suavize uma parada em um aviso quando a condição faltante fizer parte das garantias de controle, evidência, recuperação ou observabilidade do Jig.

Saída

Retorne um registro de execução compacto, não um despejo de transcrição:

  • referência do plano e IDs das histórias selecionadas;
  • referências de política, perfil de trabalho e piso do repositório vinculadas;
  • fatos de runtime inspecionados e fatos desconhecidos deixados não resolvidos;
  • estados elegíveis, iniciados, estacionados, bloqueados, concluídos, finalizados, rejeitados, parados, retomados ou completos que são registráveis;
  • evidência observada e comandos de verificação executados;
  • ações do runner tomadas ou explicitamente não tomadas;
  • nomes de parada, motivos, pontos de verificação de retomada seguros e próximas ações do proprietário;
  • referências de pacote/armazenamento de registro e postura de redação;
  • lacunas de capacidade ou design não suportadas roteadas de volta para a superfície de design/planejamento do Jig proprietário.

Se não existir evidência registrável para um estado reivindicado, reporte o estado como não verificado e pare.

Habilidades Relacionadas