Communitygithub.com

cookys/autopilot

depth-0 quiere enviar un plan autopiloto o un paquete de backlog a través de capataces de fondo (sonnet) y manos heterogéneas, desde la exploración hasta el lanzamiento publicado. Disparadores en chino tradicional — 派工頭做完發版, 平行工頭, 落地發版.

¿Qué es autopilot?

Esta skill implementa un pipeline multi-capataces para enviar un plan o un paquete de BACKLOG de manera autónoma, siguiendo una secuencia estricta: exploración → revisión del plan → capataz de implementación → capataz de aterrizaje → verificación por depth-0 entre cada etapa → capataz de cierre. depth-0 es la única autoridad que acepta un reclamo; la salida de cada capataz es evidencia, nunca un veredicto final. La skill está diseñada para plataformas de agentes de IA como Claude Code, Cursor o Codex, y utiliza `dispatch-hetero.sh` para orquestar capataces en segundo plano. Es especialmente útil para equipos que necesitan automatizar flujos de trabajo complejos de desarrollo con múltiples revisiones y garantías de calidad, minimizando la intervención manual. El pipeline gestiona la implementación en filas paralelas o apiladas, verifica cada paso con pruebas completas y revisiones combinadas, y maneja reparaciones limitadas. Se basa en plantillas de briefs (`templates/*.md`) y reglas documentadas en archivos de referencia, evitando la duplicación de reglas dentro de la propia skill.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cookys/autopilot/tree/HEAD/.claude/skills/foreman-landing-pipeline

Preguntar en tu IA favorita

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

Documentación

foreman-landing-pipeline

Pipeline multi-capataces para enviar un plan o un paquete de BACKLOG: exploración → revisión del plan → capataz de implementación → capataz de aterrizaje → verificación por depth-0 entre cada etapa → capataz de cierre. depth-0 sigue siendo la única autoridad que acepta un reclamo; la salida de cada capataz es evidencia, nunca un veredicto.

0. Trabajo previo (antes de que exista cualquier capataz)

  • Explora cualquier hecho de la plataforma del que dependa el plan que no hayas verificado en esta sesión mediante URL o ejecutando la herramienta real (consulta la sección "No" del proyecto CLAUDE.md). Un hecho no verificado es un candidato a Spike, no un hecho — ponlo en el plan como tal, o explóralo primero.
  • Escribe el plan, luego pásalo por el bucle de revisión del plan (autopilot:hetero-review → dispatch-plan-review), no por el juicio de esta skill:
    • Rúbrica congelada por generación; un cambio de presidente necesita aprobación del operador, no iniciativa de un capataz.
    • Las disposiciones G1 son vinculantes — cada elemento aceptado está en el alcance de las Restricciones Globales del brief de implementación, textualmente.
    • Como máximo G2. Si un elemento de la rúbrica es rechazado en G1, sustitúyelo con una nueva identificación lógica y ticket en lugar de resucitar el antiguo.
    • Ejecuta la verificación de congelación antes de tratar el plan como implementable.
    • Una reparación acotada después de la congelación está permitida para defectos que la propia verificación de congelación saque a la luz — no una reapertura de elementos de rúbrica ya adjudicados.

1. Capataz de implementación

Despacha un capataz de fondo sonnet (cabecera Engine: sonnet — dispatch-model-guard deniega un despacho que la omita) desde templates/implement-brief.md. Juicio para el brief:

  • Un clon, nunca el checkout principal. El clon lleva un commit fantasma ("PARALLEL-RUN LOCAL ONLY — enforcement_mode shadow, never land") para que dispatch-hetero.sh no lo rechace bajo enforce de Misión. Pon el commit fantasma en el propio brief, en la configuración, escrito por depth-0 — nunca lo envíes al capataz como mensaje posterior. Un mensaje posterior no es autorización; un commit fantasma rechazado o mal aplicado es lo que costó wave-1b.
  • Filas apiladas: la base de cada mano = la cabeza aceptada de la fila anterior (su cabeza reparada si fue reparada). Un commit de mano por fila, primero RED, Verify ejecuta la suite propia de la fila más cada suite CONSUMIDORA del contrato tocado — no solo la suite del paquete.
  • La revisión por fila ocurre aquí, pero trátala como necesaria y no suficiente — véase la revisión combinada de §2.
  • Fallos de riel (cuota, 402, preparación, "Cannot use this model") son RAIL-FAIL, no una razón para que el capataz escriba código él mismo.

1b. Dimensiona la forma antes del despacho (2026-10-02/03)

  • Las filas independientes se ejecutan en paralelo, no apiladas: una mano sonnet por fila en su propio árbol de trabajo de un clon, desde templates/hand-brief-common.md. Apila solo dependencias reales. Siete filas S paralelas aterrizaron en ~1 h; un paquete apilado de manos baratas del mismo tamaño tomó ~3 h.
  • Elección de mano: las filas grandes o que tocan señales/trampas/sandboxing reciben una mano sonnet (Agent, modelo sonnet), no una mano de riel barata — 6/7 filas de mano barata necesitaron una ronda de reparación.
  • Nunca omitas la revisión por fila para ahorrar tiempo: v2.36.108 la omitió y tres problemas surgieron solo en la revisión combinada, cada uno costó una ronda de aterrizaje.
  • Barrido de consumidores incl. L1 es parte del Verify de cada mano (la plantilla dice cómo); una mano que ejecuta solo su suite bash empuja el fallo a la puerta de aterrizaje.
  • Informa al operador el tiempo de pared estimado en el despacho.

