create-veritas
O pacote é create-veritas. npm create, pnpm create e bun create o rodam sem instalar nada.
npm create veritas@latest my-appComandos
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.
| Flag | O que ela responde |
|---|---|
--stack <vite|nextjs> | A stack do projeto novo: React + Vite + TypeScript com Tailwind, ou Next.js com App Router. |
--skills a,b | Usa 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, -y | Confirma o init sem perguntar. |
--no-install | Escreve 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:
O que é escrito
| Arquivo | O que é |
|---|---|
.veritas/INDEX.md | Uma 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/VERSION | A versão do create-veritas que escreveu a pasta. |
AGENTS.md | Um 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.md | O 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 →