create-veritas
The package is create-veritas. npm create, pnpm create and bun create run it without installing anything.
npm create veritas@latest my-appCommands
create-veritas new <name>- Creates the project in ./<name> from the stack template (vite or nextjs), which ships inside the package, and writes .veritas/, AGENTS.md and CLAUDE.md. This is what npm create veritas@latest <name> calls.
create-veritas init- In the directory of an existing project: detects the stack from package.json, pyproject.toml, requirements.txt or manage.py, asks for confirmation and writes only .veritas/ plus a block in AGENTS.md and CLAUDE.md. The code is not touched.
create-veritas list- Lists the available conventions by scope and marks with [new] the ones that have a template for new.
The flags
Every question has a flag. In a terminal that is not interactive (CI, a script, an agent), a question without an answer is an error that names the flag to pass. Never a silent default.
| Flag | What it answers |
|---|---|
--stack <vite|nextjs> | The stack of the new project: React + Vite + TypeScript with Tailwind, or Next.js with the App Router. |
--skills a,b | Uses exactly these conventions instead of the ones picked by the stack. Names come from create-veritas list. |
--dir <folder> | Where to write. With new, the default is ./<name>; with init, the current folder. |
--yes, -y | Confirms init without asking. |
--no-install | Writes the files and stops, without running install. |
--lang <pt|en> | Language of the CLI messages. The conventions stay in Portuguese. |
Without --skills
You get the stack's skill, principios and lgpd. If the stack is front end or mobile, atomic-design, cores, tipografia-e-espacamento, direcao-de-arte, revisao-de-design and responsividade come too. With init, projeto-existente is added, which decides between keeping the project's architecture or remodelling it.
The whole command
This way it runs in CI or in the hands of an agent, without a single question:
What gets written
| File | What it is |
|---|---|
.veritas/INDEX.md | One line per installed convention, with the description that says when to use each. |
.veritas/<skill>/ | The convention: the SKILL.md and the supporting files beside it, with the same text as the plugin. |
.veritas/VERSION | The version of create-veritas that wrote the folder. |
AGENTS.md | A block between <!-- veritas:start --> and <!-- veritas:end --> telling the assistant to read INDEX.md before changing code. Read by Codex, Cursor, Copilot and others. |
CLAUDE.md | The same block, for Claude Code. Running again replaces the block instead of duplicating it, and the rest of the file stays as it was. |
On Claude Code? The plugin brings the same skills, plus the process ones, without writing anything into the project. Get started →