# _MAP: Architecture Decision Records (ADRs)

**Carpeta:** docs/97-adr/
**Proposito:** Documentar decisiones arquitectonicas importantes del proyecto
**Estado:** Actualizado
**Ultima actualizacion:** 2026-01-10

---

## Resumen

| Metrica | Valor |
|---------|-------|
| Total ADRs | 3 |
| Aceptados | 3 |
| Propuestos | 0 |
| Deprecated | 0 |

---

## Contenido

### ADRs Activos

| ID | Titulo | Estado | Fecha | Impacto |
|----|--------|--------|-------|---------|
| [ADR-0001](./ADR-0001-multi-tenant-architecture.md) | Arquitectura Multi-Tenant | Accepted | 2026-01-06 | Alto |
| [ADR-0002](./ADR-0002-whatsapp-first-approach.md) | WhatsApp como Canal Principal | Accepted | 2026-01-06 | Alto |
| [ADR-0003](./ADR-0003-llm-agnostic-strategy.md) | Estrategia LLM Agnostica | Accepted | 2026-01-06 | Medio |

---

## Navegacion por Dominio

### Arquitectura
- [ADR-0001 - Multi-Tenant](./ADR-0001-multi-tenant-architecture.md)

### Producto
- [ADR-0002 - WhatsApp First](./ADR-0002-whatsapp-first-approach.md)

### Tecnologia
- [ADR-0003 - LLM Agnostico](./ADR-0003-llm-agnostic-strategy.md)

---

## Formato de ADR

Cada ADR sigue la estructura de @SIMCO-ESTRUCTURA-DOCS:

```markdown
# ADR-{NNNN}: {Titulo}

## Metadata
- ID, Estado, Fecha, Supersede (si aplica)

## Contexto
{Problema que requiere decision}

## Decision
{La decision tomada}

## Alternativas Consideradas
{Opciones evaluadas con pros/cons}

## Consecuencias
{Positivas, negativas, neutrales}

## Referencias
{Links relacionados}
```

---

## Proceso de ADR

```
┌─────────────┐     ┌───────────────┐     ┌──────────────┐
│  Propuesto  │ --> │  En Revision  │ --> │   Aceptado   │
└─────────────┘     └───────────────┘     └──────────────┘
                                                │
                                                v
                                          ┌──────────────┐
                                          │  Deprecated  │
                                          │ (superseded) │
                                          └──────────────┘
```

---

## Cuando Crear un ADR

Crear un ADR cuando:

1. **Decision arquitectonica significativa** - Afecta multiples componentes
2. **Eleccion entre alternativas** - Hay opciones razonables a considerar
3. **Dificil de revertir** - El costo de cambiar es alto
4. **Requiere documentacion** - Otros deben entender el "por que"

---

## Referencias

- [SIMCO-ESTRUCTURA-DOCS.md](../../../../orchestration/directivas/simco/SIMCO-ESTRUCTURA-DOCS.md)
- [Template ADR](https://adr.github.io/)

---

**Mantenido por:** Architecture Team
**Version:** 1.0.0