devops-context

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-identity por perfil
• kubectl 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