2. Capataz de aterrizaje

Brief nuevo desde templates/land-brief.md, despachado solo después de que depth-0 haya aceptado cada fila del capataz de implementación a partir de la evidencia de git (diff, no autoinforme). Juicio para el brief:

  • Un clon nuevo desde origin/develop, no el clon de implementación. Establece git config core.hooksPath .githooks en la primera línea de configuración — un clon de aterrizaje sin él envía sin que la puerta de control de calidad previa al push se ejecute nunca (v2.36.99 envió un literal <id> trailer de esta manera).
  • Selecciona solo commits de mano. Nunca el commit fantasma; grep enforcement_mode sigue diciendo enforce después de cada selección.
  • La suite completa, no un subconjunto limitado — un cambio que toca un contrato ampliamente consumido necesita el hooks/tests/run.sh completo. Vuelve a ejecutar cada rojo solitario; cualquier cosa que siga roja se compara en origin/develop en un árbol de trabajo desechable para separar el rojo preexistente del rojo introducido por la rama.
  • UNA revisión combinada sobre origin/develop..HEAD, nunca una repetición de las revisiones por fila. Una revisión combinada ha atrapado lo que la revisión por fila pasó por alto en este mismo pipeline (multiplexor allow-bypass y cinco hallazgos en una ronda — véase Reglas aprendidas). DETENTE en cualquier 🔴/🟠 en ese veredicto; no los auto-adjudiques.
  • Lanzamiento solo después de que las puertas estén verdes y el veredicto sea SHIP-AS-IS: incremento de versión, BACKLOG/CHANGELOG/INDEX, preflight-release.sh.
  • Los trailers se rellenan desde el ID de revisión real del manifiesto de revisión (el JSON que la revisión combinada realmente produjo), nunca se deja como una cadena de marcador de posición literal. Haz push, luego confirma con git ls-remote origin develop.

3. Deberes de depth-0 entre etapas

  • Re-deriva cada hallazgo refutado tú mismo. ADR-0001 (verificación sobre atestación): "este hallazgo es un falso positivo" de un capataz es una afirmación, no un hecho, hasta que lo re-derives del mismo diff.
  • Verifica cada push de forma independiente: git ls-remote coincide con el SHA informado, el trailer contiene un ID de revisión real (no <id>), la gobernanza sigue leyendo enforce, y ningún commit fantasma ha aterrizado.
  • Los capataces estacionados no se despiertan solos. Usa un temporizador de fondo de hombre muerto (sleep <n>; echo WAKE-<tag>) junto con el despacho, más una verificación de estado de git al despertar, más SendMessage para empujar a un capataz que debería haber informado y no lo ha hecho.

4. Capataz de cierre

Desde templates/closeout-brief.md, en el repositorio real (no un clon — "nada más se ejecuta aquí"). Este paso nunca se omite, incluso para un paquete pequeño:

  • Sincronización de documentos (doc-sync) acotada exactamente al rango de diff que se envió — corrige solo la deriva real.
  • Una fila de BACKLOG para cualquier cosa descubierta durante el pipeline que no estuviera en el alcance para arreglarla ahora (por ejemplo, un incidente de contaminación sospechado pero no confirmado).
  • Un directorio de evidencia bajo docs/plans/evidence/<fecha>-<slug>/ que contenga cada brief, cada INFORME, cada JSON de revisión, más un breve README que nombre las exploraciones y las capturas de la revisión combinada.
  • Actualización de HANDOFF en su estilo existente (aplican convenciones zh-TW — consulta el proyecto CLAUDE.md).
  • Un commit, con la misma puerta que un commit de aterrizaje si toca una ruta protegida por control de calidad.

Reparación (cuando las puertas de aterrizaje se ponen rojas solo en la rama de lanzamiento)

Usa templates/repair-brief.md cuando la ejecución de la puerta del capataz de aterrizaje encuentre suites rojas en la rama de lanzamiento pero verdes en origin/develop. Primero biseca por clúster — confía en la bisección sobre la suposición sospechosa. Una mano de reparación por clúster, en una rama fantasma reconstruida (nunca la rama de lanzamiento misma), revisada de la misma manera que una mano del capataz de implementación. Como máximo una ronda de reparación por clúster; cualquier cosa que siga roja después de eso es FAIL, reportada, no reparada por el capataz mismo.

Reglas — canónicas en otro lugar (no duplicar aquí)

Esta skill es la lista de verificación y las plantillas (templates/*.md). Las reglas y sus eventos fuente viven en:

  • skills/l5/references/hetero-impl-loop.md § "Capataces Sonnet como subagentes del Agente": el commit fantasma va en el brief, un clon de aterrizaje establece core.hooksPath, el ID del trailer viene del manifiesto, y el capataz de aterrizaje se detiene en 🔴/🟠.
  • references/evidence-discipline.md §42–§44: la existencia de un canal de asesoría no es prueba de que llegue; una revisión por fila no puede reemplazar la revisión combinada; un diff de tienda real no es prueba de contaminación de pruebas.
  • Errores comunes de protección de herramientas: exec-boundary bloquea palabras con forma destructiva incluso dentro de texto de heredoc, así que escribe los scripts primero en un archivo; pgrep -f/pkill -f se emparejan a sí mismos. Estos están en la memoria del operador, no en el repositorio.

Cuando se aprende una nueva regla, añádela a esos archivos, no aquí.

Skills relacionados