Convenciones transversales del Universo

Código

TypeScript estricto. Sin any salvo justificación documentada.
Clean Architecture / DDD cuando el dominio lo justifique.
Commits: Conventional Commits (feat:, fix:, refactor:, docs:, chore:).

Documentación (CFD)

docs/adr/NNNN-titulo.md por decisión arquitectónica.
CLAUDE.md por mundo hereda del global con @../../CLAUDE.md.
COWORK.md por mundo = briefing para Claude Cowork.
docs/design-system.md por mundo = tokens para Claude Design.

Supabase (si el mundo usa Supabase)

No todo mundo usa Supabase — depende del stack elegido (ej. ShipFree usa Drizzle + Better-Auth).
RLS siempre en tablas con datos de usuario.
Migraciones versionadas en supabase/migrations/.
Secrets fuera del repo.

Contratos de API (mundos front/backend)

Un par (o N:M) de mundos front/backend comparte contrato via _shared/contracts/<producto>/api-contract.yaml.
El backend es la única fuente de verdad — ese archivo es siempre un symlink al artefacto real del mundo backend, nunca una copia.
Registrar el par en _shared/contracts/registry.json; sin entrada ahí, el hook de drift-check no hace nada.
Ver _shared/contracts/README.md para el procedimiento completo y ADR-G017.

Idioma

Interno/casual: español. Código/comentarios públicos: inglés.

TASKS.md — marca de paralelizable

Toda tarea nueva en cualquier TASKS.md lleva marca [P] o [S] junto al tag de módulo.
[P] = paralelizable: no toca los mismos archivos ni depende de otra tarea pending/doing. Segura para lanzar en subagente/mundo distinto al mismo tiempo que otras [P].
[S] = secuencial: toca archivos compartidos con otra tarea activa, o depende de que otra termine antes.
Formato: - [ ] [P] [modulo][id] **Título** — descripción. (fecha).
Al mover una tarea a ## done, conservar la marca [P]/[S] en la entrada final.

Auto-memory (Claude Code)

Auto-memory es para hallazgos operativos (comandos descubiertos, gotchas, correcciones puntuales). Decisiones de arquitectura van SIEMPRE a docs/adr/, nunca solo a memory. Convenciones de código van SIEMPRE a CONVENTIONS.md, nunca solo a memory. Si detectas conflicto entre un memory file y CLAUDE.md/CONVENTIONS.md/ADR, el documento escrito manda.