Ricardo MonlaandClaude Opus 4.6
018e45e046
- 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>
3.1 KiB
3.1 KiB
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
- 1.1: Análisis de ayudas actuales en subcomandos CLI
- 1.2: Creación de plantilla estándar de ayuda usando HelpFormatter
Semana 2: Implementación Crítica
- 1.3: Actualización de subcomando principal (ayuda.rb)
- 1.4: Actualización de subcomandos críticos (jornada.rb, nodos.rb, db.rb)
- 1.5: Actualización de subcomandos intermedios (generar.rb, proceso.rb, conocimiento.rb)
Semana 3: Implementación Completa
- 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)
# 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 | Herramienta CLI
- Help Formatter:
adn/tools/core/help_formatter.rb - Subcomandos CLI:
adn/tools/cli/