As cinco skills do Archgate que conduzem o fluxo de governança dentro do seu agente de codificação por IA — reviewer, lessons-learned, adr-author, onboard e cli-reference.
O Archgate inclui cinco skills como parte dos plugins de editor. Uma skill é uma capacidade focada e reutilizável que seu agente de codificação por IA invoca em um ponto específico do fluxo de desenvolvimento. Juntas, elas transformam os Architecture Decision Records (ADRs) armazenados em .archgate/ em um ciclo fechado de governança: as regras são escritas, o código é verificado em relação a elas e novas lições retroalimentam as regras.
As skills foram projetadas para serem invocadas automaticamente pelo agente desenvolvedor — você raramente as chama manualmente. Cada uma encapsula uma parte do fluxo:
UNDERSTAND → PLAN → WRITE → VALIDATE → CAPTURE reviewer lessons-learnedonboard é executado uma única vez no início de um projeto para criar os ADRs iniciais. adr-author é a camada de autoria autoritativa para a qual todas as outras skills delegam sempre que um ADR precisa ser criado ou editado. cli-reference é um auxiliar interno que carrega a documentação canônica da CLI sob demanda.
As cinco skills
Seção intitulada “As cinco skills”reviewer
Valida alterações de código em relação aos ADRs do projeto usando sub-agentes específicos por domínio. Ela reúne o contexto com archgate review-context, executa verificações automatizadas e então delega cada domínio afetado a um sub-agente focado que retorna um relatório estruturado de conformidade.
When to use Após escrever ou modificar código, antes do commit. O agente desenvolvedor a invoca como etapa VALIDATE de cada conclusão de tarefa inicial. Violações de ADR são bloqueios definitivos; avisos são exibidos, mas não bloqueiam.
lessons-learned
Captura padrões, erros e melhorias de uma sessão de codificação e os codifica em ADRs ou na memória do projeto, de modo que sejam transmitidos para sessões e agentes futuros. Ela lê a transcrição da sessão e o panorama atual de governança e então propõe ADRs novos ou ampliados.
When to use A etapa CAPTURE — a última etapa do fluxo, após archgate check e a skill reviewer confirmarem a conformidade. Também quando você pede explicitamente para 'capturar aprendizados' ou após resolver um problema não trivial.
adr-author
Cria e edita Architecture Decision Records que correspondem à estrutura, ao tom e à profundidade dos ADRs existentes do projeto. Ela impõe as seis seções obrigatórias, a ordem dos campos do frontmatter, os prefixos de ID por domínio e o arquivo companheiro .rules.ts quando é necessária a aplicação automatizada.
When to use Sempre que um ADR precisa ser escrito ou alterado. É a única camada de autoria — onboard e lessons-learned delegam a ela em vez de tocar nos arquivos de ADR diretamente. Use o Modo de Criação para uma nova decisão e o Modo de Edição para atualizar um ADR existente.
onboard
Inicializa um projeto na governança do Archgate: verifica a CLI, executa archgate init, explora o codebase com sub-agentes paralelos, faz uma entrevista com você, propõe um backlog de ADRs e escreve todos os ADRs aprovados em paralelo antes de entregar um resumo de governança.
When to use Uma única vez, ao configurar o Archgate pela primeira vez em um projeto. Execute-a novamente mais tarde para estender a governança a novos domínios ou auditar ADRs existentes.
cli-reference
Um carregador de referência interno. Ao ser invocada, busca a documentação canônica da CLI do Archgate (comandos da CLI, guia de autoria de regras ou formato de ADR) e retorna apenas a seção que o agente solicitante pediu, para que os agentes nunca tenham que adivinhar a sintaxe dos comandos ou as APIs.
When to use Invocada por outras skills e pelo agente desenvolvedor — não por você diretamente. Ela é carregada antes de executar um comando archgate desconhecido, escrever um arquivo .rules.ts ou escrever um ADR.