foreman-landing-pipeline
Pipeline multi-foreman para enviar um plano ou um bundle BACKLOG: sonda → revisão do plano → foreman de implemento → foreman de landing → verificação depth-0 entre cada estágio → foreman de fechamento. O depth-0 permanece a única autoridade que aceita uma reivindicação; a saída de cada foreman é evidência, nunca um veredito.
0. Pré-trabalho (antes de qualquer foreman existir)
- Sonda qualquer fato da plataforma do qual o plano depende e que você não tenha verificado nesta sessão por URL ou executando a ferramenta real (veja a seção "Não" do projeto CLAUDE.md). Um fato não verificado é um candidato a Spike, não um fato — coloque-o no plano como tal, ou sonde-o primeiro.
- Escreva o plano, depois execute-o através do loop de revisão do plano (
autopilot:hetero-review→dispatch-plan-review), não pelo julgamento deste skill:- Rubrica congelada por geração; uma troca de cadeira precisa de aprovação do operador, não de iniciativa de um foreman.
- As disposições G1 são vinculantes — todo item aceito está no escopo das Restrições Globais do resumo de implemento, literalmente.
- No máximo G2. Se um item da rubrica for derrotado em G1, substitua-o por um novo ID lógico e ticket, em vez de ressuscitar o antigo.
- Execute a verificação de congelamento antes de tratar o plano como implementável.
- Um reparo limitado após o congelamento é permitido para defeitos que a própria verificação de congelamento revelar — não uma reabertura de itens de rubrica já julgados.
1. Foreman de implemento
Despache um foreman sonnet em segundo plano (cabeçalho Engine: sonnet — dispatch-model-guard nega um despacho sem ele) a partir de templates/implement-brief.md. Julgamento para o resumo:
- Um clone, nunca o checkout principal. O clone carrega um commit sombra ("PARALLEL-RUN LOCAL ONLY — enforcement_mode shadow de mission_convergence, nunca landing") para que
dispatch-hetero.shnão recuse sob imposição de Missão. Coloque o commit sombra no próprio resumo, na configuração, de autoria do depth-0 — nunca o envie para o foreman como uma mensagem de acompanhamento. Uma mensagem de acompanhamento não é autorização; um commit sombra recusado ou mal aplicado é o que o wave-1b custou. - Linhas empilhadas: a base manual de cada linha = a cabeça aceita da linha anterior (sua cabeça de reparo, se reparada). Um commit manual por linha, teste RED primeiro, Verify executa a própria suíte da linha mais cada suíte CONSUMER do contrato tocado — não apenas a suíte do bundle.
- Revisão por linha acontece aqui, mas trate-a como necessária e não suficiente — veja a revisão combinada da §2.
- Falhas de trilho (cota, 402, prontidão, "Cannot use this model") são
RAIL-FAIL, não uma razão para o foreman escrever código ele mesmo.
1b. Dimensionar a forma antes do despacho (2026-10-02/03)
- Linhas independentes executam em paralelo, não empilhadas: uma mão sonnet por linha em sua própria árvore de trabalho de um clone, a partir de
templates/hand-brief-common.md. Empilhe apenas dependências verdadeiras. Sete linhas S paralelas pousaram em ~1 h; um bundle de mãos baratas empilhado do mesmo tamanho levou ~3 h. - Escolha da mão: linhas grandes ou que tocam em sinais/armadilhas/sandboxing recebem uma mão sonnet (
Agent, modelo sonnet), não uma mão de trilho barata — 6/7 linhas de mãos baratas precisaram de uma rodada de reparo. - Nunca pule a revisão por linha para ganhar tempo: a v2.36.108 pulou e três problemas surgiram apenas na revisão combinada, cada um custando uma rodada de landing.
- Varredura de consumidores incluindo L1 faz parte do Verify de cada mão (o modelo diz como); uma mão que executa apenas sua suíte bash empurra a falha para o portão de landing.
- Informe ao operador o tempo de parede estimado no despacho.
2. Foreman de landing
Novo resumo a partir de templates/land-brief.md, despachado apenas depois que o depth-0 aceitou cada linha do foreman de implemento a partir de evidências git (diff, não auto-relato). Julgamento para o resumo:
- Um clone fresco de
origin/develop, não o clone de implemento. Definagit config core.hooksPath .githooksna primeira linha de configuração — um clone de landing sem ele envia sem que o qc-gate pré-push nunca execute (a v2.36.99 enviou um literal<id>trailer desta forma). - Apenas cherry-pick de commits manuais. Nunca o commit sombra; grep
enforcement_modeainda dizenforceapós cada pick. - A suíte inteira, não uma fatia escopada — uma alteração que toca um contrato amplamente consumido precisa do
hooks/tests/run.shcompleto. Reexecute cada solo vermelho; qualquer coisa ainda vermelha é comparada emorigin/developem uma worktree descartável para separar vermelho pré-existente de vermelho introduzido pelo branch. - UMA revisão combinada sobre
origin/develop..HEAD, nunca uma reexecução das revisões por linha. Uma revisão combinada já pegou o que a revisão por linha perdeu neste pipeline exato (multiplexador allow-bypass e cinco achados em uma rodada — veja Regras aprendidas). PARE em qualquer 🔴/🟠 nesse veredito; não os anule por conta própria. - Release apenas após os portões estarem verdes e o veredito for SHIP-AS-IS: incremento de versão, BACKLOG/CHANGELOG/INDEX,
preflight-release.sh. - Os trailers são preenchidos a partir do ID de revisão real do manifesto de revisão (o JSON que a revisão combinada realmente produziu), nunca deixados como uma string placeholder literal. Faça push, depois confirme com
git ls-remote origin develop.
3. Deveres do depth-0 entre os estágios
- Rededuza você mesmo cada achado refutado. ADR-0001 (verificação sobre atestação): um "este achado é um falso positivo" de um foreman é uma reivindicação, não um fato, até que você o reduza a partir do mesmo diff.
- Verifique cada push independentemente:
git ls-remotecorresponde ao SHA relatado, o trailer contém um ID de revisão real (não<id>), a governança ainda lêenforce, e nenhum commit sombra pousou. - Foreman estacionados não acordam a si mesmos. Use um temporizador de pausa em segundo plano (
sleep <n>; echo WAKE-<tag>) junto com o despacho, mais uma verificação de estado git ao acordar, maisSendMessagepara cutucar um foreman que deveria ter relatado e não relatou.
4. Foreman de fechamento
A partir de templates/closeout-brief.md, no repositório real (não um clone — "nada mais executa aqui"). Esta etapa nunca é pulada, mesmo para um bundle pequeno:
- Sincronização de documentação escopada exatamente no intervalo de diff que foi enviado — corrija apenas deriva real.
- Uma linha BACKLOG para qualquer coisa descoberta durante o pipeline que não estava no escopo para corrigir agora (por exemplo, um incidente de poluição suspeito mas não confirmado).
- Um diretório de evidências sob
docs/plans/evidence/<data>-<slug>/contendo cada resumo, cada RELATÓRIO, cada JSON de revisão, mais um breve README nomeando as sondas e as capturas da revisão combinada. - Atualização HANDOFF em seu estilo existente (convenções zh-TW se aplicam — veja o projeto CLAUDE.md).
- Um commit, com o mesmo portão que um commit de landing se tocar em um caminho protegido por qc.
Reparo (quando os portões de landing ficam vermelhos apenas no branch de release)
Use templates/repair-brief.md quando a execução do portão do foreman de landing encontrar suítes vermelhas no branch de release, mas verdes em origin/develop. Faça bisect por cluster primeiro — confie no bisect em vez do palpite suspeito. Uma mão de reparo por cluster, em um branch sombra reconstruído (nunca o próprio branch de release), revisado da mesma forma que uma mão de foreman de implemento. No máximo uma rodada de reparo por cluster; qualquer coisa ainda vermelha depois disso é FAIL, relatada, não reparada pelo próprio foreman.
Regras — canônicas em outro lugar (não duplicar aqui)
Este skill é a lista de verificação e os modelos (templates/*.md). As regras e seus eventos de origem vivem em:
skills/l5/references/hetero-impl-loop.md§ "Foreman Sonnet como subagentes Agent": o commit sombra vai no resumo, um clone de landing definecore.hooksPath, o ID do trailer vem do manifesto, e o foreman de landing para em 🔴/🟠.references/evidence-discipline.md§42–§44: um canal de consultoria existir não é prova de que ele chega; uma revisão por linha não pode substituir a revisão combinada; um diff de repositório real não é prova de poluição de teste.- Pegadinhas da proteção de ferramentas: o limite de execução bloqueia palavras de formato destrutivo mesmo dentro de texto heredoc, então escreva scripts para um arquivo primeiro;
pgrep -f/pkill -fcorrespondem a si mesmos. Estas estão na memória do operador, não no repositório.
Quando uma nova regra é aprendida, adicione-a a esses arquivos, não aqui.