Files

T

Ricardo Monla 78006032eb Refactor(ADN): Migración de tools/adn a adn/tools en busca de la Armonía Integral del DIIAA

2026-03-10 22:25:01 -03:00

11 KiB

Raw Blame History

Sugerencias de Mejoras para el Plan de ADN: Orientación hacia Automatización Ruby y Reducción de Dependencia de IA

Fecha: 07/03/2026 - 14:30
Estado: 📍 Definido
Relacionado: P2603 (Sistema de Bitácoras), Plan: 260307-1400_Plan_Mejoras_ADN.md

🎯 Objetivo de este Documento

Este documento complementa y crítica constructivamente el plan 260307-1400_Plan_Mejoras_ADN.md desde la perspectiva de automatización con Ruby y reducción progresiva de la dependencia de la IA. El objetivo final es evolucionar hacia un sistema donde:

Ruby sea el motor principal de todas las automatizaciones operativas.
La IA sea un asistente opcional, no una dependencia crítica.
Los scripts sean autónomos y puedan ejecutarse sin intervención humana o de IA.
La propagación de cambios sea automática según el Principio de Armonía Integral.

🔍 Análisis Crítico del Plan Actual

✅ Fortalezas

Identifica correctamente las áreas de automatización necesaria.
Propone herramientas Ruby específicas (adn-validador.rb, bitacora-triggers.rb).
Respeta los principios del ADN (idioma español, nomenclatura).

⚠️ Debilidades (desde perspectiva automatización)

Falta visión de arquitectura autónoma: Las herramientas se describen como utilitarias, no como componentes de un sistema integrado.
Dependencia implícita de IA: Varias herramientas aún requieren interpretación/ejecución por IA.
Ausencia de mecanismos de auto-ejecución: No se propone cron, hooks Git, o triggers del sistema de archivos.
No aborda la reducción de la hebra 05_ia.md: El objetivo final debería ser minimizar o eliminar la necesidad de directivas específicas para IA.

🧭 Principios Rectores para Automatización Ruby

1. Autonomía por Diseño

Cada script Ruby debe poder ejecutarse sin interpretación previa de IA. Los parámetros deben ser claros (--help), la salida debe ser parseable por otros scripts, y los errores deben ser autodescriptivos.

2. Propagación Automática (Armonía Integral)

Las herramientas deben implementar triggers en tiempo real:

Observadores de sistema de archivos (listen gem) para detectar cambios.
Hooks Git pre-commit para validación automática.
Integración con cron para tareas periódicas.

3. Reducción Progresiva de `05_ia.md`

Cada nueva herramienta debe eliminar una dependencia de la IA:

Auto-contextualización → adn-contexto.rb
Validación de formato → adn-validador.rb
Generación de contenido → generar-*.rb
Registro de acciones → bitacora-auto.rb

4. API de Comandos Unificada

Todas las herramientas deben compartir interfaz común:

ruby adn/tools.rb <subcomando> [opciones]  # Ej: adn.rb validador, adn.rb contexto, adn.rb trigger

🚀 Mejoras Específicas por Herramienta/Proyecto

🥇 Prioridad Alta: Re-diseño para Autonomía

1. `adn/tools-validador.rb` → `adn/tools/validador.rb`

Mejora: Convertir en daemon con observador de sistema de archivos.
Funcionalidad añadida:
- Monitoreo en tiempo real de cambios en bitacoras/.
- Notificaciones desktop (libnotify) o email cuando detecte errores.
- Integración con pre-commit hook que rechace commits con errores de ADN.
Reducción IA: Elimina necesidad de que IA verifique manualmente el formato.

2. `tools/bitacora-triggers.rb` → `adn/tools/triggers.rb`

