Preparado para IA

Este boilerplate está pensado para que humanos y agentes trabajen sobre las mismas reglas.

La fuente de verdad para cualquier agente (Cursor, Claude, Gemini, Codex, etc.) en el proyecto generado es:

AGENTS.md (incluido en template/base/)

Pieza	Rol
AGENTS.md	Arquitectura, naming, errores de dominio, estrategia de tests, límites
Reglas de Cursor (commits/PR)	Formato obligatorio de mensajes y descripciones de PR
Capas hexagonales	Menos ambigüedad sobre “dónde va este código”
Scripts de calidad	lint, format, typecheck, test / test:e2e como red de seguridad
Hooks Git	El agente (o tú) no puede colar formato o commits rotos tan fácil
Módulo ejemplo	Plantilla viva (health-check) para copiar el patrón
Skills en .agents/skills/	NestJS, Node, TypeScript, Vitest — helpers; AGENTS.md gana si hay conflicto

Tip: pide al agente que lea AGENTS.md antes de generar código. Se recomienda el plugin Serena para trabajar con agentes sobre el repo generado (hay .serena/ en el template).

Contrato corto para agentes

1. domain debe ser puro — sin Nest, ORM, HTTP ni drivers.
2. Preferir extender el patrón de health-check / shared a inventar carpetas nuevas.
3. Errores de negocio → DomainError + código en DomainErrorCode (no HttpException en domain/application).
4. Eventos → puerto EventBus + token; handlers con @OnEvent solo en infrastructure.
5. Commits: tag: descripción en inglés y minúsculas.