docs: Plan P2603.01 Automatización Zoom y actualizaciones P2601.09

2026-03-31 18:03:21 -03:00
parent 160da47f96
commit 1fd213173e
72 changed files with 19694 additions and 460 deletions
@@ -0,0 +1,66 @@
+# P2604.02.01 - Plan: Herramienta de Generación de Proyectos ADN
+
+**Fecha:** 17 de marzo de 2026
+**Autor:** Antigravity (IA ADN)
+**Estado:** ✅ Completado
+**Proyecto Padre:** [P2604 - Mejoras ADN](P2604_Mejoras-ADN.md)
+
+## 📋 Objetivo
+Automatizar la creación de estructuras de proyectos (planes, hitos, tareas) en el ecosistema ADN para garantizar consistencia en la nomenclatura y ubicación de los archivos en `docs/proy/`.
+
+## 📅 Fases de Implementación
+
+### **Fase 1: Estructura y Lógica Base (Completado)**
+- [x] **1.A:** Desarrollo de `adn/tools/proy/proy.rb` para despacho de comandos.
+- [x] **1.B:** Implementación de `GeneradorProy` en `generador.rb` con lógica de rutas inteligentes.
+- [x] **1.C:** Integración de plantillas dinámicas en `plantillas.rb`.
+
+### **Fase 2: Integración al Ecosistema (Completado)**
+- [x] **2.A:** Registro del subcomando `proy` en el entrypoint principal `adn/tools/run`.
+- [x] **2.B:** Soporte para parámetros avanzados (`--proy`, `--fase`) y normalización de títulos.
+| **2.C** | ✅ | Validación de creación automática de directorios según código de proyecto. |
+
+---
+
+## 📊 Progreso
+
+```
+Fase 1: ██████████ 100%  Estructura y Lógica Base
+Fase 2: ██████████ 100%  Integración al Ecosistema
+```
+
+---
+
+## 📑 Plantillas Disponibles
+
+La herramienta `proy` permite generar los siguientes componentes estandarizados:
+
+| Tipo | Propósito | Formato |
+| :--- | :--- | :--- |
+| **`plan`** | Plan de ejecución principal de una fase | `PROY.FASE_Titulo.md` |
+| **`subplan`** | Detalle técnico o procedimiento específico | `PROY.FASE_Subplan.md` |
+| **`mejora`** | Propuesta o registro de mejora puntual | `PROY.FASE_Mejora.md` |
+| **`incidente`** | Documentación de fallos y su resolución | `PROY.FASE_Incidente.md` |
+| **`tarea`** | Seguimiento de una tarea individual compleja | `PROY.FASE_Tarea.md` |
+
+### 🚀 Ejemplos de Uso
+
+```bash
+# Crear un plan para la fase 2 del proyecto P2604
+./adn/tools/run proy nuevo plan --proy:P2604 --fase:02 "Generación de Documentos"
+
+# Crear un registro de mejora sin fase específica
+./adn/tools/run proy nuevo mejora --proy:P2601 "Optimización de Red"
+
+# Crear una tarea dentro de una fase
+./adn/tools/run proy nuevo tarea --proy:P2602 --fase:1.2 "Validación rclone"
+```
+
+> 💡 **Nota**: Todos los archivos generados incluyen automáticamente la sección de **📊 Progreso** con barras Unicode pre-configuradas al 0% o con ejemplos listos para editar.
+
+---
+
+## 🔗 Referencias
+- **Herramienta:** `adn/tools/proy/`
+- **EntryPoint:** `adn/tools/run proy`
+- **Gobernanza:** [06_gobernanza.md](../../../adn/06_gobernanza.md)