control-plane-ops

name	control-plane-ops
description	Operar o control-plane local-first do agents-lab com board canônico, long-runs bounded, handoff/checkpoint, rollout/rollback e espelhos externos sem perder governança.

Control-plane ops skill

Use esta skill quando a tarefa envolver long-runs, board-first, continuidade, handoff, delegação/subagentes, swarm/colony, mirrors externos ou rollout/rollback operacional.

Prioridade operacional

1. Board canônico primeiro: .project/tasks.json + .project/verification.json são fonte local de verdade.
2. Slice bounded: selecione uma task, faça mudança pequena, valide gate focal, commite, atualize board.
3. Continuidade unattended com trilho: se o foco terminar e houver próxima fatia local-safe óbvia, continue; pare apenas em risco, ambiguidade real ou escopo protegido.
4. Handoff antes de risco de contexto: em checkpoint, refresque .project/handoff.json; em compact, pare novo trabalho e deixe auto-resume continuar.
5. Escala progressiva: L1 control-plane direto por default; L2 subagente só com readiness; L3 swarm só com preflight/budget/escopo paralelo.
6. Reality-check antes de gates amplos: package manager, provider/model, worker capability, CI/publish e políticas distribuídas precisam de prior art/evidência cached + comparação local.
7. Sem auto-close externo: GitHub/Gitea/trackers espelham o board; completion local requer verificação local.

Paridade guide-skill

Guide canônico: docs/guides/control-plane-operating-doctrine.md Paridade mínima: controle do operador para cancelamento; blast radius diagnóstico; leitura de skills confiáveis; higiene de tools; processos em background; no-go para strong unattended sem cancelamento testado Última revisão de paridade: 2026-04-30

Use esta skill como superfície de descoberta. O guide canônico continua sendo a fonte de detalhes, mas as regras abaixo são hard intent operacional para qualquer fatia local-first.

Mapa guide -> skill/playbook

Conteúdo crítico	Guia canônico	Aplicação nesta skill
Loop local-first/board-first	docs/guides/project-canonical-pipeline.md	escolher task, validar, commit, atualizar board
Doutrina unattended	docs/guides/control-plane-operating-doctrine.md	decidir quando continuar sem perguntar, quando parar e como escolher a próxima fatia local-safe
Evolução L1/L2/L3	docs/guides/control-plane-evolution-playbook.md	decidir quando manter simples, delegar ou usar swarm
Checkpoint/compact/handoff	docs/guides/project-canonical-pipeline.md	refrescar handoff no checkpoint e parar novo trabalho no compact
Rollout/rollback de delegação	docs/guides/control-plane-evolution-playbook.md	canário curto, evidência no parent, rollback para L1
Mirror GitHub/Gitea	packages/git-skills/skills/github/SKILL.md	tratar issue externa como referência, não autoridade
Higiene e drift de board	docs/guides/project-canonical-pipeline.md	single writer, lock+atomic, generated apply step

Hard stops recentes da doutrina

• Não tratar ready, complete ou scorecards como autorização de dispatch.
• Não iniciar loop/scheduler/remote/offload/strong unattended sem cancelamento long-run testado, fallback claro do operador, checkpoint e decisão explícita.
• Não mutar pacote upstream/original do pi; usar extensão, wrapper, patch controlado ou PR upstream.
• Não fazer diagnóstico que despeje source maps/bundles/logs grandes; usar leitura bounded, filename/count-only ou exclusão explícita de *.map.
• Não iniciar servers/processos em background automaticamente até existir primitiva com owner/workspace/session, port lock, tail bounded e cleanup.
• Leitura bounded de SKILL.md confiável fora do projeto pode ser permitida; execução/instalação/scan recursivo continuam protegidos.
• Não promover decisão ampla baseada em self-dialogue: use reality-check para separar evidência, hipótese, adoção, adaptação e rejeição.

Influências operacionais (sem desvio de foco)

• Squeez: reduzir ruído/contexto mantendo contrato de decisão.
• MDT: manter docs/superfícies coerentes com check-first.
• Impeccable-style: reforçar clareza de fechamento em boundary (decisão + evidência + próximo passo + rollback) com baixo ruído.

Aplicar influências apenas como micro-primitivas mensuráveis e reversíveis.

Checklist de execução bounded

1. confirmar foco por handoff/board ou criar próxima fatia local-safe óbvia
2. usar diagnósticos só em boundary: reload, checkpoint, seleção, pre-long-run, troubleshooting ou sinal real
3. ler só arquivos-alvo
4. editar/implementar micro-slice
5. rodar teste focal
6. git diff --check
7. commit apenas arquivos intencionais
8. atualizar task + verification com rationale quando sensível
9. repetir automaticamente se o próximo passo for local, pequeno e seguro; caso contrário checkpoint/decisão

Política structured/board-first

• Para .project/tasks.json: preferir board_query/board_update.
• Para .project/verification.json: preferir board_query, read-block/write-block ou structured_io.
• Para artefatos estruturados grandes: usar structured_io, safe_mutate_large_file ou macro-API apropriada antes de edit textual amplo.

Escala e rollback

Sugira L2/L3 apenas com motivo objetivo:

• contexto: janela alta ou tarefa extensa;
• backlog: itens paralelizáveis e independentes;
• readiness: subagent_readiness_status(strict=true) verde;
• custo: quota/provider sem WARN/BLOCK e budget explícito.

Fallback obrigatório: “voltar para L1/control-plane direto” preservando commits, board e handoff já validados.