Começar
Dois caminhos, que se somam: o plugin, para o Claude Code carregar as skills sozinho, e a CLI, para as convenções morarem no repositório e valerem para qualquer assistente.
Instale o plugin no Claude Code
Dentro do Claude Code, adicione o marketplace e instale. Depois reinicie.
No Cowork: baixe o veritas.plugin da última versão e arraste para uma conversa.
Ou escreva as convenções no projeto
Para um projeto novo que já roda, ou para um que existe. O que fica no repositório vale para qualquer assistente que leia AGENTS.md.
npm create veritas@latest my-appnpx create-veritas initVeja o que tem
O menu lista as skills, como atualizar e como reportar uma regra que falhou.
/veritas:ajudaMantenha atualizado
No terminal, fora do Claude Code. Ou chame /veritas:atualizar e leia o relatório.
claude plugin marketplace update veritasclaude plugin update veritas@veritas
Contribuir
- É markdown: não precisa saber programar. Antes de criar, procure onde a regra já mora e mude ali.
- Skill nova: copie docs/modelo-de-skill/ para skills/<nome>/. A description diz quando usar, com os termos que um dev usaria.
- O eixo é a stack, não o projeto. Regra que vale para um repositório só vai no CLAUDE.md dele.
- Antes do PR, na pasta plugin/, rode os testes e o validador:
uv run pytestuv run python tools/validate_skills.py skills