# 06 - Hebra: Gobernanza y Armonía > Referencia canónica: [`adn/00_indice.md`](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/`. ## 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. ## 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`](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`).