Código
Código que ya funciona
Rutas, estado global, cliente HTTP y un formulario de ejemplo funcionando en el primer npm run dev.
Convenciones de ingeniería, una por stack, escritas dentro del proyecto. Tu asistente de IA las lee antes de escribir código.
Un proyecto nuevo, con las convenciones dentro
npm create veritas@latest my-appO solo las skills, en Claude Code
/plugin marketplace add Caiorhcp/veritas/plugin install veritas@veritasVienen incluidos: Ponytail (menos código y menos tokens) y Graphify (el mapa del código)
Instálalo una vez. Lo demás ocurre dentro del proyecto.
Código
Rutas, estado global, cliente HTTP y un formulario de ejemplo funcionando en el primer npm run dev.
.veritas/
Una carpeta por convención, con el mismo texto del plugin, y un INDEX.md que dice cuál vale cuándo.
AGENTS.md
AGENTS.md y CLAUDE.md reciben un bloque que manda leer .veritas/INDEX.md antes de cambiar código. Codex, Cursor y Copilot leen uno; Claude Code, el otro.
init
En un repositorio que ya existe, init detecta el stack y escribe solo las convenciones. Lo que ya estaba en AGENTS.md queda intacto.
Cada una dice qué bibliotecas usar, en qué capa vive cada cosa y qué está prohibido. Una violación es un error, no una sugerencia.
En una terminal sin nadie del otro lado (CI, un agente, un script), la respuesta que falta es un error. Ningún valor por defecto se elige en silencio.
--stack vite|nextjs--skills vite,lgpd--dir apps/web--yes--no-install--lang en--stack$ 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-appnpx create-veritas new my-app --stack vite --skills vite,principios,lgpd,atomic-design --no-installVeritas dice qué usar y dónde vive cada cosa. Ponytail, de Dietrich Gebert, dice cuánto escribir: el cambio más pequeño que lo resuelve. Juntos son el par que Veritas recomienda para todo proyecto.
/plugin install ponytail@veritasPonytail es un proyecto de Dietrich Gebert, bajo licencia MIT. Todo el crédito es suyo: Veritas solo lo recomienda y facilita la instalación. @DietrichGebert
Ver Ponytail en GitHubGraphify, de Graphify Labs, convierte el código y los documentos del proyecto en un grafo que se puede consultar. Veritas lo instala junto y dice cuándo conviene usarlo: antes de tocar un proyecto grande o desconocido, y en preguntas de arquitectura o de impacto.
/graphify .Graphify es un proyecto de Graphify Labs, bajo licencia Apache-2.0. Todo el crédito es suyo: Veritas empaqueta la skill oficial sin cambios y facilita la instalación. @Graphify-Labs
Ver Graphify en GitHubskills/principios/SKILL.mdprincipios
Simple, desacoplado, agnóstico: la regla para elegir entre dos caminos.
Secciones
Entran solas cuando aparece el tema.
Texto de las convenciones en portugués
Licencia MIT
Una regla equivocada se corrige en el archivo donde vive. Una skill nueva es una carpeta copiada de docs/modelo-de-skill/, con nombre y descripción.
Abrir en GitHub