Decisiones (ADRs)
Las decisiones más importantes de la plataforma se registran como ADRs en el directorio
knowledge/decisions/adrs/ del repositorio. Esta página es el índice; cada ADR es el "porqué"
durable detrás de una pieza de la arquitectura.
| ADR | Decisión | Estado | Páginas |
|---|---|---|---|
| ADR-001 | Stack backend: Fastify + Drizzle + Postgres | canónico | api |
| ADR-002 | Layout del repo: monorepo pnpm workspace (Turborepo) | canónico | Mapa de la plataforma |
| ADR-003 | Estado frontend: Zustand + TanStack Query | canónico | admin |
| ADR-004 | Los planes se vuelven un motor de grafo en BD (editable + accionable) — supera los planes MDX basados en archivos | aceptado | Plan Engine |
| ADR-005 | Tareas en el grafo; los issues de GitHub se mantienen sincronizados (eliminación diferida) | aceptado | Plan Engine |
| ADR-006 | El flujo de esfuerzo es el motor de trazas de entrenamiento; GitHub es SoT; planes MDX retirados | canónico | Modelo de esfuerzo |
| ADR-007 | Datos / memoria / asistente por cliente — 4 capas; esquema-por-cliente + pgvector | canónico | Datos, memoria y asistente |
Cómo se conectan los ADRs recientes
- ADR-004 → ADR-005 → ADR-006 es una línea sobre nuestro flujo de trabajo. Los planes pasaron de archivos a un grafo (004), las tareas siguieron (005), y el modelo de esfuerzo hizo ese flujo doblemente útil — además es un corpus de trazas de entrenamiento para un futuro modelo constructor, con GitHub como fuente de verdad operativa (006). Ver Plan Engine y Modelo de esfuerzo.
- ADR-006 → ADR-007 traza la frontera producto/flujo de trabajo en la capa de datos: los datos de tenant/cliente (las cuatro capas de ADR-007) viven en una base de datos separada del grafo del flujo de trabajo y nunca entran al corpus de entrenamiento. Ver SoR del producto y Datos, memoria y asistente.
Leer los ADRs
Los ADRs mismos viven en el repositorio (knowledge/decisions/adrs/), cada uno con frontmatter
status / owner / updated y una estructura Contexto → Decisión → Consecuencias. El log de
decisiones en curso (knowledge/decisions/log.md) es el desempate cuando dos documentos entran en
conflicto: la última decisión gana.