83 lines
4.9 KiB
Markdown
83 lines
4.9 KiB
Markdown
# P2604.06 - 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 - P2604.06.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. |