| 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
- Board canônico primeiro:
.project/tasks.json + .project/verification.json são fonte local de verdade.
- Slice bounded: selecione uma task, faça mudança pequena, valide gate focal, commite, atualize board.
- 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.
- Handoff antes de risco de contexto: em checkpoint, refresque
.project/handoff.json; em compact, pare novo trabalho e deixe auto-resume continuar.
- Escala progressiva: L1 control-plane direto por default; L2 subagente só com readiness; L3 swarm só com preflight/budget/escopo paralelo.
- 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.
- 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.
