Pular para o conteúdo
Veritas
  • Nada com esse termo. Tente o nome de uma lib ou de uma stack.

Títulos, descrições e seções de todas as skills.

Veritas

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-app

Ou só as skills, no Claude Code

/plugin marketplace add Caiorhcp/veritas
/plugin install veritas@veritas

Já vêm junto: o Ponytail (menos código e menos tokens) e o Graphify (o mapa do código)

Como funciona

Instale uma vez. O resto acontece dentro do projeto.

Código

Código que já roda

Rotas, estado global, cliente HTTP e um formulário de exemplo funcionando no primeiro npm run dev.

.veritas/

As regras, em .veritas/

Uma pasta por convenção, com o mesmo texto do plugin, e um INDEX.md que diz qual vale quando.

AGENTS.md

Um ponteiro para cada assistente

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

Projeto antigo também

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.

Uma convenção por stack

Cada uma diz quais libs usar, em que camada cada coisa mora e o que é proibido. Violação é erro, não sugestão.

Ver todas as skills →

Toda pergunta tem uma flag

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
o que gerar
--skills vite,lgpd
exatamente estas convenções
--dir apps/web
onde escrever
--yes
confirma o init sem perguntar
--no-install
escreve os arquivos e para
--lang en
mensagens em inglês
Referência completa da CLI →
--stack
Terminal sem ninguém, num CI
$ 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-app
npx create-veritas new my-app --stack vite --skills vite,principios,lgpd,atomic-design --no-install

Menos código, menos tokens: Ponytail

O 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@veritas

O 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 GitHub
  • O que ele fazPõe o agente no modo do dev sênior preguiçoso: YAGNI, biblioteca padrão primeiro e nenhuma abstração que ninguém pediu. Sai menos código para revisar e se gastam menos tokens.
  • Como entra no VeritasInstalar o Veritas instala o Ponytail, direto do repositório do autor. As atualizações vêm de lá, sem cópia nossa no meio.
  • Quando usarEm qualquer tarefa de código. As skills do Veritas definem a stack e as proibições; o Ponytail corta o que sobra. Para revisar uma mudança, /ponytail-review; para auditar um repositório inteiro, /ponytail-audit.

O mapa do código: Graphify

O 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 GitHub
  • O que ele fazLê o código pela árvore sintática, sem gastar tokens, e monta um grafo de arquivos, funções e relações, com comunidades e um relatório. Documentos, PDFs e imagens também entram, quando você autoriza.
  • Como entra no VeritasInstalar o Veritas instala o Graphify. A skill oficial vem sem alterações, de uma versão marcada do repositório da Graphify Labs, e a skill mapa-do-codigo do Veritas orienta quando consultar o grafo e quando uma busca simples basta.
  • Quando usarPrimeiro contato com um sistema grande: /graphify . monta o grafo do código. Depois, /graphify query "o que quebra se eu mudar X?". Para uma tarefa pontual, não vale a pena: busca normal é mais rápida.

Valem em qualquer stack

Entram sozinhas quando o assunto aparece.

Texto das convenções em português

Licença MIT

É markdown. Mande um PR.

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