Code
Code that already runs
Routes, global state, an HTTP client and a sample form, all working on the first npm run dev.
Engineering conventions, one per stack, written inside the project. Your AI assistant reads them before it writes code.
A new project, conventions included
npm create veritas@latest my-appOr just the skills, in Claude Code
/plugin marketplace add Caiorhcp/veritas/plugin install veritas@veritasIncluded: Ponytail (less code, fewer tokens) and Graphify (a map of your code)
Install once. Everything else happens inside the project.
Code
Routes, global state, an HTTP client and a sample form, all working on the first npm run dev.
.veritas/
One folder per convention, with the same text as the plugin, and an INDEX.md that says which one applies when.
AGENTS.md
AGENTS.md and CLAUDE.md get a block telling the assistant to read .veritas/INDEX.md before changing code. Codex, Cursor and Copilot read one; Claude Code, the other.
init
In a repository that already exists, init detects the stack and writes only the conventions. What was already in AGENTS.md stays intact.
Each one says which libraries to use, which layer everything lives in and what is forbidden. A violation is an error, not a suggestion.
In a terminal with nobody on the other side (CI, an agent, a script), a missing answer is an error. No default is picked in silence.
--stack vite|nextjs--skills vite,lgpd--dir apps/web--yes--no-install--lang en--stack$ npx create-veritas new my-app --lang en < /dev/nullMissing answer and the terminal is not interactive. Pass --stack <vite|nextjs>.$ echo $?1$ npx create-veritas new my-app --stack vite --no-install --lang en✓ Done: my-appnpx create-veritas new my-app --stack vite --skills vite,principios,lgpd,atomic-design --no-installVeritas says what to use and where everything lives. Ponytail, by Dietrich Gebert, says how much to write: the smallest change that solves it. Together they are the pair Veritas recommends for every project.
/plugin install ponytail@veritasPonytail is a project by Dietrich Gebert, under the MIT license. All credit is his: Veritas only recommends it and makes it easy to install. @DietrichGebert
See Ponytail on GitHubGraphify, by Graphify Labs, turns a project's code and documents into a graph you can query. Veritas installs it alongside and says when it's worth it: before changing a large or unfamiliar project, and for architecture or impact questions.
/graphify .Graphify is a project by Graphify Labs, under the Apache-2.0 license. All credit is theirs: Veritas packages the official skill unchanged and makes it easy to install. @Graphify-Labs
See Graphify on GitHubskills/principios/SKILL.mdprincipios
Simple, decoupled, agnostic: the rule for choosing between two paths.
Sections
They load on their own when the topic comes up.
Convention text in Portuguese
MIT licence
A wrong rule is fixed in the file where it lives. A new skill is a folder copied from docs/modelo-de-skill/, with a name and a description.
Open on GitHub