Ricardo Monla
cfd0e8452a
- S1: Eliminar 'triggers' duplicado en run (líneas 109/131) - S2: Eliminar cli/commit.rb (truncado, sin uso) - S3: Eliminar cli/inicio.rb y cli/cierre.rb (legacy, jornada.rb los reemplaza) - S4: Mover 4 planes obsoletos de docs/plan/adn/ a docs/_hist/plan/adn/ - S5: Mover 14 backups de planes y 3 docs técnicos a docs/_hist/ - S6: Eliminar manifiesto vacío P2604_proyecto_p2604.md - S7: Corregir referencia a plan obsoleto en run - S8: Dejar de cargar core/validador.rb obsoleto en run - S9: Limpiar progreso duplicado en P2604_mejoras_ADN.md - Agregar Fase 10 al plan P2604 con 10 tareas - Un solo punto de verdad: adn/README.md - Un solo plan: docs/proy/p2604_mejoras_ADN/P2604_mejoras_ADN.md - Registro en bitácora: evento 1073
3.4 KiB
🧬 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 (/adn/tools) 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_*.mda07_*.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 /adn/tools: 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:
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.triggers.rbysubcomando_triggers.rb: Leen eltriggers.ymly registran suscriptores en el bus de eventos. Son los responsables de la "propagación" de cambios.eventos.rb: Un bus de eventos interno que permite que diferentes partes del sistema se comuniquen de forma desacoplada.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) |
/adn/tools (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
- Evento: Un usuario o IA edita una bitácora en
/bitacoras. - Detección:
adn/toolsdetecta el cambio (vía hooks o ejecución manual). - Validación:
validador.rblee las reglas de/adn/02_bitacora.mdy verifica el archivo. - Propagación: Si el
triggers.ymlindica que un cambio de estado en la bitácora debe actualizar la ficha de un nodo en/nodos,adn/tools/triggers.rbrealiza 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 adn/tools 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