Gestiona Architecture Decision Records (ADR) en `bodega-san-martin/docs/adr/`. Implementa el comando `/adr [título]`: crea ADR-XXX.md con estructura Contexto / Decisión / Consecuencias / Alternativas / Referencias. Auto-numera el siguiente ADR libre. Usar SIEMPRE que un cambio impacte arquitectura, contratos públicos, schema DB, o seguridad.
Regla CLAUDE.md #12: "Cualquier cambio de arquitectura requiere ADR nuevo en docs/adr/."
| Cambio | ADR? |
|---|---|
| Nuevo/cambio modelo Prisma o relación | Si |
| Nuevo endpoint público o cambio de contrato API | Si |
Cambio en RBAC (role-permissions.ts) | Si |
| Cambio en flujo de pago (CheckoutModal/orders.db) | Si |
| Nuevo MCP / plugin / integración externa | Si |
| Cambio de estrategia de caché o ISR | Si |
| Cambio en estructura multi-tenant | Si |
| Refactor grande (>=10 archivos, >=300 LOC) |
| Si |
| Bugfix puntual sin cambio de diseño | No |
| Cambio de copy o UI cosmético | No |
bodega-san-martin/docs/adr/*.md^(\d{3})-max + 1, padding a 3 dígitosdocs/adr/{NNN}-{slug}.md# ADR-{NNN} — {Título}
**Status:** Accepted | Proposed | Deprecated | Superseded by ADR-{XXX}
**Fecha:** YYYY-MM-DD
**Autor:** Brandon (Buleje) + Claude Code
## 1. Contexto
[Estado antes + restricciones + problemas. 2-4 párrafos.]
## 2. Decisión
[Qué decidimos + archivos/módulos impactados. 1-2 párrafos.]
## 3. Consecuencias
### Positivas / ### Negativas / ### Migraciones requeridas
## 4. Alternativas evaluadas
| Opción | Pros | Contras | Por qué descartada |
## 5. Verificación
- [ ] Tests actualizados
- [ ] Docs actualizadas
- [ ] Memoria actualizada
- [ ] Rollback plan documentado
## 6. Referencias
- ADRs relacionados, Issues/PRs, links externos, memorias
Superseded y crear nuevoProposeddocs/adr/INDEX.md si existeADR creado: docs/adr/{NNN}-{slug}.md | Status: Proposed
Próximos: llenar secciones → Accepted → commit: docs(adr): add ADR-{NNN}