Agent Skills do ADR Guard
Agent Skills são instruções reutilizáveis e específicas para tarefas. Elas orientam um agente de programação compatível sobre quando e como trabalhar com Architecture Decision Records (ADRs). O ADR Guard oferece 11 skills que cobrem desde a identificação de uma decisão importante até a manutenção de seu histórico.
As skills facilitam a descoberta e o uso consistente do produto. Elas não substituem a equipe de arquitetura, não instalam a CLI do ADR Guard e não dão ao agente autoridade para aceitar decisões.
O que podemos fazer com elas?
Seção intitulada “O que podemos fazer com elas?”| Objetivo | Comece por | Resultado |
|---|---|---|
| Descobrir se a decisão precisa ser documentada | Quando registrar | Recomendação fundamentada: ADR, documento simples ou mais evidências |
| Comparar caminhos possíveis | Análise de trade-offs | Alternativas, critérios, consequências e incertezas explícitos |
| Documentar uma nova decisão | Criar um ADR | Um ADR Proposed para revisão humana |
| Melhorar um registro existente | Validação e Revisão técnica | Diagnósticos estruturais e recomendações fundamentadas, separadamente |
| Mudar uma decisão aceita | Substituição | Nova proposta e relação rastreável sem apagar o histórico |
| Cuidar do acervo de ADRs | Auditoria e Adoção | Avaliação somente leitura e processo leve com responsáveis humanos |
Como funcionam?
Seção intitulada “Como funcionam?”- Você instala a skill específica no ambiente do agente compatível.
- O agente consulta o
SKILL.mdquando a tarefa é relevante. - Ele verifica o formato dos ADRs, os arquivos existentes e a disponibilidade da CLI.
- Ele ajuda a estruturar a análise ou, com sua autorização, executa comandos existentes do ADR Guard.
- Você e as pessoas responsáveis avaliam as evidências e tomam a decisão.
Por exemplo: “Ajude a decidir se nossa mudança para mensageria assíncrona precisa de um ADR; compare as alternativas sem presumir o resultado.”
O agente pode usar adr-guard-when-to-record e adr-guard-tradeoff-analysis. Depois, adr-guard-create pode documentar a proposta. Um adr-guard check bem-sucedido valida a estrutura, mas não o mérito arquitetural.
Por onde começar
Seção intitulada “Por onde começar”- Instalação e pré-requisitos — descoberta, instalação e verificação da CLI independente.
- Catálogo com as 11 skills — escolha a responsabilidade correta.
- Exemplos completos — da nova decisão à auditoria e substituição.
- Segurança e governança — aprovações, privacidade, fontes não confiáveis, formatos e limites.
A especificação Agent Skills define o formato portátil SKILL.md. O Skills CLI facilita a instalação em agentes compatíveis.