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, pc-dasu0, 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/.

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.
• 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, scripts/ 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).