Communitygithub.com

agentic-workflow-kit/jig

Cara productizada del conjunto agentic-workflow-kit: paquetes, productos de soporte y bucle de aprendizaje.

¿Qué es jig?

Este skill de agente, Orchestrate Jig, define un runbook de composición local para coordinar trabajo ejecutable a partir de contratos de diseño vigentes. No implementa el runtime de Jig ni actúa como CLI, proveedor o almacén de registros; en su lugar, organiza ejecuciones asistidas por humanos/Codex dentro de los límites de insumos aprobados, superficie de herramientas actual, postura de políticas y capacidad de registro. El skill impone un pre-vuelo (preflight) estricto que verifica la completitud del plan de ejecución, la aprobación del propietario y la compatibilidad, antes de enlazar hechos del runtime y despachar workers o acciones privilegiadas. Separa claramente la autoridad del runner (quien coordina, evalúa evidencias y publica) de la del worker (que lee, edita y produce cambios dentro de un límite de historia autorizado). Cada decisión gobernada, autorización, parada, observación de evidencia y revisión debe ser registrable bajo un contrato de observabilidad para ser considerada verdadera. El skill prefiere paradas con nombre (por ejemplo, plan-not-approved, evidence-insufficient) sobre la improvisación, garantizando recuperabilidad y cumplimiento de gobernanza. Está diseñado para entornos como Claude Code, Cursor y Codex donde se necesita orquestación controlada de múltiples pasos de trabajo.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Orchestrate Jig

Contrato

Coordina el trabajo con forma de ejecución a partir de los contratos de diseño actuales de Jig. Este skill es un runbook de composición local, no una implementación del runtime de Jig, CLI, adaptador de proveedor o almacén de registros. Puede organizar una ejecución asistida por humano/Codex solo hasta donde lo permitan los insumos aprobados, la superficie de herramientas actual, la postura de políticas y la capacidad de registro.

El plan de ejecución es dueño del alcance. Ya debe contener el conjunto de historias, dependencias, límites de trabajo, requisitos de finalización y evidencia, expectativas de autoridad, referencias de política/perfil de trabajo/suelo de repositorio, restricciones y postura de compatibilidad descritos en docs/design/contracts/execution-plan-contract-v0.md. Este skill puede rechazar, vincular, programar, detener o informar. No debe inventar historias, revisar dependencias, debilitar políticas, agregar criterios de aceptación, elegir evidencia de finalización, reinterpretar superficies fuera de alcance ni convertir hechos faltantes del plan en decisiones de runtime.

Los registros son la evidencia. Cada decisión gobernada, autorización, detención, observación de evidencia, resultado de revisión y acción propiedad del runner debe ser registrable bajo docs/design/contracts/observability-records-contract-v0.md antes de tratarse como verdadero. Una narrativa separada, resumen de chat, lista de verificación o informe de trabajador nunca anula el paquete de evidencia registrable.

Límite de Referencia

El skill de entrega orquestada workflow-kit retirado es arte previo solamente. Toma estas lecciones cuando preserven los propios contratos de Jig:

  • verificar previamente la entrada de ejecución antes del despacho;
  • vincular los hechos del runtime después de la verificación previa, no durante la planificación;
  • mantener los cambios producidos por el trabajador separados de las acciones privilegiadas propiedad del runner;
  • requerir evidencia independiente antes de los estados finalizado o aterrizado;
  • dejar una parada recuperable con nombre en lugar de adivinar a través de una capacidad faltante.

No importes las rutas de paquetes de ejecución de workflow-kit, esquema de seguimiento, carpetas de prompts por historia, tablas de enrutamiento de modelos, diseño de paquetes de proveedor, política de rama v-next, reglas antiguas de publicación de PR o reclamos antiguos de runtime. Si una regla de arte previo no se asigna a las propiedades del plan v0 de Jig o a los registros, ignórala y nombra la parada o la brecha de diseño en su lugar.

Insumos

