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.

create-veritas

O pacote é create-veritas. npm create, pnpm create e bun create o rodam sem instalar nada.

npm create veritas@latest my-app

Comandos

create-veritas new <nome>
Cria o projeto em ./<nome> a partir do template da stack (vite ou nextjs), que já vem no pacote, e escreve .veritas/, AGENTS.md e CLAUDE.md. É o que npm create veritas@latest <nome> chama.
create-veritas init
No diretório de um projeto que existe: detecta a stack pelo package.json, pyproject.toml, requirements.txt ou manage.py, pede confirmação e escreve só .veritas/ e um bloco no AGENTS.md e no CLAUDE.md. O código não é tocado.
create-veritas list
Lista as convenções disponíveis por escopo e marca com [new] as que têm template para new.

As flags

Toda pergunta tem uma flag. Num terminal que não é interativo (CI, script, agente), pergunta sem resposta é erro que diz qual flag passar. Nunca um padrão silencioso.

FlagO que ela responde
--stack <vite|nextjs>A stack do projeto novo: React + Vite + TypeScript com Tailwind, ou Next.js com App Router.
--skills a,bUsa exatamente estas convenções, no lugar das escolhidas pela stack. Os nomes vêm de create-veritas list.
--dir <pasta>Onde escrever. No new, o padrão é ./<nome>; no init, a pasta atual.
--yes, -yConfirma o init sem perguntar.
--no-installEscreve os arquivos e para, sem rodar o install.
--lang <pt|en>Idioma das mensagens da CLI. As convenções ficam em português.

Sem --skills

Entram a skill da stack, principios e lgpd. Se a stack é de front-end ou mobile, entram atomic-design, cores, tipografia-e-espacamento, direcao-de-arte, revisao-de-design e responsividade. No init, entra também projeto-existente, que decide entre conservar a arquitetura do projeto ou remodelá-la.

O comando inteiro

Assim ele roda num CI ou nas mãos de um agente, sem nenhuma pergunta:

npx create-veritas new my-app --stack nextjs --skills nextjs,principios,lgpd,atomic-design --dir apps/web --no-install
npx create-veritas init --yes

O que é escrito

ArquivoO que é
.veritas/INDEX.mdUma linha por convenção instalada, com a descrição que diz quando usar cada uma.
.veritas/<skill>/A convenção: o SKILL.md e os arquivos de apoio ao lado, com o mesmo texto do plugin.
.veritas/VERSIONA versão do create-veritas que escreveu a pasta.
AGENTS.mdUm bloco entre <!-- veritas:start --> e <!-- veritas:end --> que manda ler o INDEX.md antes de mudar código. Lido por Codex, Cursor, Copilot e outros.
CLAUDE.mdO mesmo bloco, para o Claude Code. Rodar de novo troca o bloco, não duplica, e o resto do arquivo fica como estava.

Usa o Claude Code? O plugin traz as mesmas skills, e também as de processo, sem escrever nada no projeto. Começar →