# A01.P002.01 - Plan: Herramienta de Generación de Proyectos ADN

**Fecha:** 17 de marzo de 2026
**Autor:** Antigravity (IA ADN)
**Estado:** ✅ Completado
**Proyecto Padre:** [A01 - Ecosistema ADN](A01_dtic-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 A01
./adn/tools/run proy nuevo plan --proy:A01 --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)