Communitygithub.com

cookys/autopilot

Um pipeline multi-foreman para enviar um plano ou um bundle BACKLOG, desde a sonda até o release publicado. Acionadores em chinês tradicional — 派工頭做完發版, 平行工頭, 落地發版.

O que é autopilot?

Este skill implementa um pipeline orquestrado por múltiplos foreman (agentes) para transformar um plano ou bundle BACKLOG em um release publicado. A arquitetura é composta por um foreman de implemento, um foreman de landing e um foreman de fechamento, todos supervisionados pelo depth-0 (agente principal). O depth-0 é a única autoridade que aceita uma reivindicação; a saída de cada foreman é tratada como evidência, nunca como veredito final. O pipeline suporta execução paralela de linhas independentes, revisão combinada obrigatória, e reparos limitados a clusters. A ferramenta é projetada para ambientes que utilizam Claude Code e similares, com suporte a modelos Sonnet e interações heterogêneas. A comunicação e os acionamentos podem ser feitos em chinês tradicional, conforme os gatilhos mencionados.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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.sh nã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. Defina git config core.hooksPath .githooks na 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_mode ainda diz enforce apó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.sh completo. Reexecute cada solo vermelho; qualquer coisa ainda vermelha é comparada em origin/develop em 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-remote corresponde 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, mais SendMessage para 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 define core.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 -f correspondem 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.

Habilidades Relacionadas