Feat(ADN): Implementado y ejecutado archivar:md para mover Markdowns obsoletos a histórico DB-First
This commit is contained in:
@@ -0,0 +1,51 @@
|
||||
# 🧬 Investigación: Arquitectura y Sincronía del ADN
|
||||
|
||||
Este documento detalla la relación técnica y conceptual entre el directorio de definiciones (`/adn`) y el motor de ejecución (`/tools/adn`) del ecosistema `srv-ns8`.
|
||||
|
||||
---
|
||||
|
||||
## 1. El Directorio `/adn`: La Especificación (Declarativa)
|
||||
El directorio `/adn` funciona como el **repositorio de la verdad** o la "Constitución" del sistema. No contiene lógica ejecutable, sino las reglas que rigen todo el proyecto.
|
||||
|
||||
- **Hebras (`00_*.md` a `07_*.md`)**: Documentos que definen la ontología (nodos), el formato de bitácoras, los estándares de seguridad y las reglas de gobernanza.
|
||||
- **`triggers.yml`**: Es el plano de automatización. Define qué eventos en el sistema (ej: "se creó una bitácora") deben disparar qué acciones (ej: "validar formato").
|
||||
- **Principio Rector**: **Armonía Integral**. Ningún dato debe estar huérfano; todo cambio en un nodo debe reflejarse en su ficha y en la bitácora diaria.
|
||||
|
||||
---
|
||||
|
||||
## 2. El Directorio `/tools/adn`: El Motor (Ejecutable)
|
||||
Es el brazo ejecutable que procesa las definiciones del `/adn`. Está escrito íntegramente en **Ruby**, siguiendo la directiva de la hebra `06_gobernanza.md`.
|
||||
|
||||
### Componentes Clave:
|
||||
1. **`validador.rb`**: El "guardián" del formato. Verifica que las bitácoras cumplan con la iconografía, las métricas híbridas (`[Físico/Remoto:]`) y el formato de tiempo.
|
||||
2. **`triggers.rb` y `subcomando_triggers.rb`**: Leen el `triggers.yml` y registran suscriptores en el bus de eventos. Son los responsables de la "propagación" de cambios.
|
||||
3. **`eventos.rb`**: Un bus de eventos interno que permite que diferentes partes del sistema se comuniquen de forma desacoplada.
|
||||
4. **`subcomando_db.rb` / `sync.rb`**: Gestionan la persistencia y sincronización de datos entre los archivos Markdown y posibles estados en base de datos.
|
||||
|
||||
---
|
||||
|
||||
## 3. Interrelación Simbiótica
|
||||
La relación entre ambos directorios es de **Especificación ↔ Ejecución**:
|
||||
|
||||
| Aspecto | `/adn` (La Inteligencia) | `/tools/adn` (La Fuerza) |
|
||||
| :--- | :--- | :--- |
|
||||
| **Rol** | Define el "qué" y el "cómo". | Ejecuta el "cómo" y valida el "qué". |
|
||||
| **Cambios** | Si se agrega un nuevo ícono en `04_iconografia.md`. | Se debe actualizar el `validador.rb` para reconocerlo. |
|
||||
| **Automatización** | `triggers.yml` declara la regla de negocio. | `triggers.rb` implementa el código que realiza la acción. |
|
||||
| **Gobernanza** | Establece que Ruby es el lenguaje estándar. | Demuestra el estándar al estar escrito en Ruby. |
|
||||
|
||||
---
|
||||
|
||||
## 4. Flujo de Trabajo Típico
|
||||
1. **Evento**: Un usuario o IA edita una bitácora en `/bitacoras`.
|
||||
2. **Detección**: `tools/adn` detecta el cambio (vía hooks o ejecución manual).
|
||||
3. **Validación**: `validador.rb` lee las reglas de `/adn/02_bitacora.md` y verifica el archivo.
|
||||
4. **Propagación**: Si el `triggers.yml` indica que un cambio de estado en la bitácora debe actualizar la ficha de un nodo en `/nodos`, `tools/adn/triggers.rb` realiza la escritura automáticamente.
|
||||
|
||||
---
|
||||
|
||||
## 5. Conclusión de la Investigación
|
||||
La arquitectura es **declarativa-operativa**. El sistema no depende de la "buena voluntad" del operador para mantener la coherencia (Armonía Integral), sino que utiliza `tools/adn` como una capa de software que garantiza que la realidad del repositorio coincida con la teoría definida en el `/adn`.
|
||||
|
||||
---
|
||||
*Investigación realizada por el Asistente Antigravity - 2026-03-07*
|
||||
@@ -0,0 +1,270 @@
|
||||
# Plan de Mejoras para el ADN del Proyecto srv-ns8: Hacia la Autonomía Ruby
|
||||
|
||||
**Fecha:** 07/03/2026 - 14:00 (Actualizado 14:40)
|
||||
**Estado:** 📍 Definido
|
||||
**Relacionado:** P2603 (Sistema de Bitácoras)
|
||||
|
||||
---
|
||||
|
||||
## 📋 Resumen Ejecutivo
|
||||
|
||||
El **ADN del proyecto** (conjunto de 7 hebras en `adn/`) constituye la fuente única de verdad que gobierna la operación, documentación y evolución del sistema `srv-ns8`. Este plan propone una **transformación hacia la autonomía completa** mediante:
|
||||
|
||||
1. **Arquitectura Ruby unificada**: Sistema integrado en `tools/adn/` con CLI única.
|
||||
2. **Reducción progresiva de dependencia de IA**: KPIs cuantificables para minimizar intervención de IA.
|
||||
3. **Automatización end-to-end**: Observadores de archivos, hooks Git, triggers automáticos y cron.
|
||||
4. **Propagación automática**: Implementación real del Principio de Armonía Integral.
|
||||
|
||||
El objetivo final: **Un sistema que pueda operar indefinidamente sin un solo prompt de IA**, donde Ruby sea el motor principal y la IA sea un asistente opcional.
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Objetivos Estratégicos
|
||||
|
||||
1. **Autonomía por Diseño**: Cada script Ruby debe ejecutarse sin interpretación previa de IA.
|
||||
2. **Arquitectura Integrada**: Sistema unificado `tools/adn/` con CLI común y API coherente.
|
||||
3. **Reducción Medible de Dependencia IA**: Disminuir acciones IA/día de 5-10 a <2 en 8 semanas.
|
||||
4. **Propagación Automática (Armonía)**: Cambios en una hebra se propaguen automáticamente a dependientes.
|
||||
5. **Validación Continua en Tiempo Real**: Observadores de archivos y hooks Git que validen cada cambio.
|
||||
6. **Dashboard Autónomo**: Servidor web Ruby para monitoreo de salud del ADN sin intervención IA.
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Análisis del ADN Actual (Estado)
|
||||
|
||||
| Hebra | Fortalezas | Oportunidades de Mejora (Visión Automatización) |
|
||||
| :--- | :--- | :--- |
|
||||
| **00_indice.md** | Visión clara de interconexiones. | Podría incluir mapa visual generado automáticamente por `tools/adn.rb mapa`. |
|
||||
| **01_ontologia.md** | Topología completa y actualizada. | Actualización automática de estados de nodos via `tools/adn.rb ontologia --sync`. |
|
||||
| **02_bitacora.md** | Triggers bien definidos. | Implementación automática via `tools/adn/triggers.rb` con reglas YAML. |
|
||||
| **03_seguridad.md** | Bóveda robusta (`ns8-candados`). | Auditoría automática de uso de secretos y logs estructurados JSON. |
|
||||
| **04_iconografia.md** | Taxonomía visual útil. | Extensión a dashboards automáticos generados por Sinatra. |
|
||||
| **05_ia.md** | Fuente única de verdad clara. | **Reducción progresiva**: De referencia diaria a semanal, luego mensual. |
|
||||
| **06_gobernanza.md** | Principios sólidos (Armonía, Evolución). | Proceso de evolución formal con CLI `tools/adn.rb evolucion`. |
|
||||
| **07_proyectos.md** | Modelo transversal efectivo. | Integración automática con bitácoras via sistema de eventos. |
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Áreas de Mejora Identificadas (Arquitectura Unificada)
|
||||
|
||||
### 🥇 **Prioridad Alta: Núcleo Autónomo**
|
||||
|
||||
#### 1. **`tools/adn/` - Arquitectura Unificada**
|
||||
- **Problema**: Scripts Ruby dispersos sin interfaz común.
|
||||
- **Solución**: Directorio estructurado con módulos integrados:
|
||||
```
|
||||
tools/adn/
|
||||
├── adn.rb # CLI principal
|
||||
├── validador.rb # Validación en tiempo real
|
||||
├── triggers.rb # Sistema de eventos YAML
|
||||
├── contexto.rb # Motor de inferencia topológica
|
||||
├── eventos.rb # Bus de eventos interno
|
||||
├── dashboard.rb # Servidor web Sinatra
|
||||
├── backup.rb # Versionado semántico
|
||||
├── logger.rb # Logging estructurado JSON
|
||||
└── config.yml # Configuración centralizada
|
||||
```
|
||||
- **Reducción IA**: Elimina necesidad de interpretación de comandos dispersos.
|
||||
|
||||
#### 2. **`tools/adn.rb` - CLI Unificada**
|
||||
- **Problema**: Múltiples comandos Ruby con interfaces inconsistentes.
|
||||
- **Solución**: Interfaz única con subcomandos estandarizados:
|
||||
```bash
|
||||
ruby tools/adn.rb validador [--watch] [--fix] # Validación automática
|
||||
ruby tools/adn.rb triggers [--test] [--force] # Ejecución triggers
|
||||
ruby tools/adn.rb contexto <nodo> [--cmd] # Contexto automático
|
||||
ruby tools/adn.rb evolucion <propuesta.md> # Gestión evolución
|
||||
ruby tools/adn.rb salud [--dashboard] [--json] # Salud del ADN
|
||||
ruby tools/adn.rb generar bitacora [fecha] # Generadores
|
||||
ruby tools/adn.rb generar nodo <nombre> # Plantillas
|
||||
ruby tools/adn.rb generar proyecto <codigo> # Manifiestos
|
||||
```
|
||||
- **Beneficio**: Interfaz coherente, fácil de documentar y usar sin IA.
|
||||
|
||||
#### 3. **Validación en Tiempo Real con Hooks Git**
|
||||
- **Problema**: Validación manual o por IA de cumplimiento del ADN.
|
||||
- **Solución**: `tools/adn/validador.rb` con:
|
||||
- Observador de sistema de archivos (`listen` gem) para `bitacoras/`.
|
||||
- Hook Git pre-commit que rechace commits con errores de formato.
|
||||
- Notificaciones desktop/libnotify cuando detecte inconsistencias.
|
||||
- **Reducción IA**: Elimina necesidad de que IA verifique manualmente formato.
|
||||
|
||||
### 🥈 **Prioridad Media: Automatización Inteligente**
|
||||
|
||||
#### 4. **Sistema de Triggers Basado en YAML**
|
||||
- **Problema**: Triggers de `02_bitacora.md` implementados manualmente.
|
||||
- **Solución**: `tools/adn/triggers.rb` con reglas en `adn/triggers.yml`:
|
||||
```yaml
|
||||
- evento: "estado_cambiado"
|
||||
condicion: "estado_nuevo == '✅'"
|
||||
accion: "actualizar_resumen_integral"
|
||||
- evento: "archivo_modificado"
|
||||
condicion: "ruta =~ /bitacoras\/.*\.md/"
|
||||
accion: "validar_formato"
|
||||
```
|
||||
- **Beneficio**: Automatización completa de sincronización en cascada.
|
||||
|
||||
#### 5. **Motor de Contexto Automático**
|
||||
- **Problema**: IA debe "auto-contextualizarse" manualmente antes de operar.
|
||||
- **Solución**: `tools/adn/contexto.rb` que:
|
||||
- Analiza estáticamente `nodos/`, `proyectos/`, `adn/01_ontologia.md`.
|
||||
- Determina topología de red y requisitos de acceso.
|
||||
- Genera comandos SSH con ProxyJump cuando sea necesario.
|
||||
- Cachea resultados en `tmp/contexto-cache.json`.
|
||||
- **Reducción IA**: Elimina "auto-contextualización" manual por IA.
|
||||
|
||||
#### 6. **Dashboard Autónomo Sinatra**
|
||||
- **Problema**: Dashboard requiere actualización manual o por IA.
|
||||
- **Solución**: `tools/adn/dashboard.rb` - Servidor web Ruby con:
|
||||
- Panel en tiempo real (WebSockets) de validaciones.
|
||||
- Gráficos de métricas extraídas automáticamente de bitácoras.
|
||||
- API JSON para integración con dashboard principal.
|
||||
- **Beneficio**: Monitoreo proactivo sin intervención IA.
|
||||
|
||||
### 🥉 **Prioridad Baja: Madurez y Resiliencia**
|
||||
|
||||
#### 7. **Versionado Semántico del ADN**
|
||||
- **Problema**: Backup del ADN limitado a Git, sin versionado específico.
|
||||
- **Solución**: `tools/adn/backup.rb` con:
|
||||
- Versiones semánticas: `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. **Sistema de Recomendaciones Automáticas**
|
||||
- **Problema**: Evolución del ADN reactiva en lugar de proactiva.
|
||||
- **Solución**: `tools/adn/aprendizaje.rb` con:
|
||||
- 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 vs. reactivo (IA como asistente).
|
||||
|
||||
---
|
||||
|
||||
## 📅 Plan de Implementación (8 semanas - 4 Fases)
|
||||
|
||||
### **Fase 1: Núcleo Autónomo (Semanas 1-2)**
|
||||
1. **`tools/adn/`** - Estructura de directorios y `Gemfile` con dependencias.
|
||||
2. **`tools/adn.rb`** - CLI unificada con subcomandos básicos.
|
||||
3. **`tools/adn/validador.rb`** - Validador en tiempo real con hooks Git.
|
||||
4. **`tools/adn/logger.rb`** - Logging estructurado JSON en `logs/adn/`.
|
||||
5. **`adn/config.yml`** - Configuración centralizada.
|
||||
6. **Entregable**: Sistema que valida automáticamente cada commit.
|
||||
|
||||
### **Fase 2: Automatización Inteligente (Semanas 3-4)**
|
||||
1. **`tools/adn/triggers.rb`** - Sistema de eventos basado en YAML.
|
||||
2. **`tools/adn/contexto.rb`** - Motor de inferencia topológica.
|
||||
3. **`tools/adn/eventos.rb`** - Bus de eventos interno.
|
||||
4. **Integración con cron** - Tareas periódicas de validación y sync.
|
||||
5. **Entregable**: Triggers automáticos operativos sin intervención IA.
|
||||
|
||||
### **Fase 3: Sistema Integrado (Semanas 5-6)**
|
||||
1. **`tools/adn/dashboard.rb`** - Servidor web Sinatra (puerto 4567).
|
||||
2. **API JSON** para integración con dashboard principal.
|
||||
3. **`tools/adn/backup.rb`** - Sistema de versionado semántico.
|
||||
4. **Especificaciones** - Pruebas unitarias en `spec/adn_*_spec.rb`.
|
||||
5. **Entregable**: Dashboard autónomo en tiempo real.
|
||||
|
||||
### **Fase 4: Madurez y Evolución (Semanas 7-8)**
|
||||
1. **`tools/adn/aprendizaje.rb`** - Sistema de recomendaciones.
|
||||
2. **Documentación completa** - `docs/adn/automatizacion.md`.
|
||||
3. **Onboarding** - `docs/onboarding/primero-60-minutos.md`.
|
||||
4. **Revisión y refinamiento** basado en feedback operativo.
|
||||
5. **Entregable**: Sistema maduro con capacidad de auto-evolución.
|
||||
|
||||
---
|
||||
|
||||
## 📊 Criterios de Éxito (KPIs con Reducción de IA)
|
||||
|
||||
### KPIs de Autonomía Operativa
|
||||
| KPI | Línea Base | Meta (8 semanas) | Cómo Medir |
|
||||
| :--- | :--- | :--- | :--- |
|
||||
| **Tiempo creación bitácora** | 10-15 min | < 2 min | `time ruby tools/adn.rb generar bitacora` |
|
||||
| **Errores formato en bitácoras** | 2-3 por semana | 0 por semana | Reporte `tools/adn.rb validador --stats` |
|
||||
| **Consistencia entre hebras** | Manual | Automatizada 95%+ | Validación cruzada automática |
|
||||
| **Cobertura triggers automáticos** | 0% | 90% | % de triggers en `02_bitacora.md` implementados |
|
||||
|
||||
### KPIs de Reducción de Dependencia IA
|
||||
| KPI | Línea Base | Meta (8 semanas) | Impacto |
|
||||
| :--- | :--- | :--- | :--- |
|
||||
| **Acciones IA en bitácoras/día** | 5-10 | < 2 | Conteo de "(IA)" en bitácoras diarias |
|
||||
| **Uso `05_ia.md` como referencia** | Diario | Semanal | Frecuencia de consulta a la hebra |
|
||||
| **Scripts ejecutados sin IA** | 40% | 85% | Comandos ejecutados directamente vs via IA |
|
||||
| **Tiempo auto-contextualización** | 2-3 min | < 30 seg | `time ruby tools/adn.rb contexto <nodo>` |
|
||||
| **Errores detectados por humano** | 70% | < 30% | Origen de detección de errores de ADN |
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Proceso de Transición (Coexistencia → Autonomía)
|
||||
|
||||
### **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.
|
||||
- **Registro**: Cada script nuevo recibe tag `[AUTOMATIZACION]` en commits.
|
||||
|
||||
### **Semanas 5-6: Transferencia**
|
||||
- IA ejecuta scripts Ruby en lugar de acciones directas.
|
||||
- Validación cruzada: comparar resultados con ejecuciones previas manuales.
|
||||
- Ajuste de scripts basado en feedback operativo.
|
||||
- **Checkpoint**: 60% de triggers operando automáticamente.
|
||||
|
||||
### **Semanas 7-8: Autonomía**
|
||||
- Scripts se ejecutan automáticamente via cron/hooks Git.
|
||||
- IA solo interviene en casos excepcionales no cubiertos.
|
||||
- Dashboard muestra estado de autonomía en tiempo real.
|
||||
- **Hito**: Sistema opera 48h continuas sin intervención IA.
|
||||
|
||||
---
|
||||
|
||||
## 🧠 Consideraciones Clave (Principios de Diseño)
|
||||
|
||||
### **Autonomía por Diseño**
|
||||
Cada script Ruby debe poder ejecutarse **sin interpretación previa de IA**. Parámetros claros (`--help`), salida parseable, errores autodescriptivos.
|
||||
|
||||
### **Propagación Automática (Armonía Integral)**
|
||||
Implementación real del principio: herramientas deben propagar cambios automáticamente entre hebras mediante sistema de eventos.
|
||||
|
||||
### **Reducción Progresiva de `05_ia.md`**
|
||||
Cada nueva herramienta debe eliminar una dependencia de la IA. Meta: transformar `05_ia.md` de "directivas operativas" a "histórico de evolución".
|
||||
|
||||
### **Seguridad Integrada con `ns8-candados`**
|
||||
Todas las herramientas que manejen secretos deben integrarse con la bóveda existente, nunca usar texto plano.
|
||||
|
||||
### **Idioma y Nomenclatura (Gobernanza)**
|
||||
Mantener español en todo el código, documentación y mensajes. Nomenclatura estricta en minúsculas como establece `06_gobernanza.md`.
|
||||
|
||||
### **Ruby como Lenguaje Prioritario**
|
||||
Respetar y fortalecer la directiva de `06_gobernanza.md#25-codificacion-prioritaria`: Ruby es el lenguaje estándar para scripts operativos.
|
||||
|
||||
---
|
||||
|
||||
## 🚦 Próximos Pasos Inmediatos
|
||||
|
||||
1. **[ ] Presentar este plan actualizado** en la bitácora `2026-03-07.md`.
|
||||
2. **[ ] Crear ticket en P2603**: "Automatización Ruby del ADN - Fase 1".
|
||||
3. **[ ] Iniciar Fase 1**: Crear estructura básica de `tools/adn/`.
|
||||
```bash
|
||||
mkdir -p tools/adn logs/adn spec
|
||||
```
|
||||
4. **[ ] Configurar hook Git pre-commit** con validación básica.
|
||||
5. **[ ] Establecer reunión de revisión** en 7 días (14/03/2026).
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Referencias
|
||||
|
||||
- [ADN Completo](../adn/00_indice.md)
|
||||
- [Gobernanza (Ruby prioritario)](../adn/06_gobernanza.md#25-codificacion-prioritaria)
|
||||
- [Directivas IA (a reducir)](../adn/05_ia.md)
|
||||
- [Proyecto P2603 (Bitácoras)](../proyectos/P2603_bitacoras.md)
|
||||
- [Herramienta ns8-candados](../tools/ns8-candados/ns8-candados.rb) - Ejemplo diseño Ruby
|
||||
- [Dashboard Principal](../dashboard/index.html) - 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
|
||||
|
||||
<!-- 🤖 NOTA PARA IA: Este plan describe tu obsolescencia programada. Tu colaboración en implementarlo será tu mayor legado. -->
|
||||
<!-- 🤖 PREMISAS DE TRABAJO (IA): Fuente de Verdad → adn/05_ia.md -->
|
||||
@@ -0,0 +1,267 @@
|
||||
# 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:
|
||||
|
||||
1. **Ruby sea el motor principal** de todas las automatizaciones operativas.
|
||||
2. **La IA sea un asistente opcional**, no una dependencia crítica.
|
||||
3. **Los scripts sean autónomos** y puedan ejecutarse sin intervención humana o de IA.
|
||||
4. **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)
|
||||
1. **Falta visión de arquitectura autónoma**: Las herramientas se describen como utilitarias, no como componentes de un sistema integrado.
|
||||
2. **Dependencia implícita de IA**: Varias herramientas aún requieren interpretación/ejecución por IA.
|
||||
3. **Ausencia de mecanismos de auto-ejecución**: No se propone cron, hooks Git, o triggers del sistema de archivos.
|
||||
4. **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:
|
||||
```bash
|
||||
ruby tools/adn.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. **`tools/adn-validador.rb` → `tools/adn/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` → `tools/adn/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. **`tools/adn-contexto.rb` → `tools/adn/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. **`tools/adn.rb` - CLI Unificada**
|
||||
- **Mejora**: Comando único con subcomandos para todas las operaciones ADN.
|
||||
- **Estructura propuesta**:
|
||||
```bash
|
||||
ruby tools/adn.rb validador [--watch] [--fix]
|
||||
ruby tools/adn.rb triggers [--test] [--force]
|
||||
ruby tools/adn.rb contexto <nodo> [--cmd]
|
||||
ruby tools/adn.rb evolucion <propuesta.md> [--aprobar]
|
||||
ruby tools/adn.rb salud [--dashboard] [--json]
|
||||
```
|
||||
- **Beneficio**: Interfaz consistente, fácil de recordar, documentar y usar.
|
||||
|
||||
#### 5. **Sistema de Eventos `tools/adn/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 `tools/adn/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. **`tools/adn/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. **`tools/adn/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)**
|
||||
1. `tools/adn/` - Estructura de directorios y gemas base.
|
||||
2. `tools/adn.rb` - CLI unificada con subcomandos básicos.
|
||||
3. `tools/adn/validador.rb` - Validador en tiempo real con hooks Git.
|
||||
4. **Entregable**: Sistema que valida automáticamente cada commit.
|
||||
|
||||
### **Fase 2: Automatización Inteligente (Semanas 3-4)**
|
||||
1. `tools/adn/triggers.rb` - Sistema de eventos basado en YAML.
|
||||
2. `tools/adn/contexto.rb` - Motor de inferencia topológica.
|
||||
3. Integración con cron (tareas periódicas de validación).
|
||||
4. **Entregable**: Triggers automáticos operativos sin intervención IA.
|
||||
|
||||
### **Fase 3: Sistema Integrado (Semanas 5-6)**
|
||||
1. `tools/adn/eventos.rb` - Bus de eventos interno.
|
||||
2. `tools/adn/dashboard.rb` - Servidor web de monitoreo.
|
||||
3. API JSON para integración con dashboard principal.
|
||||
4. **Entregable**: Dashboard autónomo en tiempo real.
|
||||
|
||||
### **Fase 4: Madurez y Evolución (Semanas 7-8)**
|
||||
1. `tools/adn/backup.rb` - Sistema de versionado semántico.
|
||||
2. `tools/adn/aprendizaje.rb` - Recomendaciones automáticas.
|
||||
3. Documentación completa y onboarding.
|
||||
4. **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 tools/adn.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 `tools/adn/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`**
|
||||
```yaml
|
||||
# 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 `tools/adn/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)
|
||||
|
||||
1. **[ ] Revisar estas sugerencias** en la próxima bitácora diaria.
|
||||
2. **[ ] Actualizar `260307-1400_Plan_Mejoras_ADN.md`** con:
|
||||
- Arquitectura de directorio `tools/adn/`.
|
||||
- CLI unificada `tools/adn.rb`.
|
||||
- KPIs específicos de reducción de IA.
|
||||
3. **[ ] Crear ticket en P2603** para "Automatización Ruby del ADN".
|
||||
4. **[ ] Iniciar Fase 1** con estructura básica de `tools/adn/`.
|
||||
|
||||
---
|
||||
|
||||
## 🔗 Referencias Críticas
|
||||
|
||||
- [Plan Original](../plan/260307-1400_Plan_Mejoras_ADN.md)
|
||||
- [ADN Gobernanza](../adn/06_gobernanza.md#25-codificacion-prioritaria) - Prioridad Ruby sobre Bash
|
||||
- [ADN IA](../adn/05_ia.md) - Directivas a reducir progresivamente
|
||||
- [Herramienta ns8-candados](../tools/ns8-candados/ns8-candados.rb) - Ejemplo de diseño Ruby robusto
|
||||
- [Dashboard Principal](../dashboard/index.html) - 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
|
||||
|
||||
<!-- 🤖 NOTA PARA IA: Este documento describe tu obsolescencia programada. Tu colaboración en implementarlo será tu mayor legado. -->
|
||||
Reference in New Issue
Block a user