Communitygithub.com

agentic-workflow-kit/jig

Interface industrialisée de la suite agentic-workflow-kit : packages, produits associés et boucle d'apprentissage.

Qu'est-ce que jig ?

Cette compétence, nommée « Orchestrate Jig », pilote l'exécution de travail structuré conforme aux contrats de conception de Jig. Elle agit comme un manuel de composition local et non comme une implémentation complète du runtime Jig. Son rôle est d'organiser une exécution assistée par un humain ou un assistant Codex, dans les limites des entrées approuvées, des outils disponibles, de la politique en vigueur et des contraintes d'enregistrement. Le plan d'exécution possède la portée du travail. Il doit déjà contenir l'ensemble des histoires, dépendances, limites, critères de complétion et de preuve, ainsi que les références de politique et de profil de travail décrites dans le contrat de conception. Jig ne peut ni inventer d'histoires, ni réviser des dépendances, ni affaiblir la politique. Toute décision gouvernée doit être enregistrée conformément au contrat d'enregistrement avant d'être considérée comme vraie. Cette compétence supporte une exécution coordonnée sur le poste local (ou via un agent) avec des vérifications préalables rigoureuses, une liaison dynamique des faits d'exécution, une séparation stricte des actions du runner et du worker, et une boucle de coordination basée sur le graphe du plan. Elle est conçue pour fonctionner avec tout assistant compatible, comme Codex, à condition que les outils et la surface de travail permettent le respect des contrats. L'utilité principale est de garantir que l'exécution du travail reste traçable, vérifiable, et reproductible, en évitant toute improvisation non couverte par le plan. Les arrêts nommés remplacent avantageusement les exécutions improvisées, et chaque arrêt produit un rapport structuré.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Orchestrer Jig

Contrat

Coordonner un travail structuré à partir des contrats de conception actuels de Jig. Cette compétence est un manuel de composition local, pas une implémentation du runtime Jig, ni un CLI, ni un adaptateur de fournisseur, ni un magasin d'enregistrements. Elle peut organiser une exécution assistée (humain / Codex) uniquement dans la mesure où les entrées approuvées, la surface d'outils actuelle, la posture de politique et la capacité d'enregistrement le permettent.

Le plan d'exécution possède la portée. Il doit déjà contenir l'ensemble des histoires, dépendances, limites de travail, exigences de complétion et de preuve, attentes d'autorité, références de politique / profil de travail / socle de dépôt, contraintes et posture de compatibilité décrits dans docs/design/contracts/execution-plan-contract-v0.md. Cette compétence peut rejeter, lier, planifier, arrêter ou reporter. Elle ne doit pas inventer d'histoires, réviser les dépendances, affaiblir la politique, ajouter des critères d'acceptation, choisir les preuves de complétion, réinterpréter les surfaces hors périmètre, ou convertir des faits manquants du plan en décisions d'exécution.

Les enregistrements sont les preuves. Chaque décision gouvernée, autorisation, arrêt, observation de preuve, résultat de revue et action détenue par l'exécuteur doit pouvoir être enregistrée sous docs/design/contracts/observability-records-contract-v0.md avant d'être traitée comme vraie. Aucun récit séparé, résumé de chat, liste de contrôle ou rapport de travailleur ne remplace le paquet de preuves enregistrables.

Limite de Référence

La compétence workflow-kit de livraison orchestrée (en retraite) est un art antérieur uniquement. Conserver les leçons lorsqu'elles préservent les propres contrats de Jig :

  • vérifier l'entrée d'exécution avant l'envoi ;
  • lier les faits d'exécution après la vérification, pas pendant la planification ;
  • garder les modifications produites par le travailleur séparées des actions privilégiées détenues par l'exécuteur ;
  • exiger une preuve indépendante avant l'état terminé ou livré ;
  • laisser un arrêt nommé et récupérable plutôt que de deviner à travers une capacité manquante.

Ne pas importer les chemins de paquets d'exécution de workflow-kit, son schéma de suivi, ses dossiers de prompt par histoire, ses tables de routage de modèle, sa disposition de paquets de fournisseur, sa politique de branche v-next, ses anciennes règles de publication de PR, ou ses anciennes revendications d'exécution. Si une règle antérieure ne correspond pas aux propriétés du plan v0 ou des enregistrements de Jig, l'ignorer et nommer l'arrêt ou l'écart de conception à la place.

Entrées

