FAQ & resolução de problemas

Que ficheiro devo gerar — AGENTS.md, CLAUDE.md ou .cursorrules?

O que o teu assistente lê: AGENTS.md (o standard cross-tool emergente), CLAUDE.md (Claude Code), ou .cursorrules (Cursor). Podes gerar mais do que um — corre init uma vez por --target.

Correr outra vez sobrescreve o meu ficheiro?

Sim — o init sobrescreve o destino. Mantém as regras específicas do projeto num ficheiro à parte ou num bloco bem marcado que voltas a acrescentar, para sobreviverem à regeneração.

Como acrescento regras específicas do projeto?

Gera o ficheiro base e depois acrescenta as especificidades do repo (arquitetura, comandos, convenções) abaixo das secções geradas. Ou cria um novo pack — ver Criar o teu próprio pack.

Posso usar só alguns packs?

Sim: --packs core,testing. Corre agent-rules-kit list para os ver todos; --packs all (o default) inclui tudo.

Precisa de ser instalado?

Não — npx agent-rules-kit ... funciona sem instalar. Também podes adicioná-lo como dependência de desenvolvimento e criar um script.

As regras são opinativas — posso discordar?

Claro; são markdown simples em rules/. Faz fork, edita, ou abre um PR. O objetivo é um default sensato, não dogma.