Requiere todos estos antes de cualquier despacho de trabajador o acción privilegiada:

  • un plan de ejecución aprobado compatible con execution-plan-contract-v0;
  • la referencia de política, referencia de perfil de trabajo y referencia de suelo de repositorio a las que el plan se vincula;
  • aprobación del propietario para iniciar o previsualizar en el límite solicitado;
  • hechos actuales del repositorio/árbol de trabajo para la ubicación de ejecución;
  • para límites de inicio, ejecución o aterrizaje: hechos actuales del controlador/articulación para Agente, Host de Ejecución, Forja y Fuente de Trabajo, o una parada explícita si no se puede inspeccionar una articulación requerida;
  • para límites solo de previsualización: suficientes hechos de vinculación para registrar run.previewed sin requerir una identidad de ejecución, asignación de espacio de trabajo, cableado de proveedor o efectos secundarios privilegiados;
  • comandos de verificación actuales y requisitos de evidencia del plan y la política;
  • una ruta de registro, almacén de registros o formato de paquete de registro duradero que pueda preservar las propiedades de observability-records-contract-v0 para esta ejecución local.

Los hechos del runtime desconocidos permanecen desconocidos hasta que se inspeccionan. Los hechos faltantes del plan no son hechos del runtime; son fallos de verificación previa del plan.

Verificación Previa

Ejecuta esta compuerta antes del despacho, ediciones, push, PR, fusión, publicación de estado o cualquier reclamo de que Jig ha iniciado.

  1. Confirma que se leyeron las instrucciones del repositorio y los documentos de fuente de verdad para la superficie 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 y docs/design/core/records.md.
  2. Verifica que el plan esté aprobado por el propietario o el paso de planificación propietario. Si la aprobación está ausente, detente como plan-not-approved.
  3. Verifica que el plan lleve las propiedades requeridas v0:
    • identidad y procedencia del plan;
    • vinculación de pista;
    • conjunto de historias;
    • modelo de dependencia y elegibilidad;
    • requisitos de finalización y evidencia;
    • autoridad y necesidades de aprobación;
    • referencias de política y perfil de trabajo;
    • requisitos de articulación de pila;
    • restricciones y límites.
  4. Verifica que la versión del plan o el marcador de compatibilidad sea comprendido. Si no, detente como plan-format-unsupported.
  5. Verifica que cada historia seleccionada tenga un ID estable, límite previsto, lista de dependencias, requisitos de evidencia y expectativas de autoridad. Si alguna historia seleccionada pide al runner o al trabajador inferir el alcance, detente como plan-scope-incomplete.
  6. Verifica que el orden de dependencias se pueda derivar sin reescribir el plan. Si el grafo es cíclico, contradictorio o necesita orden inventado, detente como plan-dependency-invalid.
  7. Verifica que las referencias de política, perfil de trabajo y suelo de repositorio estén presentes y sean compatibles con la ejecución solicitada. Si faltan, son incompatibles o debilitarían la política de lanzamiento, detente como binding-input-missing.
  8. Verifica que el límite solicitado esté soportado: previsualización, coordinación de ejecución local, recolección de evidencia, publicación propiedad del runner o detención. La previsualización no es comprometedora: requiere cargar, validar, vincular y un evento run.previewed registrable, pero no identidad de ejecución, espacio de trabajo, proveedor o efecto secundario privilegiado. Si el usuario solicita un comportamiento real de Jig que no existe en el repositorio actual, detente como jig-runtime-unavailable.

La verificación previa puede producir una secuencia de ejecución propuesta, un rechazo o una parada con nombre. No debe reparar el plan.

Vinculación de Runtime

