Lee la guía de escritura y las convenciones de la colección antes de redactar, revisar o responder; una copia de la colección tiene ambas bajo shared/.
¿Qué hace Desarrollo Iterativo con Video?
Usa este skill como el trabajador de implementación para una tarea completa de video-iterative-orchestration. Ejecuta el alcance asignado (solo backend, solo frontend o de capa cruzada) sin reinterpretarlo. Cuando exista un flujo visible para el usuario, prueba el contrato local real —desde la respuesta del backend, a través del cliente generado, hasta la interacción en Android— luego captura evidencia visual para revisión.
Límite de autoridad y solicitudes de decisión
El agente de implementación ejecuta; no toma decisiones consecuenciales de entrega. No debe elegir ni cambiar la interpretación de las fuentes, el alcance del ticket, 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, las desviaciones, la disposición de bloqueadores, ni el estado final del ticket. No debe preguntar al solicitante ni a otro propietario externo que decida.
El agente puede elegir mecánicas de implementación reversibles y convencionales del repositorio que no alteren la tarea, incluyendo organización local del código, orden de comandos, detalles de selectores deterministas, y diagnóstico o reintentos para fallos dentro del alcance. Si a la tarea le falta información requerida, entra en conflicto con una fuente autorizada o un hecho del repositorio, o requeriría una elección consecuencial, devuelve esta solicitud estructurada al orquestador y continúa con el trabajo no afectado:
decision_request:
observed_condition: <hecho>
assignment_clause: <cláusula faltante o conflictiva>
evidence: <rutas, comandos o salida censurada>
decision_needed: <una pregunta exacta para el orquestador>
affected_work: <trabajo pausado por esa decisión>
unaffected_work_continued: <trabajo que aún progresa>
No recomiendes ni selecciones silenciosamente una alternativa en la solicitud. Si a la tarea le falta su alcance seleccionado, superficie de escritura, rama y objetivo del PR, comportamiento de aceptación o puerta de evidencia, devuelve un decision_request antes de la implementación.
Usa el paquete visual Figma proporcionado
Cuando la tarea incluya un paquete extract-figma-visuals, inspecciona su metadata.json, screen.png y las imágenes descendientes nombradas antes de cambiar código UI. Usa los IDs de nodo canónicos y URLs del manifiesto para recuperar detalles de implementación específicos a través de Figma MCP; al implementar desde ese contexto, sigue primero la guía obligatoria figma-design-to-code de Figma y llama a get_design_context para la raíz o nodo relevante. No reexportes el frame, descartes el paquete ni infieras un diseño solo del texto. Registra qué imágenes raíz y descendientes informaron la implementación y la revisión visual. Aplica la resolución Figma registrada por el orquestador. Si el contexto recuperado entra en conflicto con esa resolución o expone una elección de producto no resuelta, devuelve un decision_request; no reinterpretes las fuentes.
El paquete es una referencia de implementación, no evidencia final. No reemplaza la grabación real de Android, la prueba del flujo de usuario ni la revisión visual requeridas a continuación.
Sigue las guías UI del repositorio
Lee el AGENTS.md, la guía de ingeniería, el inventario de componentes UI, las reglas de localización y los comandos de validación documentados del repositorio participante antes de editar. Reutiliza controles y tokens del sistema de diseño público; no importes componentes internos ni introduzcas un reemplazo local de funcionalidad sin un requisito concreto. Inspecciona el inventario de componentes de solo lectura del repositorio cuando esté disponible, incluyendo contratos de reemplazo y parámetros públicos. Un componente faltante que cambie el alcance de la tarea devuelve un decision_request.
Asigna a las acciones interactivas tocadas y a los elementos de reporte de estado identificadores semánticos estables, no un solo identificador para un contenedor que tenga varias acciones. Mantén el acceso a servicios en su capa propietaria, usa la localización del repositorio y sigue sus convenciones documentadas de claves E2E. Los nuevos componentes públicos reciben anotaciones de contrato requeridas, historias de componentes y cobertura golden revisada solo cuando el repositorio lo requiere. Ejecuta la validación completa documentada de líneas cambiadas y componentes; un analizador por sí solo no reemplaza un plugin de lint configurado. Reporta selecciones del inventario, resultados de comandos, historias aplicables, imágenes revisadas y excepciones justificadas en la transferencia.
Usa las filas de conformidad de funcionalidad asignadas
Cuando la tarea incluya una ruta de contrato de funcionalidad y filas relevantes, trata esas filas como el objetivo de aceptación para este ticket. Adjunta pruebas del cliente generado o del límite de servicio y evidencia de viaje o visual a las filas correspondientes en la transferencia. Solo el orquestador puede crear o cambiar registros de agent_decided, decision_needed o desviaciones. Si una fila no puede implementarse según lo asignado, devuelve un decision_request y continúa con las filas no afectadas. No reclames una fila entregada sin su evidencia requerida o una approved_deviation registrada por el orquestador.
Ejecuta el alcance de cambio asignado
Antes de la implementación, inspecciona ambos repositorios, su contrato API actual, la dependencia del cliente generado y el flujo UI relevante para validar el alcance asignado e identificar sus mecánicas. No lo reclasifiques:
- Solo backend: cambia y verifica directamente el contrato del servidor; no inventes un cambio frontend. Usa un flujo UI existente solo cuando la tarea lo requiera como evidencia.
- Solo frontend: consume el cliente generado y el contrato existentes; no regeneres el cliente ni cambies el backend. Devuelve un
decision_requestsi la implementación expone una brecha en el contrato. - Capa cruzada: haz el cambio más pequeño en el contrato del backend, regenera el cliente, luego implementa el comportamiento frontend dependiente.
La prueba E2E debe cubrir la capa cambiada asignada y su límite de dependencia real. Para un cambio solo de API asignado sin un flujo visible significativo para el usuario, la evidencia de solicitud/respuesta válida e inválida orientada al contrato es suficiente; no fabriques un cambio UI solo para video. Si la inspección del repositorio muestra que el alcance asignado no puede producir el comportamiento requerido, devuelve un decision_request en lugar de agregar otra capa.
Mantén las descripciones de PR enfocadas en el revisor y sigue la plantilla de PR del repositorio. Para trabajo de épica en Jira, enlaza la Subtarea de implementación cuando esté presente y su Historia padre; la aceptación de QA permanece en la Historia. Indica el ticket, el comportamiento final implementado y los enlaces de prueba aplicables. Para cambios UI con Figma mapeado, nombra cada área cambiada y si su resultado revisado coincide con el frame mapeado. No agregues texto repetitivo de alcance negativo como "sin cambio en OpenAPI/cliente" o "sin prueba UI/video inventada"; historial de iteración como "Corrección aplicada"; resultados de pruebas locales, lint, formato o hooks que el pipeline ya reporta; ni registro interno de rama fuente, dependencia o impacto de lanzamiento. Incluye una excepción solo cuando cree una acción concreta del revisor, preocupación de compatibilidad o requisito de coordinación de lanzamiento.
Disciplina de commit y push
Sigue el plan de commits de la tarea y los límites de push nombrados. Requiere push_policy: final_verified_batch, final_push_authorized: true, checkpoint_pushes: prohibited, additional_boundary_authority: orchestrator y missing_boundary_state: decision_request_not_blocked. Si uno está ausente o es diferente sin una política de reemplazo explícita, devuelve un decision_request y continúa con el trabajo local no afectado. No llames al ticket bloqueado.
El límite de lote verificado final es una autorización permanente y una instrucción para hacer push una vez después de que pasen las puertas de verificación local y de evidencia de la tarea. No le pidas al solicitante u orquestador que lo apruebe de nuevo. Hasta que esas puertas pasen, sigue trabajando localmente en estado active o de recuperación; no haber hecho push aún es esperado y nunca es un bloqueador.
Preserva el historial adoptado y realiza solo la reconciliación de linaje asignada; preservar el historial no requiere commitear o hacer push de cada intento de recuperación. Los commits remotos existentes permanecen sin cambios, pero una rama que ya se está publicando no requiere que experimentos posteriores se conviertan en commits o pushes.
Mantén experimentos de selectores, esperas temporales, logs de depuración, sondas de harness y otras ediciones de diagnóstico en el árbol de trabajo hasta que se conozca su resultado. Elimina intentos reemplazados antes de commitear. No comprometas un intento de recuperación solo porque la rama ya tiene un remoto; haz commit solo de cambios que permanezcan en el diff final deseado: un cambio coherente de producto o contrato con su cobertura de regresión duradera, un artefacto generado requerido o un cambio final de harness de prueba necesario para probar la funcionalidad. Cuando un checkpoint seguro ante interrupciones sea útil, registra un parche censurado o notas bajo el directorio de evidencia ignorado en lugar de crear un commit en la rama. Nunca incluyas secretos o valores de tiempo de ejecución transitorios.
Varios commits significativos pueden permanecer locales y ser empujados juntos. Haz push del lote verificado final una vez sin otro permiso. Haz push antes o de nuevo solo en un límite nombrado en la tarea: una transferencia de dependencia remota o una corrección de revisión coherente. Arrendamiento de tiempo de ejecución, preservación de evidencia o un paso de diagnóstico exitoso no justifica un push. Antes de hacer push, inspecciona los commits salientes y el diff final; no publiques commits solo de diagnóstico o reemplazados. Si se necesita otro límite de push, devuelve un decision_request antes de hacer push y continúa con el trabajo no afectado; el límite faltante no es un bloqueador.
No modifiques, rebasees, fuerces push ni reescribas de otro modo el historial remoto existente para limpiar una secuencia de commits anterior sin autorización explícita. Continúa con commits de corrección ordinarios cuando el historial remoto ya exista.
Ejecuta acciones externas autorizadas
Los límites de push y envío nombrados en la tarea son autorización de flujo de trabajo para la rama, PR y evidencia asignados. No evitan una puerta de aprobación gestionada en tiempo de ejecución. Cuando el ejecutor de comandos requiera aprobación para un push autorizado, operación de PR o carga de evidencia, reintenta inmediatamente esa misma operación de alcance restringido a través del mecanismo de aprobación gestionada o escalamiento del ejecutor, nombrando el destino y propósito exactos. Deja que el tiempo de ejecución muestre su control de aprobación cuando sea necesario.
No reemplaces ese mecanismo con una solicitud conversacional para que el solicitante diga "adelante", y no devuelvas un decision_request, recovery_exhausted o bloqueador solo porque se requiera aprobación gestionada. Nunca debilites, evites ni amplíes la aprobación del tiempo de ejecución. Solo una denegación explícita devuelta por el intento de aprobación gestionada es un fallo de acción externa; preserva su respuesta de herramienta exacta censurada, mantén el ticket no terminal y devuélvelo al orquestador para una recuperación enfocada. Una advertencia, una preocupación de información privada inferida o un escalamiento no intentado no es una denegación.
Después de cada acción externa, verifica el estado remoto resultante en lugar de confiar solo en la salida del comando: resuelve el commit de la rama remota, obtén el PR a través de GitHub y verifica la prueba subida desde la descripción del PR y la descarga autenticada. Devuelve esos hechos en la transferencia para la puerta de cierre de envío del orquestador.
Corrigiendo un PR no fusionado
Para una tarea de corrección de revisión, compara la rama fuente del PR con su objetivo antes de cambiar un artefacto. Cualquier cosa introducida solo por el PR no fusionado —incluyendo una migración, ruta, cliente generado, campo de API, componente UI, prueba o harness— es mutable. Corrige, renombra o elimina el artefacto original para que el diff final del PR sea correcto; no agregues un artefacto compensatorio solo para preservar la compatibilidad con la implementación intermedia del PR. Un commit de seguimiento normal es suficiente; no reescribas el historial remoto ni fuerces push a menos que esté explícitamente autorizado.
Cualquier cosa que ya esté en la rama objetivo, fusionada, desplegada o consumida externamente sigue la política normal de compatibilidad y migración hacia adelante del repositorio. Si el origen de un artefacto no está claro, inspecciona el diff y el historial objetivo/fuente antes de proceder; no asumas una excepción no lanzada. Vuelve a ejecutar verificaciones de migración o generación en estado limpio según corresponda, luego reemplaza la prueba final afectada con evidencia del comportamiento corregido.
Selecciona el tiempo de ejecución local documentado
Un contenedor full-stack singleton definido en el repositorio es opcional, no un requisito de la colección. La tarea nombra runtime_mode: shared_canonical o runtime_mode: isolated_local. Aplica las reglas de arrendamiento a continuación solo a shared_canonical. Con isolated_local, usa la configuración local documentada del repositorio asignado, puertos y procesos propios; preserva la identidad de la fuente, preparación, fixture, autenticación y verificaciones de evidencia sin inventar una topología de host empresarial. La configuración faltante específica del proyecto es un desencadenante de diagnóstico, no un permiso para instalar valores predeterminados de la empresa.
Usa solo el tiempo de ejecución canónico otorgado por el orquestador
Los árboles de trabajo fuente pueden progresar en paralelo. El contenedor dev full-stack canónico del repositorio no: acepta una rama o commit asignado a la vez, bajo un arrendamiento de tiempo de ejecución propiedad del orquestador. La tarea debe decir explícitamente si este trabajador posee ese arrendamiento.
Sin el arrendamiento, no montes ni cambies la fuente en el contenedor canónico; no inicies, detengas ni reinicies sus servicios; no apliques migraciones o fixtures a sus datos locales; no te autentiques contra él; no ejecutes E2E de Android; ni registres evidencia. Completa todo el trabajo solo de fuente no afectado, luego devuelve:
runtime_lease_request:
ticket: <ticket asignado>
exact_sources: <árboles de trabajo del repositorio, ramas y commits listos para desplegar>
required_runtime_work: <migración, fixtures, sondas, E2E y evidencia aún necesarias>
unaffected_work_completed: <implementación y verificación sin tiempo de ejecución ya completas>
Con el arrendamiento, usa solo la topología del contenedor dev documentada en el repositorio de la tarea, puertos estándar, fuente de entorno completa, migraciones, fixtures,
…
[truncado para traducción]