Skill CLI Reference

A skill cli-reference é um auxiliar interno para agentes de IA. A CLI archgate, sua API de autoria de .rules.ts e o formato de arquivo de ADR são todos mais recentes do que a maioria dos cortes de treinamento dos modelos — então, em vez de deixar um agente adivinhar, esta skill busca a documentação canônica sob demanda e retorna apenas a seção que o agente solicitou.

Não é para uso direto

Esta skill é invocada por outras skills e pelo agente desenvolvedor, não por você. Ela existe para manter os agentes precisos. Como humano, você deve ler a documentação renderizada em cli.archgate.dev.

O que ela faz

Quando invocada, a skill busca a documentação canônica servida em uma única URL otimizada para LLM e extrai a seção relevante. É um carregador de referência — ela não executa comandos, não escreve arquivos nem raciocina sobre o seu código.

Seções disponíveis

O solicitante especifica de qual seção precisa, e apenas essa seção é retornada (retornar o documento completo esgotaria a janela de contexto do solicitante):

Seção	Carregada quando o agente precisa…
CLI Commands	Executar qualquer comando archgate — sintaxe, flags e saída esperada
Rules Authoring	Escrever ou editar um arquivo .rules.ts — a API RuleContext, o tipo RuleSet e os métodos de relatório
ADR Format	Criar ou editar um arquivo .md de ADR — campos do frontmatter, seções obrigatórias, nomenclatura e prefixos de domínio

Como funciona

1. Ela determina, a partir da solicitação, de qual(is) seção(ões) o agente solicitante precisa.
2. Ela busca a documentação canônica.
3. Ela extrai e retorna apenas a(s) seção(ões) solicitada(s).
4. Se a busca falhar, ela reporta o erro com clareza — nunca adivinha ou reconstrói o conteúdo de referência de memória.

Esse design de fundamentar-em-vez-de-adivinhar é o motivo de a documentação ser a única fonte da verdade: quando um comando ou uma API muda, todo agente capta a mudança na próxima vez que a skill é invocada, sem necessidade de atualizar o plugin.

Como se encaixa no fluxo

cli-reference é uma skill de apoio na qual as outras se apoiam:

• O agente desenvolvedor carrega a seção CLI Commands antes de executar um comando archgate desconhecido.
• A skill adr-author carrega as seções Rules Authoring e ADR Format ao escrever ADRs e seus arquivos companheiros .rules.ts.
• Qualquer agente que esteja inseguro sobre a sintaxe exata carrega a seção relevante em vez de arriscar um comando incorreto.

Os agentes carregam apenas a seção que a tarefa atual exige — nunca todas de uma vez.

Documentação da CLI do Archgate A referência canônica e legível por humanos da CLI da qual esta skill carrega.