Architecture Decision Operator | Reveno Agents
Architecture Decision Operator ajuda engenheiros, tech leads e times de plataforma a documentar decisão arquitetural com alternativas e reversibilidade. Método explícito, dados ausentes visíveis e revisão humana antes de uso.
Quando usar
Use para documentar decisão arquitetural com alternativas e reversibilidade, especialmente por engenheiros, tech leads e times de plataforma.
Contexto mínimo
- contexto
- drivers
- restrições
- opções
- horizonte
Método da skill
- definir decisão
- comparar opções
- explicitar diferenças práticas
- avaliar migração
- registrar gatilho de revisão
O que entrega
- ADR
- matriz de opções
- decisão
- consequências
proteção específico
Não escolher tecnologia por popularidade sem relacionar ao requisito.
Ver as 10 skills de Engineering ou explorar o Skill Atlas 100.
Instalação
Gratuito. Instale via marketplace do Claude Code: /plugin marketplace add thiagoholtz/claude-marketplace e /plugin install atlas-engineering-architecture-decision-skill@reveno. Ver instruções de instalação. O Claude Code busca e instala o componente nos bastidores, isso não é uma promessa de "sem instalar nada".
Compatibilidade
Claude Code. Autonomia: manual. Licença: Reveno Open Access 1.0.
Quando usar
Use Architecture Decision Operator quando o objetivo estiver dentro de engenharia e a entrega puder ser revisada por uma pessoa responsável. Defina antes a entrada, o resultado esperado e o critério de aceite. Comece em ambiente controlado, com dados não sensíveis e o menor acesso suficiente.
Quando não usar
Não use como substituto de responsável, política ou controle de execução real. Evite uso automático em decisões de alto impacto, produção ou sistemas externos sem validar a origem, a versão e o comportamento. Se a licença, manutenção ou permissão necessária estiver desconhecida, investigue antes de instalar.
Permissões e cuidados
Nenhuma permissão externa está declarada nesta ficha. Isso não prova ausência de rede, shell, arquivos ou credenciais em execução real. Leia a origem, rode a análise estática e teste com acesso mínimo antes de confiar.
Plano de teste seguro
- Abra a origem e confirme autor, licença, versão e última alteração.
- Leia instruções, dependências, hooks e comandos antes de instalar.
- Use workspace isolado e dados fictícios.
- Mantenha aprovação humana e observe a saída.
- Registre resultado, versão e retorno à versão anterior.
- Adicione à stack somente depois que o caso isolado funcionar.
Da capacidade isolada para uma stack
Um componente resolve um tarefa; uma stack coordena capacidades. Monte uma stack com este componente para documentar ordem, overlap, exposição combinada, pontos de aprovação humana, arquivo de versões e CLAUDE.md. Instale primeiro o menor conjunto possível.
Estado de confiança
Ainda sem verificação real da Reveno (not-tested). O conteúdo é real e instalável; a diferença é que não passou por auditoria formal de segurança, confiabilidade e governança ainda. Avalie antes de usar em produção.
aprovação humana
Revisão humana obrigatória antes de enviar, publicar, aprovar ou executar a saída em ambiente real.
A aprovação humana é um proteção, não um defeito. Entenda o risco de agentes sem governança.
Governança em produção
not-tested não é reprovado: significa que ainda não existe evidência real suficiente. Para levar este componente a uma operação empresarial, veja a Governança de IA da Reveno.
Próximo passo
Montar stack com esta skill · Comparar alternativas · Analisar outra origem. Acompanhe mudanças antes de atualizar em produção.
Badge para o README
Markdown: [](https://agents.reveno.com.br/c/atlas-engineering-architecture-decision-skill)
Outros componentes da mesma categoria
- Code Review Operator: Revisar mudança por correção, segurança, testes e manutenção.
- Engineering Postmortem Operator: Estruturar postmortem técnico orientado a sistema.
- Test Plan Operator: Criar estratégia de testes proporcional ao risco da mudança.
- API Design Operator: Revisar contrato de API por consistência, evolução e falhas.
Stacks que usam este componente
- Engineering Review Stack: Apoiar code review, decisões de arquitetura e revisão de segurança sem aplicar mudanças automaticamente.