Exiger toutes les suivantes avant tout envoi de travailleur ou action privilégiée :

  • un plan d'exécution approuvé compatible avec execution-plan-contract-v0 ;
  • la référence de politique, la référence de profil de travail et la référence de socle de dépôt auxquelles le plan se lie ;
  • l'approbation du propriétaire pour démarrer ou prévisualiser à la limite demandée ;
  • les faits actuels du dépôt / arbre de travail pour l'emplacement d'exécution ;
  • pour les limites de démarrage, d'exécution ou de livraison : les faits actuels de pilote / jointure pour l'Agent, l'Hôte d'Exécution, la Forge et la Source de Travail, ou un arrêt explicite si une jointure requise ne peut pas être inspectée ;
  • pour les limites de prévisualisation uniquement : suffisamment de faits de liaison pour enregistrer run.previewed sans exiger d'identité d'exécution, d'allocation d'espace de travail, de câblage de fournisseur ou d'effets secondaires privilégiés ;
  • les commandes de vérification actuelles et les exigences de preuve du plan et de la politique ;
  • un chemin d'enregistrement, un magasin d'enregistrements ou un format de paquet d'enregistrements durable capable de préserver les propriétés d'observability-records-contract-v0 pour cette exécution locale.

Les faits d'exécution inconnus restent inconnus jusqu'à inspection. Les faits manquants du plan ne sont pas des faits d'exécution ; ce sont des échecs de vérification préalable du plan.

Vérification Préalable

Exécuter cette barrière avant tout envoi, édition, push, PR, fusion, publication de statut ou toute affirmation que Jig a démarré.

  1. Confirmer que les instructions du dépôt et les docs de référence ont été lues pour la surface touchée : 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, et docs/design/core/records.md.
  2. Vérifier que le plan est approuvé par le propriétaire ou l'étape de planification propriétaire. Si l'approbation est absente, s'arrêter en tant que plan-not-approved.
  3. Vérifier que le plan contient les propriétés requises v0 :
    • identité et provenance du plan ;
    • liaison de piste ;
    • ensemble d'histoires ;
    • modèle de dépendances et d'éligibilité ;
    • exigences de complétion et de preuve ;
    • besoins d'autorité et d'approbation ;
    • références de politique et de profil de travail ;
    • exigences de jointure de pile ;
    • contraintes et limites.
  4. Vérifier que la version du plan ou le marqueur de compatibilité est compris. Sinon, s'arrêter en tant que plan-format-unsupported.
  5. Vérifier que chaque histoire sélectionnée possède un ID stable, une limite prévue, une liste de dépendances, des exigences de preuve et des attentes d'autorité. Si une histoire sélectionnée demande à l'exécuteur ou au travailleur de déduire le périmètre, s'arrêter en tant que plan-scope-incomplete.
  6. Vérifier que l'ordre des dépendances peut être dérivé sans réécrire le plan. Si le graphe est cyclique, contradictoire ou nécessite un ordre inventé, s'arrêter en tant que plan-dependency-invalid.
  7. Vérifier que les références de politique, de profil de travail et de socle de dépôt sont présentes et compatibles avec l'exécution demandée. Si elles sont manquantes, incompatibles ou affaibliraient la politique au lancement, s'arrêter en tant que binding-input-missing.
  8. Vérifier que la limite demandée est prise en charge : prévisualisation, coordination d'exécution locale, collecte de preuves, publication détenue par l'exécuteur, ou arrêt. La prévisualisation est non engageante : elle nécessite charger, valider, lier et un événement run.previewed enregistrable, mais aucune identité d'exécution, espace de travail, fournisseur ou effet secondaire privilégié. Si l'utilisateur demande un comportement Jig réel qui n'existe pas dans le dépôt actuel, s'arrêter en tant que jig-runtime-unavailable.

La vérification préalable peut produire une séquence d'exécution proposée, un refus ou un arrêt nommé. Elle ne doit pas réparer le plan.

Liaison d'Exécution

