Calidad y convenciones

Separación de responsabilidades

Herramienta	Responsabilidad
Prettier	Solo formato
ESLint	Solo calidad / correctness
eslint-config-prettier	Evita que ESLint pelee con Prettier

Commits (obligatorio)

tag: breve descripción en inglés y minúsculas

Tags permitidos: feat · fix · chore · refactor · test · docs

# ✅
feat: add health check module

# ❌
Feature: Add Health Check
feat: add health check.

Validado automáticamente por Commitlint en el hook commit-msg. En pre-commit, lint-staged aplica ESLint + Prettier solo a lo staged.

Pull requests

La descripción de PR debe empezar con ### Changelog, un párrafo introductorio y secciones con viñetas que:

1. Empiecen con un verbo (Added, Updated, …)
2. Describan el cambio con claridad
3. Incluyan la ruta completa del archivo entre paréntesis

Estructura del proyecto generado

.
├── src/                    # código de aplicación
├── test/                   # e2e specs
├── .husky/                 # git hooks
├── .vscode/                # settings Vitest para el IDE
├── .agents/                # skills para agentes
├── AGENTS.md               # contrato para IA
├── commitlint.config.mjs
├── eslint.config.mjs
├── vitest.config.ts        # unit tests
├── vitest.e2e.config.ts    # e2e tests
├── package.json
└── tsconfig.json