Mejora: Sistema de eventos y suscriptores basado en reglas YAML.
Funcionalidad añadida:
- Archivo adn/triggers.yml con reglas definidas por operador.
- Ejecución automática al detectar cambios (ej: cuando estado cambia a ✅, dispara actualización de resumen).
- Log de triggers ejecutados en logs/triggers.log.
Reducción IA: Implementa automáticamente los triggers que hoy ejecuta manualmente la IA.

3. `adn/tools-contexto.rb` → `adn/tools/contexto.rb`

Mejora: Motor de inferencia topológica autónomo.
Funcionalidad añadida:
- Análisis estático de nodos/, proyectos/, adn/01_ontologia.md.
- Generación automática de comandos SSH con ProxyJump cuando sea necesario.
- Cache de contexto en tmp/contexto-cache.json para performance.
Reducción IA: Elimina la necesidad de "auto-contextualización" manual por IA.

🥈 Prioridad Media: Sistema Integrado

4. `adn/tools.rb` - CLI Unificada

Mejora: Comando único con subcomandos para todas las operaciones ADN.

Estructura propuesta:

ruby adn/tools.rb validador [--watch] [--fix]
ruby adn/tools.rb triggers [--test] [--force]
ruby adn/tools.rb contexto <nodo> [--cmd]
ruby adn/tools.rb evolucion <propuesta.md> [--aprobar]
ruby adn/tools.rb salud [--dashboard] [--json]

Beneficio: Interfaz consistente, fácil de recordar, documentar y usar.

5. Sistema de Eventos `adn/tools/eventos.rb`

Mejora: Bus de eventos interno para comunicación entre módulos.
Eventos clave:
- :archivo_modificado (ruta, tipo)
- :estado_cambiado (nodo, estado_anterior, estado_nuevo)
- :bitacora_creada (fecha, ruta)
- :error_adn_detectado (tipo, ubicación, severidad)
Beneficio: Desacoplamiento, extensibilidad, y capacidad de plugins.

6. Dashboard Autónomo `adn/tools/dashboard.rb`

Mejora: Servidor web Ruby (Sinatra) que muestre salud del ADN.
Funcionalidad:
- Panel en tiempo real (WebSockets) de validaciones.
- Gráficos de métricas extraídas automáticamente.
- API JSON para integración con dashboard principal.
Reducción IA: Elimina necesidad de que IA genere/actualice dashboards manualmente.

🥉 Prioridad Baja: Madurez y Resiliencia

7. `adn/tools/backup.rb` con Versionado Semántico

Mejora: Backup con versionado semántico del ADN.
Funcionalidad:
- Versiones: adn-1.2.3.tar.gz (major.features.fixes).
- Diff entre versiones con resumen de cambios.
- Integración con dtic-BKPs para almacenamiento cifrado.
Beneficio: Capacidad de rollback y auditoría histórica.

8. `adn/tools/aprendizaje.rb` - Sistema de Recomendaciones

Mejora: Machine learning simple para sugerir mejoras al ADN.
Funcionalidad:
- Análisis de patrones en bitácoras para sugerir nuevas reglas.
- Detección de inconsistencias recurrentes.
- Sugerencias de evolución basadas en data histórica.
Reducción IA: Sistema proactivo en lugar de reactivo (IA como asistente).

📅 Hoja de Ruta Revisada (8 semanas)

Fase 1: Núcleo Autónomo (Semanas 1-2)

adn/tools/ - Estructura de directorios y gemas base.
adn/tools.rb - CLI unificada con subcomandos básicos.
adn/tools/validador.rb - Validador en tiempo real con hooks Git.
Entregable: Sistema que valida automáticamente cada commit.

Fase 2: Automatización Inteligente (Semanas 3-4)

adn/tools/triggers.rb - Sistema de eventos basado en YAML.
adn/tools/contexto.rb - Motor de inferencia topológica.
Integración con cron (tareas periódicas de validación).
Entregable: Triggers automáticos operativos sin intervención IA.

Fase 3: Sistema Integrado (Semanas 5-6)

