create-veritas
El paquete es create-veritas. npm create, pnpm create y bun create lo ejecutan sin instalar nada.
npm create veritas@latest my-appComandos
create-veritas new <nombre>- Crea el proyecto en ./<nombre> a partir de la plantilla del stack (vite o nextjs), que viene dentro del paquete, y escribe .veritas/, AGENTS.md y CLAUDE.md. Es lo que llama npm create veritas@latest <nombre>.
create-veritas init- En el directorio de un proyecto existente: detecta el stack por package.json, pyproject.toml, requirements.txt o manage.py, pide confirmación y escribe solo .veritas/ y un bloque en AGENTS.md y CLAUDE.md. El código no se toca.
create-veritas list- Lista las convenciones disponibles por alcance y marca con [new] las que tienen plantilla para new.
Las flags
Cada pregunta tiene una flag. En una terminal que no es interactiva (CI, script, agente), una pregunta sin respuesta es un error que dice qué flag pasar. Nunca un valor por defecto silencioso.
| Flag | Qué responde |
|---|---|
--stack <vite|nextjs> | El stack del proyecto nuevo: React + Vite + TypeScript con Tailwind, o Next.js con App Router. |
--skills a,b | Usa exactamente estas convenciones en lugar de las elegidas por el stack. Los nombres salen de create-veritas list. |
--dir <carpeta> | Dónde escribir. Con new, por defecto ./<nombre>; con init, la carpeta actual. |
--yes, -y | Confirma el init sin preguntar. |
--no-install | Escribe los archivos y se detiene, sin ejecutar install. |
--lang <pt|en> | Idioma de los mensajes de la CLI. Las convenciones quedan en portugués. |
Sin --skills
Entran la skill del stack, principios y lgpd. Si el stack es de front-end o móvil, entran atomic-design, cores, tipografia-e-espacamento, direcao-de-arte, revisao-de-design y responsividade. Con init, entra también projeto-existente, que decide entre conservar la arquitectura del proyecto o remodelarla.
El comando completo
Así se ejecuta en un CI o en manos de un agente, sin ninguna pregunta:
Lo que se escribe
| Archivo | Qué es |
|---|---|
.veritas/INDEX.md | Una línea por convención instalada, con la descripción que dice cuándo usar cada una. |
.veritas/<skill>/ | La convención: el SKILL.md y los archivos de apoyo al lado, con el mismo texto del plugin. |
.veritas/VERSION | La versión de create-veritas que escribió la carpeta. |
AGENTS.md | Un bloque entre <!-- veritas:start --> y <!-- veritas:end --> que manda leer INDEX.md antes de cambiar código. Lo leen Codex, Cursor, Copilot y otros. |
CLAUDE.md | El mismo bloque, para Claude Code. Ejecutarlo de nuevo reemplaza el bloque en vez de duplicarlo, y el resto del archivo queda como estaba. |
¿Usas Claude Code? El plugin trae las mismas skills, y también las de proceso, sin escribir nada en el proyecto. Empezar →