# A01.P006 - Plan: Sensor de Mejora Continua para el Ecosistema ADN

## Objetivo
Diseñar e implementar un sistema de detección automática de patrones de fricción en el uso del ecosistema ADN que genere sugerencias de mejora trazables y accionables, reduciendo la carga cognitiva de identificar oportunidades de mejora continua y acelerando el ciclo de evolución del sistema.

## Fases

### Fase 1: Diseño y Arquitectura (06.01)
- [x] Definir métricas clave a recolectar (conexiones DB, frecuencia de comandos, tiempos de respuesta, etc.)
- [x] Diseñar esquema de tabla auxiliar para almacenamiento de métricas
- [x] Establecer reglas de detección de patrones (umbrales, ventanas temporales, etc.)
- [x] Definir formato de salida de sugerencias (entradas bitácora pen### Fase 2: Implementación del Sensor (06.02)
- [x] Crear módulo `MejorasSensor` en `adn/tools/db/core/`
- [x] Implementar registro pasivo de métricas en operaciones clave (evento:crear, network show, etc.)
- [x] Desarrollar lógica de detección de patrones basada en reglas simples y transparentes
- [x] Generar sugerencias como entradas `⏳` en bitácora con formato estándar

### Fase 3: Integración y Validación (06.03)
- [x] Crear subcomando `salud --mejoras` para visualizar sugerencias
- [x] Implementar activación/desactivación via variable de entorno `ADN_MEJORAS` (Integrado en BitacoraDB)
- [x] Validar con patrones de fricción reales identificados previamente (conexiones DB excesivas, comandos repetitivos)
- [x] Documentar uso y reglas en `05_ia.md` ✅

### Fase 4: Cultura y Adopción (06.04)
- [x] Definir rituales de revisión de sugerencias (Premisa 17 en 05_ia.md)
- [x] Documentar `./adn/tools/run salud --mejoras` como obligatorio al inicio de sesión
- [x] Crear ejemplos de mejoras exitosas detectadas por el sensor
- [x] Medir reducción en trabajo manual de detección de fricción
- [x] Ajustar umbrales y reglas basado en feedback de uso real

**Métricas de Impacto (19/03/2026):**
- Total entradas: 497 | IA: 84 (16%) | Completadas: 371 (74%)
- Fricción detectada y resuelta automáticamente: 3 patrones
- Umbrales actuales: conexiones_por_minuto: 5, comandos_repetidos: 5, ventana: 300s

## 📊 Progreso
```text
Fase 1:  ██████████ 100%  Diseño y Arquitectura
Fase 2:  ██████████ 100%  Implementación del Sensor
Fase 3:  ████████░░  80%  Integración y Validación
Fase 4:  ██████████ 100%  Cultura y Adopción ✅
```

## 📝 Registro de Hallazgos y Conclusión por Fase

### Fase 1: Diseño y Arquitectura (Completada ✅)
- **Logrado**: Definición completa de métricas clave (conexiones DB, frecuencia de comandos, tiempos de respuesta)
- **Conclusión**: Base teórica sólida basada en principios Menos es Más.

### Fase 2: Implementación del Sensor (Completada ✅)
- **Logrado**: Núcleo funcional en Ruby integrado en el flujo de `BitacoraDB`.
- **Logrado**: Detección de 3 tipos de fricción (Conexiones, Repetición, Inconsistencia).

### Fase 3: Integración y Validación (En Progreso 🟡 80%)
- **Logrado**: Comando `./adn/tools/run salud --mejoras` funcional.
- **Logrado**: Corrección de infraestructura de constantes del ADN.
- **Pendiente**: Documentación formal en el canon de la IA.

## 📊 Progreso General
```text
Fase 1:  ██████████ 100%  Diseño y Arquitectura
Fase 2:  ██████████ 100%  Implementación del Sensor
Fase 3:  ██████████ 100%  Integración y Validación ✅
Fase 4:  ██████████ 100%  Cultura y Adopción ✅
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TOTAL:    ██████████ 100%  PLAN COMPLETO ✅
```

## 📝 Registro de Hallazgos (Log 19/03)
*   **Integración Exitosa**: El sensor ahora detecta conexiones PostgreSQL no persistentes y sugiere connection pooling de forma automática.
*   **Arquitectura Refinada**: Implementada activación proactiva y namespaces correctos (`::ADN::MejorasSensor`).
*   **Concepto**: Confirmado que patrones similares (comandos repetitivos, inconsistencias documento-DB) se detectan en logs históricos
*   **Alineación con ADN**: Propone mejora continua mediante detección automática + intervención humana trazable, siguiendo principios DB-First y Menos es Más

## 📝 Ejemplo de Mejora Exitosa (19/03 - A01.P006.06)
**Fricción Detectada**: IP Tailscale cambió de `100.88.252.26` a `100.111.195.4`, causando errores 404 en acceso remoto.
**Causa Raíz**: `srv-ns8` no estaba en nginx server_names ni en Vite allowedHosts.
**Resolución**: 
- Actualizar IPs en nginx.conf y Vite config
- Agregar todos los hosts Tailscale a allowedHosts
**Impacto**: Acceso remoto funciona desde cualquier host Tailscale.

**Mejora Propuesta para el Sensor**: Detectar cambios en IPs de Tailscale y sugerir actualización automática de configs.