adn/tools/eventos.rb - Bus de eventos interno.
adn/tools/dashboard.rb - Servidor web de monitoreo.
API JSON para integración con dashboard principal.
Entregable: Dashboard autónomo en tiempo real.

Fase 4: Madurez y Evolución (Semanas 7-8)

adn/tools/backup.rb - Sistema de versionado semántico.
adn/tools/aprendizaje.rb - Recomendaciones automáticas.
Documentación completa y onboarding.
Entregable: Sistema maduro con capacidad de auto-evolución.

📊 KPIs de Reducción de Dependencia de IA

KPI	Línea Base	Meta (8 semanas)	Cómo Medir
Acciones IA en bitácoras/día	5-10	< 2	Conteo de "(IA)" en bitácoras
Porcentaje de triggers automáticos	0%	90%	Triggers ejecutados automáticamente vs manualmente
Tiempo de auto-contextualización	2-3 min	< 30 seg	`time ruby adn/tools.rb contexto <nodo>`
Errores detectados por humano	70%	< 30%	Origen de detección de errores de ADN
Uso de `05_ia.md` como referencia	Diario	Semanal	Frecuencia de consulta a la hebra
Scripts ejecutados sin interpretación IA	40%	85%	Comandos ejecutados directamente vs via IA

🔄 Proceso de Transición

Semanas 1-4: Coexistencia

IA y scripts Ruby trabajan en paralelo.
IA documenta cada acción que posteriormente será automatizada.
Se establecen métricas de línea base.

Semanas 5-6: Transferencia

IA ejecuta scripts Ruby en lugar de acciones directas.
Se validan resultados comparando con ejecuciones previas.
Se ajustan scripts basados en feedback.

Semanas 7-8: Autonomía

Scripts se ejecutan automáticamente via cron/hooks.
IA solo interviene en casos excepcionales no cubiertos.
Se documenta el nuevo flujo de trabajo autónomo.

🧠 Consideraciones Arquitectónicas

1. Gemfile y Dependencias

Crear adn/tools/Gemfile con:

listen para observación de archivos.
sinatra para dashboard web.
toml o yaml para configuración.
rugged para interacción Git programática.

2. Configuración en `adn/config.yml`

# Configuración centralizada del sistema ADN
rutas:
  bitacoras: "../bitacoras"
  nodos: "../nodos"
  proyectos: "../proyectos"
  
triggers:
  enabled: true
  config_file: "triggers.yml"
  
validador:
  watch_mode: true
  strict_mode: false
  
dashboard:
  port: 4567
  auto_open: true

3. Logging Estructurado

Todos los scripts usan adn/tools/logger.rb común.
Logs en logs/adn/ con rotación diaria.
Formato JSON para fácil parsing y análisis.

4. Pruebas Automatizadas

spec/adn_validador_spec.rb - pruebas unitarias.
spec/adn_triggers_spec.rb - pruebas de integración.
Ejecución automática con GitHub Actions.

🚦 Próximos Pasos Inmediatos (Revisión del Plan)

[ ] Revisar estas sugerencias en la próxima bitácora diaria.
[ ] Actualizar 260307-1400_Plan_Mejoras_ADN.md con:
- Arquitectura de directorio adn/tools/.
- CLI unificada adn/tools.rb.
- KPIs específicos de reducción de IA.
[ ] Crear ticket en P2603 para "Automatización Ruby del ADN".
[ ] Iniciar Fase 1 con estructura básica de adn/tools/.

🔗 Referencias Críticas

Plan Original
ADN Gobernanza - Prioridad Ruby sobre Bash
ADN IA - Directivas a reducir progresivamente
Herramienta ns8-candados - Ejemplo de diseño Ruby robusto
Dashboard Principal - Para integración futura

«La verdadera autonomía no es eliminar la IA, sino hacerla opcional. Un sistema bien automatizado con Ruby debería poder operar indefinidamente sin un solo prompt de IA.»
— Principio de Autonomía por Diseño

11 KiB Raw Blame History