Checklist — Aceitação de nova extensão na stack
Gate de soberania (obrigatório)
- Owner de capability definido?
- Qual capability principal cobre?
- Já existe owner first-party para isso?
- Overlap mapeado com evidência?
- colisão nominal
- overlap semântico
- conflito de governança
- Contrato de background (se aplicável)
- lease/heartbeat observável
- status auditável por comando/tool
- ação destrutiva com guardrails
- fallback previsível
- Modo seguro por padrão
- non-interactive conservador
- sem takeover/clear automático
- Operação documentada
- playbook de incidente
- comando de diagnóstico rápido
- Rollout incremental
- feature flag
- A/B com e sem extensão
- plano de rollback
- Anotação de capability no código (obrigatório para capability-bearing)
- adicionar no header da extensão:
@capability-id <id>@capability-criticality high|medium|low
- para criticalidade
high,iddeve existir empackages/pi-stack/extensions/data/capability-owners.json - validado automaticamente por
pnpm run audit:sovereignty:diff
- adicionar no header da extensão:
Este checklist é preventivo (design/aceitação antes de merge). Para falhas já detectadas no pipeline do agents-lab, use o troubleshooting reativo em ci-governance.md.
Política “consolidar antes de expandir”
Se a extensão duplicar capability já coberta e não trouxer ganho comprovado em confiabilidade/custo/UX, não entra na stack curada.