Código
Código que já roda
Rotas, estado global, cliente HTTP e um formulário de exemplo funcionando no primeiro npm run dev.
Convenções de engenharia em português, uma por stack, escritas dentro do projeto. O assistente de IA lê antes de escrever código.
Um projeto novo, com as convenções dentro
npm create veritas@latest my-appOu só as skills, no Claude Code
/plugin marketplace add Caiorhcp/veritas/plugin install veritas@veritasJá vêm junto: o Ponytail (menos código e menos tokens) e o Graphify (o mapa do código)
Instale uma vez. O resto acontece dentro do projeto.
Código
Rotas, estado global, cliente HTTP e um formulário de exemplo funcionando no primeiro npm run dev.
.veritas/
Uma pasta por convenção, com o mesmo texto do plugin, e um INDEX.md que diz qual vale quando.
AGENTS.md
AGENTS.md e CLAUDE.md ganham um bloco que manda ler .veritas/INDEX.md antes de mudar código. Codex, Cursor e Copilot leem um; o Claude Code, o outro.
init
Num repositório que já existe, init detecta a stack e escreve só as convenções. O que já estava no AGENTS.md fica intacto.
Cada uma diz quais libs usar, em que camada cada coisa mora e o que é proibido. Violação é erro, não sugestão.
Num terminal sem ninguém do outro lado (CI, agente, script), a resposta que falta é erro. Nenhum padrão é escolhido em silêncio.
--stack vite|nextjs--skills vite,lgpd--dir apps/web--yes--no-install--lang en--stack$ npx create-veritas new my-app < /dev/nullFaltou resposta e o terminal não é interativo. Passe --stack <vite|nextjs>.$ echo $?1$ npx create-veritas new my-app --stack vite --no-install✓ Pronto: my-appnpx create-veritas new my-app --stack vite --skills vite,principios,lgpd,atomic-design --no-installO Veritas diz o que usar e onde cada coisa mora. O Ponytail, de Dietrich Gebert, diz quanto escrever: a menor mudança que resolve. Juntos, são o par que o Veritas recomenda para todo projeto.
/plugin install ponytail@veritasO Ponytail é um projeto de Dietrich Gebert, sob licença MIT. Todo o crédito é dele: o Veritas só o recomenda e facilita a instalação. @DietrichGebert
Ver o Ponytail no GitHubO Graphify, da Graphify Labs, transforma o código e os documentos do projeto num grafo que dá para consultar. O Veritas o instala junto e diz quando vale usar: antes de mexer em projeto grande ou desconhecido, e em perguntas de arquitetura ou de impacto.
/graphify .O Graphify é um projeto da Graphify Labs, sob licença Apache-2.0. Todo o crédito é deles: o Veritas empacota a skill oficial sem alterações e facilita a instalação. @Graphify-Labs
Ver o Graphify no GitHubskills/principios/SKILL.mdprincipios
Simples, desacoplado, agnóstico: a regra para escolher entre dois caminhos.
Seções
Entram sozinhas quando o assunto aparece.
Texto das convenções em português
Licença MIT
Uma regra errada se corrige no arquivo onde ela mora. Skill nova é uma pasta copiada de docs/modelo-de-skill/, com nome e descrição.
Abrir no GitHub