Lee la guía de escritura y las convenciones de la colección antes de redactar, revisar o responder; un checkout de la colección tiene ambos bajo shared/.
Orquestación Iterativa de Video
Tipo de habilidad: Rígida — preservar el alcance del ticket, trabajo interrumpido, ascendencia de dependencias y puertas de evidencia. Los fallos ordinarios entran en recuperación; no finalizan un intento de implementación.
Propósito y responsabilidad
Convierte una épica de Jira, un tablero de Issues de GitHub o una lista de requisitos explícita, opcionalmente reducida a tickets nombrados, en una cola de entrega duradera. Cada ticket o corrección seleccionada obtiene un agente de implementación exclusivo y un worktree. Antes del envío, el orquestador selecciona el alcance solo backend, solo frontend o multicapa, y proporciona un contrato de ejecución completo. Cada agente de implementación utiliza video-iterative-development para ejecutar ese contrato y producir su envío verificado.
El orquestador delega ejecución, no autoridad de decisión. Posee exclusivamente la interpretación de la fuente, el alcance del ticket, el comportamiento del producto, la selección de repositorio y capa, el orden de dependencias, la topología de ramas y PRs, las desviaciones, la disposición de bloqueadores, el estado del ciclo de vida, la aceptación final y el reporte de tickets. Invoca en lugar de reformular a sus acompañantes:
resume-and-reconcile.mdposee el descubrimiento de trabajo interrumpido y la detección de cambios en el código fuente mapeado.extract-figma-visualsposee la selección de jerarquía de Figma, exportación y validación del paquete.feature-conformanceposee la autoridad de la fuente, registros de decisión, trazabilidad y validación de la reclamación de entrega.video-iterative-developmentposee la implementación asignada, la mecánica de recuperación, la evidencia y el envío. Devuelve observaciones y solicitudes de decisión estructuradas; no cambia el contrato de ejecución ni asigna estados de entrega.agent-implementation-reviewerposee un informe independiente de solo lectura de plan a diff. El orquestador aplica el adaptador de contrato de funcionalidad sin cambiar ese revisor compartido.- La revisión de guía de ingeniería examina el diff final contra las convenciones aplicables del repositorio. Registra consecuencias concretas y excepciones justificadas sin convertir preferencias en nuevos requisitos de ticket.
Autoridad de decisión
Una decisión consecuente es cualquier elección que cambie la interpretación de la fuente, el alcance, el comportamiento del producto o diseño, los repositorios o capas participantes, el orden de dependencias, la topología de ramas o PRs, la evidencia requerida, una desviación aprobada, la disposición de un bloqueador o el estado final del ticket. El orquestador toma y registra cada decisión consecuente antes del envío o en respuesta a una solicitud de un trabajador. Las resoluciones automáticas de fuente autorizadas por esta habilidad también son decisiones del orquestador.
Los agentes de implementación solo pueden elegir mecánicas reversibles y convencionales del repositorio que dejen el contrato de ejecución sin cambios, como la organización local del código, el orden de comandos, los detalles de selectores deterministas, o cómo diagnosticar y reintentar un fallo dentro del alcance. Cuando las instrucciones son incompletas, conflictivas o requieren una elección consecuente, el trabajador no debe adivinar, expandir el alcance, contactar al solicitante, o asignarse un estado terminal. Devuelve una decision_request estructurada al orquestador y continúa todo el trabajo asignado que no se haya visto afectado.
Entradas
- Una clave/enlace de épica de Jira, un tablero de Issues de GitHub o una lista de requisitos explícita y priorizada. Resuelve la cola seleccionada de la solicitud; no requieras Jira para una ejecución basada en GitHub o sin tracker.
- Para modo de corrección, un documento de hallazgos de solo lectura en Markdown.
- Raíces de repositorio cuando no se pueden descubrir desde el espacio de trabajo.
- Un documento de diseño o enlace opcional de solo lectura. La arquitectura es un subtipo de documento, no una categoría de entrada separada.
- Enlaces opcionales de solo lectura a marcos raíz de Figma que contengan
node-idpara tickets de UI aplicables. - Una solicitud opcional para coordinar la ejecución a través de Slack, incluyendo un canal nombrado explícitamente o una solicitud explícita para una ejecución por mensaje directo. Sin ninguno de los dos destinos,
slack-coordinatorusa el repositorio predeterminado. - Cualquier autoridad externa explícita o fecha límite.
No solicites un ID de funcionalidad, archivo de contrato, indicador de aprobación, revisión de Figma o clasificación de capa. La falta de contexto opcional de Figma o documento de diseño no es un bloqueador.
Cuando se solicite coordinación por Slack, invoca slack-coordinator directamente como parte de la orquestación; no generes un agente o panel de Slack separado. Usa una ejecución y un hilo de Slack para la orquestación. El orquestador es el único enlace de Slack y el único consumidor de su run_id; los agentes de implementación informan al orquestador y nunca llaman al coordinador ni consumen la entrada del propietario ellos mismos.
Después de que la ingesta de solo lectura resuelva la épica y los tickets seleccionados, inspecciona un ledger existente en busca de un run_id de coordinador activo. Reanuda esa ejecución si está presente. De lo contrario, confirma que el ejecutable está disponible y llama a run start antes de la primera acción que cambie el estado, usando la épica como trabajo, el resultado solicitado como objetivo y los tickets seleccionados como alcance. Pasa --channel solo para el canal único explícitamente nombrado en la instrucción actual, pasa --dm solo cuando el solicitante solicita explícitamente una ejecución por mensaje directo y, de lo contrario, deja que el coordinador use el repositorio predeterminado. Registra el run_id devuelto, canal, marca de tiempo del hilo y enlace permanente en el ledger en su primera escritura permitida. Nunca inicies una segunda ejecución del coordinador solo porque un ticket comienza, se reanuda, reintenta o cambia de propietario.
Ejecuta run check inmediatamente antes de cada acción del orquestador que cambie el estado e inmediatamente antes de cada envío o seguimiento que autorice trabajo de implementación. Un código de salida 0 permite la acción. En salida 10, aplica, responde o rechaza la entrada del propietario con run resolve, luego verifica de nuevo. En salida 11, pausa, reintenta después de una breve espera e informa la razón; nunca muta el estado, envía trabajo ni recurre a otra ruta de Slack mientras la coordinación no esté disponible. La salida 12 es la decisión explícita de "break-glass" del operador y permite que la ejecución continúe sin más llamadas a Slack.
Usa run event para cambios de fase de orquestación, cambios de ciclo de vida del ticket e inicio o fin de bloqueadores; el daemon es responsable de la re-publicación de estado en intervalos silenciosos. Llama a run finish una vez que la orquestación alcanza su resultado terminal de completado, fallido o cancelado. Sigue los contratos de comando, selección de canal, mensaje y fallo de la habilidad independiente en lugar de reformularlos o debilitarlos aquí. Cuando no se haya solicitado coordinación por Slack, no inicies una ejecución y no agregues puertas de Slack.
Selecciona el modo de ejecución
Usa el modo de entrega sin hallazgos: lee el flujo de trabajo de entrega de Jira para Jira, o el modo de entrega para colas de GitHub y sin tracker. Usa el modo de corrección cuando la cola seleccionada incluya un documento de hallazgos. Lee el flujo de trabajo de corrección.
En cualquier modo, ejecuta reanudación y reconciliación de fuente antes de crear un worktree. Para Jira, el estado es decisivo: In Progress y Code Review son resume_required y deben adoptar el trabajo existente en lugar de comenzar desde la base.
Alcance del ticket y autoridad de diseño
Los requisitos del ticket seleccionado y sus criterios de aceptación definen el límite del trabajo. La épica proporciona contexto de membresía, orden y dependencia; nunca se asume que contiene todos los comportamientos representados en Figma o un documento de diseño. Mapea solo los nodos de Figma y las secciones del documento que aclaran un ticket seleccionado. El contenido de diseño no mapeado es contexto, no trabajo faltante, diferido o fuera de alcance.
Dentro del límite del ticket:
- el Figma mapeado es la autoridad predeterminada para el comportamiento visual e interactivo, incluidos detalles ambiguos o conflictivos del ticket;
- el Figma mapeado anula automáticamente un documento de diseño conflictivo;
- sin Figma aplicable, un documento de diseño mapeado resuelve detalles ambiguos del ticket;
- las convenciones del repositorio y la API resuelven los detalles de implementación restantes.
Registra cada resolución automática en .agent-evidence/orchestration/<run-id>/decision-log.md. Pausa solo el ticket afectado para la rara elección no resuelta cuyas alternativas cambien materialmente el alcance del producto o el comportamiento del usuario. Una salida explícitamente aprobada de las fuentes autorizadas es una approved_deviation; las decisiones de implementación ordinarias y las resoluciones de Figma no son desviaciones.
Crea un manifiesto de documentos de diseño a nivel de ejecución en .agent-evidence/orchestration/<run-id>/design-documents/manifest.json. Registra la identidad de la fuente, el SHA-256 del documento completo, y solo los IDs estables, títulos y valores SHA-256 de las secciones mapeadas a los tickets seleccionados. feature-conformance hace referencia a este manifiesto; no crea otro.
Para cada raíz de UI proporcionada, invoca extract-figma-visuals antes del envío y pasa su paquete validado a los trabajadores aplicables. Una fuente proporcionada de Jira, Figma o documento de diseño que permanezca ilegible después de verificaciones de acceso y reintentos materialmente diferentes bloquea solo el ticket afectado. Nunca sustituyas contenido desactualizado, un mock recreado o requisitos adivinados.
Establece el estado de ejecución
Antes del envío:
- Crea o continúa un objetivo para el trabajo de la épica seleccionada. Mantenlo activo mientras cualquier ticket tenga trabajo recuperable o independiente.
- Inspecciona la guía del repositorio, el estado actual, los worktrees, las ramas de ticket, los PRs abiertos, las reglas de código generado y los comandos de verificación documentados. Para un PR existente, identifica su worktree de origen y la razón si ese worktree no es utilizable. Para trabajo multicapa, resuelve la configuración de lanzamiento compuesto documentada de los repositorios participantes en su topología de procesos completa: cada comando, argumento, directorio de trabajo, fuente de entorno, orden de dependencia, puerto, sonda de salud/funcionalidad, paso de migración/fixture, paso de generación de cliente, definición de tiempo de ejecución y comando de Android Patrol. Pasa el worktree seleccionado, los comandos de verificación y la topología resuelta al agente de implementación. Una configuración compuesta de IDE documentada en el repositorio es una definición de topología, no una instrucción para invocar el IDE.
- Resuelve los tickets y dependencias a través de la interfaz autenticada del tracker seleccionado, luego ejecuta la reanudación/reconciliación de fuente. Jira usa Jira MCP; una ejecución de GitHub o lista explícita preserva su propio alcance y autoridad de estado.
- Extrae y valida los paquetes de Figma aplicables. Crea el manifiesto único de documentos de diseño cuando se haya proporcionado.
- Invoca
feature-conformanceen modo pre-vuelo. Repara los errores de esquema o mapeo generados por el agente y vuelve a ejecutarlo; no los presentes como bloqueadores de ticket. - Resuelve el directorio de tareas explícito o la raíz de tareas configurada. Usa recibos indexados inmutables como se describe a continuación. Crea un ledger ignorado,
decision-log.md, y los cachés reconstruiblesresume-state.jsonysource-index.json. Jira, Git, PRs, manifiestos actuales y lecturas de fuente actual siguen siendo autorizados cuando los cachés están ausentes o desactualizados. - Construye la tabla de dependencias y registra el propietario, el alcance seleccionado y las capas sin cambios, la superficie de escritura adoptada o nueva, el destino del PR, las asignaciones de fuente, las filas del contrato, las decisiones del orquestador, la puerta de evidencia, el estado de arrendamiento de tiempo de ejecución canónico, el estado de recuperación y el estado final. Cuando la coordinación de Slack está habilitada, también registra su
run_id, canal, marca de tiempo del hilo, enlace permanente y estado de coordinación actual a nivel de ejecución.
Usa estados de máquina canónicos en snake_case: ready, waiting, resume_required, resume_needs_lineage, resume_source_missing, active, source_update_detected, reconciliation_active, correction_active, needs_product_decision, locally_verified, submitted, submitted_verified, y blocked.
Preserva registros indexados y evidencia
index.json es autoritativo para los artefactos de tarea. Registra los recibos de contrato como feature-contract (design.contract), conformidad como feature-conformance (review.conformance), bloqueadores propuestos como delivery-disposition (delivery.disposition), y recibos de envío verificado como submission-closure (delivery.closure). Asigna una nueva iteración inmutable para cada revisión duradera, vinculando su ruta/hash exacto de la instantánea JSON, ticket, cabeza de fuente y registro de contrato/revisión relevante. Selecciona y valida mediante digest los registros actuales antes de usarlos; los índices inválidos nunca recurren a escaneos. Usa el ayudante de artefactos de tarea opcional adyacente o las convenciones manuales exactas. Solo las tareas heredadas genuinamente no indexadas usan registros numerados.
El ledger de ejecución, el inventario de reanudación y el índice de fuente son cachés operativos reconstruibles, no reemplazos de recibos inmutables de aceptación o revisión. Los paquetes visuales sin procesar y las capturas siguen siendo evidencia local excluida. El cuerpo del PR de GitHub, el comentario de evidencia distinto, la captura alojada directa y la lectura de la cabeza actual siguen siendo autoridad de publicación; nunca debilites los hooks de publicación instalados ni los requisitos de evidencia base/actual.
Aísla y apila el trabajo del ticket
Dale a cada agente de implementación activo un worktree y rama exclusivos en cada repositorio que modifique. Nunca compartas un checkout mutable ni descartes cambios interrumpidos.
- Adopta la fuente seleccionada para tickets
In ProgressyCode Review, incluyendo un worktree sucio cuyos cambios pertenezcan a ese ticket. - Crea trabajo nuevo solo para tickets elegibles sin trabajo adoptado.
- Crea una rama dependiente desde la cabeza remota verificada y enviada de su requisito previo.
- Apunta un PR dependiente a esa rama de requisito previo para que el PR contenga solo el delta de su ticket. Registra la ascendencia apilada.
- Reutiliza la rama fuente del PR de corrección existente y el PR. Recrea solo un checkout de esa rama exacta cuando su worktree antiguo no sea utilizable.
- Nunca reinicies, limpies, guardes en stash, fuerces el push ni reescribas trabajo interrumpido solo para simplificar la configuración.
- Secuencia las superficies de escritura superpuestas o crea una rama de ticket de integración dedicada.
Una rama de requisito previo enviada es suficiente para la implementación descendente, la verificación local y el envío.