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.previewedsem 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-v0para 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.
- 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.mdedocs/design/core/records.md. - 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. - 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.
- Verifique se a versão do plano ou marcador de compatibilidade é compreendido. Se não, pare como
plan-format-unsupported. - 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. - 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. - 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. - 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.previewedregistrá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 comojig-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.
- Inicie apenas histórias cujos pré-requisitos foram finalizados de acordo com o plano e os registros atuais.
- Mantenha histórias inelegíveis esperando; não peça aos workers que tomem suas próprias decisões de dependência.
- 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.
- Trate a saída do worker como trabalho proposto e evidência, não como autoridade de estado.
- Avalie a conclusão apenas a partir de evidência alinhada à política observada pelo runner ou revisor delegado.
- Preserve
doneelandedcomo 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. - 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.
- 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.