76 lines
4.9 KiB
Markdown
76 lines
4.9 KiB
Markdown
# 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`, `dasu-pc-0`, `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`](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`).
|