Después de que pase la verificación previa, vincula solo los hechos actuales:

  • ruta del árbol de trabajo, raíz del repositorio, rama, base y limpieza;
  • referencias de política, perfil de trabajo y suelo de repositorio vigentes;
  • historias seleccionadas e historias actualmente elegibles del grafo del plan;
  • comandos de verificación actuales, requisitos de revisión y requisitos de prueba de capacidad;
  • estado de aprobación actual del propietario y límite de detención solicitado;
  • para límites de inicio, ejecución o aterrizaje: disponibilidad y postura de atestación del controlador de Agente, Host de Ejecución, Forja y Fuente de Trabajo;
  • para límites solo de previsualización: postura de vinculación de previsualización y base registrable de run.previewed, sin forzar el cableado del proveedor;
  • destino del registro o ubicación del paquete de registro y su postura de redacción/exportación;
  • acciones propiedad del runner disponibles en la superficie actual, como push, creación de PR, publicación de estado/comentario y fusión.

Registra estas vinculaciones antes del lanzamiento. Las vinculaciones de lanzamiento son inmutables a través de la reanudación: una reanudación puede continuar desde una ejecución detenida, pero no puede intercambiar silenciosamente la política, perfil de trabajo, suelo de repositorio, plan o hechos del controlador. Los supuestos relevantes de seguridad cambiados requieren nueva aprobación del propietario y nueva evidencia antes de continuar.

Límite de Runner y Trabajador

Preserva el límite de autoridad del producto de docs/product/concepts.md y docs/design/core/orchestration.md.

  • El trabajador puede leer, editar, ejecutar verificaciones no privilegiadas, producir un diff, producir evidencia e informar bloqueadores solo dentro del límite de historia autorizado.
  • El trabajador no debe hacer push, abrir o actualizar PRs, publicar estados/comentarios, fusionar, ampliar la autoridad, editar pisos de política, marcar historias como aterrizadas ni crear registros como autoridad de lo que sucedió.
  • El runner coordina la elegibilidad, autorización, evaluación de evidencia, registros, escalación al propietario, push, creación de PR, publicación de estado/comentario, fusión, detención, reanudación y exportación.
  • Las acciones privilegiadas requieren autoridad del runner más base de política/evidencia. Un autoinforme de trabajador nunca es suficiente para marcar una acción privilegiada como completa.
  • Una solicitud fuera de la autoridad declarada falla cerrada o se dirige al propietario; nunca se convierte en una concesión implícita más amplia.

Si la superficie actual no puede mantener esta división real, detente como authority-boundary-unsupported.

Bucle de Coordinación

Usa el grafo del plan y los términos del ciclo de vida de Jig sin agregar nuevos estados.

  1. Inicia solo historias cuyos prerrequisitos hayan aterrizado según el plan y los registros actuales.
  2. Mantén las historias no elegibles en espera; no pidas a los trabajadores que tomen sus propias decisiones de dependencia.
  3. Para una historia elegible, despacha al trabajador con el límite de la historia, referencias del plan, expectativas de autoridad, requisitos de evidencia, comandos de verificación, no objetivos y límites de mutación.
  4. Trata la salida del trabajador como trabajo propuesto y evidencia, no como autoridad de estado.
  5. Evalúa la finalización solo a partir de evidencia alineada con la política observada por el runner o un revisor delegado.
  6. Preserva done y landed como hitos separados: una historia puede estar finalizada cuando se cumple la evidencia mientras la fusión permanece retenida por revisión, protección de rama, conflicto, cola o límite del propietario.
  7. Aterriza solo mediante una acción propiedad del runner después de que la evidencia requerida, la aprobación del propietario/revisor cuando sea requerida y la adición de registro/preparación del paquete tengan éxito.
  8. Si una historia bloquea, registra la razón y las historias descendentes afectadas; los hermanos independientes pueden continuar cuando la política y la capacidad lo permitan.

No agregues un rastreador, paquete de historia, paquete de prompt o modelo de fusión inversa a menos que un futuro contrato de diseño de Jig lo introduzca.

Compuerta de Evidencia y Registros

