Saltar al contenido
Veritas
  • Nada con ese término. Prueba el nombre de una biblioteca o de un stack.

Títulos, descripciones y secciones de todas las skills.

Veritas

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-app

O solo las skills, en Claude Code

/plugin marketplace add Caiorhcp/veritas
/plugin install veritas@veritas

Vienen incluidos: Ponytail (menos código y menos tokens) y Graphify (el mapa del código)

Cómo funciona

Instálalo una vez. Lo demás ocurre dentro del proyecto.

Código

Código que ya funciona

Rutas, estado global, cliente HTTP y un formulario de ejemplo funcionando en el primer npm run dev.

.veritas/

Las reglas, en .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

Un puntero para cada asistente

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

Proyectos antiguos también

En un repositorio que ya existe, init detecta el stack y escribe solo las convenciones. Lo que ya estaba en AGENTS.md queda intacto.

Una convención por stack

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.

Ver todas las skills →
@/

React + Vite

Verificada con Vite 8.0.1 · Genera proyecto con --stack vite

Cada pantalla en src/pages/ con su ruta en AppRoutes.tsx. Una llamada a la API se vuelve un service tipado, consumido con TanStack Query.

react-router-dom · Tailwind · Zustand · Axios + TanStack Query · React Hook Form + Zod · lucide-react

'use client'

Next.js

Verificada con Next.js 16.2.4 · Genera proyecto con --stack nextjs

Server Components por defecto, 'use client' solo donde hay estado o eventos. Mutaciones con Server Actions.

App Router · Tailwind + shadcn/ui · React Hook Form + Zod · SWR / TanStack Query · Prisma / Drizzle

service

Django / DRF

Verificada con Django 5.2

View, serializer, service, model. La lógica de negocio solo en el service; el admin también delega.

DRF · Django ORM · SimpleJWT · uv

@Module

NestJS

Verificada con NestJS 11

DTOs con class-validator y las propiedades que el service necesita. Rutas protegidas por un guard JWT.

TypeORM / Prisma · class-validator · @nestjs/jwt · @nestjs/swagger

<View>

React Native

Verificada con React Native 0.86.2

Nada de div ni span. SafeAreaView, flexbox y FlatList sin funciones pesadas en el render.

React Navigation · NativeWind · Zustand · MMKV

uv

Python

Verificada con propia

Type hints en cada firma, PEP 8, Pydantic para datos estructurados y entornos con uv.

ruff · pytest · Pydantic · uv

bun test

Bun + Hono

Verificada con propia

Nueve prohibiciones, entre ellas: entrada HTTP sin Zod, errores genéricos y refresh tokens en la base de datos.

Bun · Hono · Drizzle · Zod · uuidv7 · Biome

Cada pregunta tiene una flag

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
qué generar
--skills vite,lgpd
exactamente estas convenciones
--dir apps/web
dónde escribir
--yes
confirma el init sin preguntar
--no-install
escribe los archivos y se detiene
--lang en
mensajes en inglés
Referencia completa de la CLI →
--stack
Una terminal sin nadie, en un CI
$ 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-app
npx create-veritas new my-app --stack vite --skills vite,principios,lgpd,atomic-design --no-install

Menos código, menos tokens: Ponytail

Veritas 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@veritas

Ponytail 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 GitHub
  • Qué hacePone al agente en modo dev sénior perezoso: YAGNI, biblioteca estándar primero y ninguna abstracción que nadie pidió. Queda menos código que revisar y se gastan menos tokens.
  • Cómo entra en VeritasInstalar Veritas instala Ponytail, directo del repositorio de su autor. Las actualizaciones vienen de ahí, sin copia nuestra en el medio.
  • Cuándo usarloEn cualquier tarea de código. Las skills de Veritas definen la stack y las prohibiciones; Ponytail recorta lo que sobra. Para revisar un cambio, /ponytail-review; para auditar un repositorio entero, /ponytail-audit.

El mapa del código: Graphify

Graphify, 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 GitHub
  • Qué haceLee el código por su árbol sintáctico, sin gastar tokens, y arma un grafo de archivos, funciones y relaciones, con comunidades y un informe. Documentos, PDFs e imágenes también entran, cuando lo autorizas.
  • Cómo entra en VeritasInstalar Veritas instala Graphify. La skill oficial viene sin cambios, de una versión etiquetada del repositorio de Graphify Labs, y la skill mapa-do-codigo de Veritas orienta cuándo consultar el grafo y cuándo basta una búsqueda simple.
  • Cuándo usarloPrimer contacto con un sistema grande: /graphify . arma el grafo del código. Después, /graphify query "¿qué se rompe si cambio X?". Para una tarea puntual no vale la pena: una búsqueda normal es más rápida.

Valen en cualquier stack

Entran solas cuando aparece el tema.

Texto de las convenciones en portugués

Licencia MIT

Es markdown. Manda un PR.

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