20+ ADRs versionados y trazables · cada commit referencia ADR cuando aplica · inmutables (no se editan retro).

Por qué documentamos cada decisión

Los compradores institucionales (CISOs, equipos de procurement, auditores) no compran caja negra. Quieren saber:

¿Por qué este componente está así diseñado?
¿Qué alternativas se consideraron?
¿Qué trade-offs se aceptaron?
¿Quién firmó esta decisión?

Los ADRs responden eso de forma trazable. Cada PR que toca arquitectura referencia el ADR que lo motivó. Cada release tiene un changelog con los ADRs nuevos.

ADRs destacados (los que un auditor leería primero)

ADRTemaPor qué importa

ADR-0001Bootstrap del Project ACTIVEPor qué hay un proyecto canónico al arrancar

ADR-0006Strategy pattern dispatch approvalsPreviene por diseño reintroducir el bug execute-then-approve

ADR-0007Audit chain SHA-256 per-tenantCumple tamper-evidence regulatorio

ADR-0008Rate limit in-memory (sin Redis)Decisión soberana single-process · trade-offs declarados

ADR-0009Roadmap institucional v2.0Define “ser el mejor agente self-hosted regulado EU” como norte

ADR-0011Política de Copyright + EU AI Act gapCompliance provider GPAI · 8 gaps mapeados con DoD

ADR-0012Política de retención (10y / 7y / tiers)Cumple EU AI Act Art. 18 + sector financiero

ADR-0013Incident response (SEV1-5)Cumple EU AI Act Art. 20 + Art. 73 + ISO 27001 A.5.24

ADR-0016Routing híbrido operativoSoberanía por default + opt-in cloud

ADR-0017Reconciliación schema DB + Heartbeat ONAlembic vuelve a ser fuente de verdad

ADR-0018Rebrand Forja → iForjaIdentidad pública del kernel

ADR-0019Stack iForja-web (Astro 5)Soberano · cero CDN externo · build estático

ADR-0020Design system (Variante D · yunque + brasa)Identidad gráfica institucional

Acceso

Los ADRs viven versionados en DECISIONS.md, source canónico del repositorio, solo-lectura en producción y con cualquier cambio sujeto a approval del operador. No están publicados en abierto hoy: los ponemos sobre la mesa en la evaluación técnica / due diligence, donde un auditor puede recorrerlos con nosotros. Es la transparencia que un comprador institucional necesita, sin exponer la hoja de ruta a la competencia.

Inmutabilidad

ADRs NO se editan retrocronológicamente. Si una decisión se invalida:

Se agrega un ADR nuevo (e.g. ADR-0050)
El ADR nuevo declara Supersede ADR-NNNN
La ADR vieja se modifica SOLO para añadir Estado: superseded por ADR-XXXX

Esto preserva la historia completa de razonamiento institucional.

Naming convention

ADRs numerados secuencialmente · cero gaps salvo re-numeración documentada (e.g. ADR-0015 saltado · documentado en ADR-0011)
Títulos cortos · imperativos · sin marketing
Fecha en formato ISO · Estado con valor canónico

ADRs · decisiones trazables

Por qué documentamos cada decisión

ADRs destacados (los que un auditor leería primero)

Acceso

Inmutabilidad

Naming convention