dtic-DIIAA/adn/06_gobernanza.md

06 - Hebra: Gobernanza y Armonía

Referencia canónica: adn/00_indice.md

Esta hebra establece las reglas fundamentales de idioma, nomenclatura, coherencia documental, resguardo y evolución del proyecto.

1. Idioma y Nomenclatura

• Directiva: Todo el contenido debe estar en español.
• Nomenclatura de Nodos: Estrictamente minúsculas en nombres de archivo y referencias (ej: srv-ns8, dasu-pc, srvv-maurik).
• Alcance:
  • Interacciones con el asistente (chat).
  • Documentación (archivos .md).
  • Mensajes de Commit (Git).
  • Comentarios en el código (scripts, configs).

2. Formato de Documentación

• Estilo: Markdown estándar.
• Ubicación: Todo documento clave del ADN debe residir en el directorio adn/.

2.5 Codificación Prioritaria

• Lenguaje estándar: Ruby es el lenguaje prioritario para scripts operativos y herramientas del proyecto.
• Justificación: Manejo robusto de excepciones, escalabilidad estructural y consistencia frente a la fragilidad de Bash para secuencias complejas.
• Alcance: Scripts de automatización (tools/), procesadores de respaldos (dtic-BKPs), utilidades de gestión y cualquier lógica operativa recurrente.
• Excepción: Bash se permite para one-liners, wrappers de lanzamiento y tareas triviales de sistema donde Ruby introduzca complejidad innecesaria.

2.8 Menos es Más (Simplicidad Radical)

• Principio: Cada componente, script, archivo o línea de código debe justificar su existencia. Si no aporta valor activo al sistema, se elimina.
• Aplicación:
  • Eliminar módulos obsoletos, pruebas de concepto abandonadas y prototipos sin uso.
  • Preferir un subcomando reutilizable sobre múltiples scripts temporales.
  • Consolidar funcionalidades dispersas en herramientas unificadas (adn/tools/run).
  • Evitar duplicación: si un dato ya existe en la DB, no replicarlo manualmente en .md.
• Relación con los otros principios: "Menos es Más" habilita la Armonía Integral (menos piezas = menos inconsistencias posibles) y alimenta la Mejora Continua (simplificar es evolucionar).

Tríptico Rector del ADN: Los tres principios que rigen toda decisión operativa son: Menos es Más, Armonía Integral y Mejora Continua (Evolución Progresiva).

3. Armonía Integral 🧬

El principio rector del proyecto. Así como las hebras del ADN biológico se entrelazan para codificar un organismo, las piezas de este proyecto están interconectadas bidireccionalmente:

• ADN ↔ Bitácoras: Las hebras definen cómo se escriben; las mejores prácticas emergentes en bitácora se formalizan como nuevas reglas.
• ADN ↔ Nodos: La ontología describe los nodos; los cambios de estado de un nodo se reflejan en su ficha y en la bitácora.
• ADN ↔ Proyectos: Los proyectos transversales (ver hebra 07_proyectos.md) agrupan nodos, bitácoras y tareas bajo un objetivo común con visibilidad gerárquica.
• Bitácoras ↔ Nodos: Los hitos del día alimentan y actualizan la ficha del nodo afectado.

Regla de Propagación

Si un dato cambia en un sitio, debe propagarse a todos los demás. Esta responsabilidad recae tanto sobre el operador como sobre la IA. Al detectar una inconsistencia, es prioritario resolverla antes de avanzar.

Consistencia

No deben existir discrepancias entre diferentes hebras. Si se actualiza una definición en 01_ontologia.md, debe reflejarse en los protocolos y bitácoras correspondientes.

Trazabilidad

Los IDs y estados deben ser consistentes a través del tiempo. Los hipervínculos bidireccionales entre bitácoras (➡️ [Viene del...] / ➡️ [Migrado al...]) son obligatorios.

4. Resguardo del Repositorio (Safeguard)

• Objetivo: Asegurar la integridad y el historial de cambios del proyecto.
• Directiva:
  • Frecuencia: Al finalizar una tarea significativa o conjunto de tareas relacionadas (hito).
  • Alcance: Todo cambio en adn/, servicios/config, automatizacion/ y documentación docs/.
  • Formato Mensaje: [Categoría] Descripción breve del cambio.

5. Evolución Progresiva (Mejora Continua)

• Principio: El ADN no es estático; evoluciona a partir de los descubrimientos y buenas prácticas emergentes de la operación diaria.
• Flujo de Vida de una Mejora:
  1. Incubación: Una técnica experimental se prueba en la trinchera (bitácoras, scripts, reportes).
  2. Identificación: Se reconoce el valor sistémico y repetible de la técnica.
  3. Formalización: Se integra como regla oficial en la hebra correspondiente del ADN.
  4. Propagación: A partir de su formalización, la regla es de cumplimiento obligatorio para el trabajo futuro.
• Ejemplo Fundacional: Las Premisas de Trabajo (IA) nacieron como un experimento en el footer de las bitácoras y evolucionaron orgánicamente hasta convertirse en una hebra canónica (05_ia.md).