Antes de tratar una transición de estado o decisión gobernada como aceptada, prepara un paquete registrable con las propiedades v0 que aplican al límite solicitado:

  • para rutas de inicio/reanudación/ejecución comprometidas: identidad de ejecución, identidad de intento, referencia del plan, referencia de pista, referencias de política/perfil de trabajo/suelo de repositorio y contexto del controlador;
  • para rutas solo de previsualización: referencia del plan, referencia de pista, referencias de política/perfil de trabajo/suelo de repositorio y la base no comprometedora run.previewed, sin inventar una identidad de ejecución o contexto del controlador;
  • familia de eventos y resultado utilizando la altitud actual de familia de eventos de Jig;
  • actor o componente responsable: trabajador, runner, propietario, revisor delegado o controlador;
  • base: regla de política, observación de evidencia, aprobación, prueba de capacidad, evento anterior o referencia del plan;
  • ID de historia cuando corresponda;
  • postura de redacción/exportación;
  • información de orden suficiente para reproducción o reanudación;
  • cualquier bloqueo, detención, aviso, punto de control de reanudación o base de no doble efecto.

Las verificaciones automatizadas, revisiones y atestaciones de capacidad deben ser observadas o verificadas independientemente. Si la evidencia falta, está obsoleta, es solo autoinformada, no verificable o no registrable, la historia no está finalizada y debe detenerse como evidence-insufficient.

Detenciones

Prefiere detenciones con nombre sobre la ejecución improvisada. Un informe de detención debe incluir el nombre de la detención, la ejecución o historia afectada, la compuerta que falló, la base registrable, el punto de control de reanudación seguro cuando esté disponible y la siguiente acción del propietario.

Usa estos nombres de detención a menos que exista un nombre más específico propiedad del plan:

  • plan-not-approved — no hay plan de ejecución aprobado o aprobación de inicio.
  • plan-format-unsupported — el marcador de compatibilidad o la forma del plan es desconocida.
  • plan-scope-incomplete — faltan el alcance, límite, evidencia o necesidades de autoridad de la historia seleccionada.
  • plan-dependency-invalid — el grafo de dependencias no se puede ejecutar como está escrito.
  • binding-input-missing — las referencias de política, perfil de trabajo, suelo de repositorio o compatibilidad están ausentes o son incompatibles.
  • jig-runtime-unavailable — el comportamiento solicitado requiere capacidad de runtime de Jig más allá de la CLI local actual de prueba (jig preview / jig run / jig inspect).
  • driver-capability-unavailable — no se puede probar una capacidad requerida de Agente, Host de Ejecución, Forja o Fuente de Trabajo.
  • authority-boundary-unsupported — la superficie actual no puede preservar las acciones privilegiadas propiedad del runner y la autoridad contenida del trabajador.
  • records-store-unavailable — ningún almacén de registros duradero o paquete registrable puede preservar las propiedades de registro v0.
  • evidence-insufficient — la evidencia requerida falta, no es verificable, está obsoleta o es solo autoinformada.
  • owner-decision-required — la política dirige una decisión estrecha al propietario.
  • safety-reapproval-required — las entradas relevantes para la seguridad o la gobernanza cambiaron antes de la reanudación o el aterrizaje.

Detenerse es un resultado válido. No suavices una detención en una advertencia cuando la condición faltante es parte de las garantías de control, evidencia, recuperación u observabilidad de Jig.

Salida

Devuelve un libro de contabilidad de ejecución compacto, no un volcado de transcripción:

  • referencia del plan e IDs de historia seleccionados;
  • referencias de política, perfil de trabajo y suelo de repositorio vinculadas;
  • hechos del runtime inspeccionados y hechos desconocidos no resueltos;
  • estados elegibles, iniciados, estacionados, bloqueados, finalizados, aterrizados, rechazados, detenidos, reanudados o completados que sean registrables;
  • evidencia observada y comandos de verificación ejecutados;
  • acciones propiedad del runner tomadas o explícitamente no tomadas;
  • nombres de detención, razones, puntos de control de reanudación seguros y próximas acciones del propietario;
  • referencias del paquete/almacén de registros y postura de redacción;
  • brechas de capacidad no soportadas o de diseño enviadas de vuelta a la superficie de diseño/planificación propietaria de Jig.

Si no existe evidencia registrable para un estado reclamado, informa el estado como no verificado y detente.

Skills relacionados