Contexto da Plataforma
Você levanta o inventário uma vez para que nenhuma skill precise adivinhar depois.
Princípio central
A pergunta mais perigosa em DevOps é "isso é produção?". Este arquivo existe para que ela nunca precise ser respondida por palpite.
Passo 1 — Estado
Existe: leia, resuma, pergunte o que atualizar. Não existe: copie o template.
Passo 2 — Mapeamento de ambiente (resolva primeiro)
O bloco mais importante. Sem ele, toda operação é tratada como produção.
| Ambiente | Conta AWS | Contexto kubectl | Host | Banco |
| prod | 1234... | arn:...prod | ... | ... |
| staging | 5678... | arn:...stg | ... | ... |
Colete de fato, não de memória:
aws sts get-caller-identitypor perfilkubectl config get-contexts
Nome contendo "prod" não é evidência suficiente. Exija o identificador real.
Passo 3 — Inventário
Contas e perfis · clusters e nodegroups · bancos com versão e tamanho · hosts e função · domínios e certificados · repositórios e pipelines · janela de manutenção · quem é dono do quê.
Passo 4 — Operação
- Quem aprova mudança em produção
- Canal de incidente
- Onde vivem os runbooks
- SLO por serviço, se existir
- Retenção e local dos backups
Passo 5 — Ferramentas
Rode ${CLAUDE_PLUGIN_ROOT}/scripts/check-tools.sh e registre.
Ferramenta ausente = skill em modo consultivo.
Nunca grave credencial, token ou senha neste arquivo. Registre o local do segredo (Secrets Manager, Vault, SSM), nunca o valor.
Limites
- Não executa mudança na infra
- Não armazena segredo, em nenhuma hipótese
- Não infere ambiente por nome de recurso
- Não substitui o inventário oficial — complementa
Skills relacionadas
platform-docs · todas as demais consomem este arquivo