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.shno 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. Establecegit config core.hooksPath .githooksen 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_modesigue diciendoenforcedespué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.shcompleto. Vuelve a ejecutar cada rojo solitario; cualquier cosa que siga roja se compara enorigin/developen 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-remotecoincide con el SHA informado, el trailer contiene un ID de revisión real (no<id>), la gobernanza sigue leyendoenforce, 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ásSendMessagepara 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 establececore.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 -fse 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í.