Après le succès de la vérification préalable, lier uniquement les faits actuels :

  • chemin de l'arbre de travail, racine du dépôt, branche, base et propreté ;
  • références de politique, profil de travail et socle de dépôt en vigueur ;
  • histoires sélectionnées et histoires actuellement éligibles à partir du graphe du plan ;
  • commandes de vérification actuelles, exigences de revue et exigences de preuve de capacité ;
  • état actuel d'approbation du propriétaire et limite d'arrêt demandée ;
  • pour les limites de démarrage, d'exécution ou de livraison : disponibilité et posture d'attestation des pilotes Agent, Hôte d'Exécution, Forge et Source de Travail ;
  • pour les limites de prévisualisation uniquement : posture de liaison de prévisualisation et base de run.previewed enregistrable, sans forcer le câblage du fournisseur ;
  • destination d'enregistrement ou emplacement du paquet d'enregistrements et sa posture de rédaction / exportation ;
  • actions détenues par l'exécuteur disponibles sur la surface actuelle, telles que push, création de PR, publication de statut/commentaire et fusion.

Enregistrer ces liaisons avant le lancement. Les liaisons de lancement sont immuables lors d'une reprise : une reprise peut continuer à partir d'une exécution arrêtée, mais elle ne peut pas échanger silencieusement la politique, le profil de travail, le socle de dépôt, le plan ou les faits de pilote. Des hypothèses modifiées affectant la sécurité nécessitent une nouvelle approbation du propriétaire et de nouvelles preuves avant de continuer.

Limite entre Exécuteur et Travailleur

Préserver la limite d'autorité du produit de docs/product/concepts.md et docs/design/core/orchestration.md.

  • Le travailleur peut lire, éditer, exécuter des vérifications non privilégiées, produire un diff, produire des preuves et signaler des blocages uniquement à l'intérieur de la limite d'histoire autorisée.
  • Le travailleur ne doit pas push, ouvrir ou mettre à jour des PR, publier des statuts/commentaires, fusionner, élargir l'autorité, éditer les socles de politique, marquer des histoires comme livrées, ou créer des enregistrements en tant qu'autorité de ce qui s'est passé.
  • L'exécuteur coordonne l'éligibilité, l'autorisation, l'évaluation des preuves, les enregistrements, l'escalade vers le propriétaire, le push, la création de PR, la publication de statut/commentaire, la fusion, l'arrêt, la reprise et l'exportation.
  • Les actions privilégiées nécessitent l'autorité de l'exécuteur plus une base de politique/preuve. Un auto-rapport du travailleur n'est jamais suffisant pour marquer une action privilégiée comme terminée.
  • Une demande en dehors de l'autorité déclarée échoue en fermé ou est routée vers le propriétaire ; elle ne devient jamais une concession implicite plus large.

Si la surface actuelle ne peut pas maintenir cette séparation réelle, s'arrêter en tant que authority-boundary-unsupported.

Boucle de Coordination

Utiliser le graphe du plan et les termes du cycle de vie Jig sans ajouter de nouveaux états.

  1. Démarrer uniquement les histoires dont les prérequis ont été livrés selon le plan et les enregistrements actuels.
  2. Garder les histoires inéligibles en attente ; ne pas demander aux travailleurs de prendre leurs propres décisions de dépendances.
  3. Pour une histoire éligible, envoyer le travailleur avec la limite de l'histoire, les références du plan, les attentes d'autorité, les exigences de preuve, les commandes de vérification, les non-objectifs et les limites de mutation.
  4. Traiter la sortie du travailleur comme un travail et des preuves proposés, pas comme une autorité d'état.
  5. Évaluer la complétion uniquement à partir de preuves alignées sur la politique, observées par l'exécuteur ou un réviseur délégué.
  6. Préserver done et landed comme des jalons séparés : une histoire peut être terminée lorsque les preuves sont satisfaites tandis que la fusion reste retenue par la revue, la protection de branche, un conflit, une file d'attente ou une limite de propriétaire.
  7. Livrer uniquement par une action détenue par l'exécuteur après que les preuves requises, l'approbation du propriétaire / réviseur (lorsque requise), et l'ajout d'enregistrement / préparation du paquet ont tous réussi.
  8. Si une histoire bloque, enregistrer la raison et les histoires en aval affectées ; les histoires sœurs indépendantes peuvent continuer lorsque la politique et la capacité le permettent.

Ne pas ajouter de suivi, de paquet d'histoire, de paquet de prompt ou de modèle de réintégration à moins qu'un futur contrat de conception Jig n'en introduise un.

Barrière de Preuves et d'Enregistrements

