feat(ambito): Migración de dtic-ADN a estándar de ámbito A01

- Creado manifiesto A01_dtic-ADN.md siguiendo estándar A03/A04
- Renombrados planes P2604.* → A01.P00X (8 planes migrados)
- Archivado manifiesto legacy P2604_Mejoras-ADN.md en _hist/
- Actualizada ontología y contexto IA con referencias a A01

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Ricardo Monla
2026-04-07 09:59:52 -03:00
co-authored by Claude Opus 4.6
parent 138a3c9ec6
commit 018e45e046
14 changed files with 1417 additions and 13 deletions
@@ -0,0 +1,76 @@
# Plan: Estandarización de Ayudas en Pantalla para Herramientas ADN
**Fecha:** 17 de marzo de 2026
**Autor:** Sistema ADN
**Versión:** 1.0
**Ubicación:** `docs/ambito/dtic-ADN/A01.P001_Estandarizacion-Ayudas-ADN.md`
**Estado:** ⏳ En Ejecución
## 📋 Resumen Ejecutivo
Estandarizar el formato y contenido de las ayudas en pantalla (--help) para todas las herramientas del ecosistema ADN, utilizando el formateador de ayuda estandarizado (`adn/tools/core/help_formatter.rb`) para garantizar consistencia, reutilización y mantenibilidad.
## 📅 Fases de Implementación
### ✅ **FASE 1: Análisis y Creación de Estándar (Completado)**
#### Semana 1: Análisis Inicial
- [x] **1.1:** Análisis de ayudas actuales en subcomandos CLI
- [x] **1.2:** Creación de plantilla estándar de ayuda usando HelpFormatter
#### Semana 2: Implementación Crítica
- [x] **1.3:** Actualización de subcomando principal (ayuda.rb)
- [x] **1.4:** Actualización de subcomandos críticos (jornada.rb, nodos.rb, db.rb)
- [x] **1.5:** Actualización de subcomandos intermedios (generar.rb, proceso.rb, conocimiento.rb)
#### Semana 3: Implementación Completa
- [x] **1.6:** Actualización de subcomandos (msp.rb, ssh.rb, triggers.rb, contexto.rb, backup.rb ✅) y pendientes (plan.rb, tailscale.rb, estados.rb, salud.rb, validador.rb, wzombi.rb 📍)
- [ ] **1.7:** Verificación y pruebas de consistencia
### ⏳ **FASE 2: Documentación y Soporte (Pendiente)**
#### Semana 4: Documentación
- [ ] **2.1:** Documentación de guías para desarrolladores sobre el nuevo estándar
- [ ] **2.2:** Integración de verificaciones automáticas en CI (si aplica)
## 🔧 Herramientas Utilizadas
- Ruby CLI (ADN): Subcomandos en `adn/tools/cli/` que requieren estandarización de ayuda
- Help Formatter (`adn/tools/core/help_formatter.rb`): Componente central para formateo consistente de ayudas
## 👥 Stakeholders
| Rol | Persona | Visibilidad |
| :--- | :--- | :--- |
| **Responsable Técnico** | Lic. Ricardo MONLA | Operador directo |
| **Dirección de TIC** | (Jerárquico superior) | Dashboard asíncrono |
| **Desarrolladores ADN** | Equipo de desarrollo | Uso diario de herramientas |
## 🖥️ Nodos Involucrados
Este proyecto se enfoca en las herramientas CLI del ecosistema ADN, por lo que no involucra nodos de infraestructura específicos. Los cambios se aplicarán a nivel de código en el repositorio.
## 📊 Progreso
```
Fase 1: ████████░░ 85% Implementación (85% completado)
Fase 2: ░░░░░░░░░░ 0% Documentación y Soporte
```
## 📖 Comandos ADN (Referencia)
```bash
# Ver ayuda principal
./adn/tools/run ayuda
# Ver ayuda de un subcomando específico
./adn/tools/run ayuda jornada
./adn/tools/run ayuda nodos
./adn/tools/run ayuda db
```
## 🔗 Referencias
- **ADN**: [Principios Rectores](../../../adn/06_gobernanza.md) | [Herramienta CLI](../../../adn/README.md#herramienta-cli-adn-toolsrun)
- **Help Formatter**: [`adn/tools/core/help_formatter.rb`](../../../adn/tools/core/help_formatter.rb)
- **Subcomandos CLI**: [`adn/tools/cli/`](../../../adn/tools/cli/)