Avant de traiter une transition d'état ou une décision gouvernée comme acceptée, préparer un paquet enregistrable avec les propriétés v0 qui s'appliquent à la limite demandée :

  • pour les chemins de démarrage/reprise/exécution engagés : identité d'exécution, identité de tentative, référence de plan, référence de piste, références de politique/profil de travail/socle de dépôt et contexte de pilote ;
  • pour les chemins de prévisualisation uniquement : référence de plan, référence de piste, références de politique/profil de travail/socle de dépôt et la base non engageante run.previewed, sans inventer d'identité d'exécution ou de contexte de pilote ;
  • famille d'événements et résultat en utilisant l'altitude actuelle de famille d'événements de Jig ;
  • acteur ou composant responsable : travailleur, exécuteur, propriétaire, réviseur délégué ou pilote ;
  • base : règle de politique, observation de preuve, approbation, preuve de capacité, événement antérieur ou référence de plan ;
  • ID d'histoire lorsque applicable ;
  • posture de rédaction / exportation ;
  • informations d'ordonnancement suffisantes pour la relecture ou la reprise ;
  • toute base de blocage, arrêt, notification, point de contrôle de reprise ou absence de double effet.

Les vérifications automatisées, les revues et les attestations de capacité doivent être observées ou vérifiées indépendamment. Si une preuve est manquante, obsolète, uniquement auto-rapportée, invérifiable ou non enregistrable, l'histoire n'est pas terminée et doit s'arrêter en tant que evidence-insufficient.

Arrêts

Préférer les arrêts nommés aux exécutions improvisées. Un rapport d'arrêt doit inclure le nom de l'arrêt, l'exécution ou l'histoire affectée, la barrière échouée, la base enregistrable, le point de contrôle de reprise sûr (lorsqu'il est disponible) et la prochaine action du propriétaire.

Utiliser ces noms d'arrêt sauf si un nom plus spécifique détenu par le plan existe :

  • plan-not-approved — pas de plan d'exécution approuvé ou d'approbation de démarrage.
  • plan-format-unsupported — le marqueur de compatibilité ou la forme du plan est inconnue.
  • plan-scope-incomplete — le périmètre, la limite, les preuves ou les besoins d'autorité de l'histoire sélectionnée sont manquants.
  • plan-dependency-invalid — le graphe de dépendances ne peut pas être exécuté tel qu'écrit.
  • binding-input-missing — les références de politique, profil de travail, socle de dépôt ou compatibilité sont absentes ou incompatibles.
  • jig-runtime-unavailable — le comportement demandé nécessite une capacité d'exécution Jig au-delà du CLI local actuel en mode dry-run (jig preview / jig run / jig inspect).
  • driver-capability-unavailable — une capacité requise d'Agent, Hôte d'Exécution, Forge ou Source de Travail ne peut pas être prouvée.
  • authority-boundary-unsupported — la surface actuelle ne peut pas préserver les actions privilégiées détenues par l'exécuteur et l'autorité contenue du travailleur.
  • records-store-unavailable — aucun magasin d'enregistrements durable ou paquet enregistrable ne peut préserver les propriétés d'enregistrement v0.
  • evidence-insufficient — la preuve requise est manquante, invérifiable, obsolète ou uniquement auto-rapportée.
  • owner-decision-required — la politique route une décision étroite vers le propriétaire.
  • safety-reapproval-required — des entrées régissant la règle ou affectant la sécurité ont changé avant la reprise ou la livraison.

S'arrêter est un résultat valide. Ne pas adoucir un arrêt en un avertissement lorsque la condition manquante fait partie des garanties de contrôle, de preuve, de récupération ou d'observabilité de Jig.

Sortie

Retourner un registre d'exécution compact, pas un vidage de transcription :

  • référence du plan et IDs d'histoire sélectionnés ;
  • références de politique, profil de travail et socle de dépôt liées ;
  • faits d'exécution inspectés et faits inconnus laissés non résolus ;
  • états éligibles, démarrés, mis en attente, bloqués, terminés, livrés, rejetés, arrêtés, repris ou achevés qui sont enregistrables ;
  • preuves observées et commandes de vérification exécutées ;
  • actions détenues par l'exécuteur prises ou explicitement non prises ;
  • noms d'arrêt, raisons, points de contrôle de reprise sûrs et prochaines actions du propriétaire ;
  • références de paquet / magasin d'enregistrements et posture de rédaction ;
  • écarts de capacité ou de conception non pris en charge, routés vers la surface de planification / conception propriétaire de Jig.

S'il n'existe aucune preuve enregistrable pour un état revendiqué, signaler l'état comme non vérifié et s'arrêter.

Skills associés