specleap-framework 2.0.0

package/.commands/planificar.md

@@ -0,0 +1,253 @@
+# Comando: planificar
+
+**Sintaxis:** `planificar` o `planificar <ruta-proyecto>`
+
+**Objetivo:** Generar secciones y tareas desde el CONTRATO.md y subirlas a Asana.
+
+**Motor:** Usa `scripts/generate-asana-structure.sh` (CLI) para generación de backlog.
+
+---
+
+## 🌐 Idioma
+
+**TODOS los mensajes de feedback deben estar en ESPAÑOL.**
+
+Esto incluye:
+- Mensajes de progreso ("Generando backlog...", "Analizando CONTRATO...")
+- Vista previa de épicas y stories
+- Mensajes de confirmación
+- Errores y advertencias
+
+---
+
+## Flujo
+
+### 1. Identificar Proyecto
+
+Si no se especifica ruta:
+```markdown
+¿Para qué proyecto quieres crear el backlog?
+
+**Proyectos disponibles:**
+1. app-tienda
+2. api-backend
+3. dashboard-analytics
+
+Responde con el número o nombre:
+```
+
+---
+
+### 2. Leer CONTRATO.md
+
+```bash
+cat proyectos/[proyecto]/CONTRATO.md
+```
+
+Extraer:
+- Nombre del proyecto
+- Features core
+- Features secundarias
+
+---
+
+### 3. Generar Backlog (Usar CLI)
+
+```bash
+cd specleap
+./scripts/generate-asana-structure.sh -p proyectos/[proyecto]
+```
+
+Esto genera:
+- Proyecto en Asana
+- Secciones (Infraestructura, Backend, Frontend, Testing)
+- Tareas (3-8 por sección)
+- Story points asignados en notas
+- Prioridades
+
+---
+
+### 4. Confirmación
+
+Mostrar al usuario:
+```markdown
+📊 **Backlog Generado — Preview**
+
+**Proyecto:** [Nombre]
+
+🛠️ **Infraestructura** (3 tareas, 11 pts)
+  - Setup inicial del proyecto [3 pts]
+  - Configurar CI/CD [5 pts]
+  - Configurar entornos (dev/staging/prod) [3 pts]
+
+⚙️ **Backend** (5-8 tareas, 25-40 pts)
+  - Implementar API REST básica [8 pts]
+  - Implementar autenticación [5 pts]
+  - Implementar autorización (roles) [5 pts]
+  - ...
+
+🎨 **Frontend** (3 tareas, 16 pts)
+  - Implementar sistema de diseño base [8 pts]
+  - Implementar autenticación UI [5 pts]
+  - Implementar navegación principal [3 pts]
+
+🧪 **Testing** (3 tareas, 13 pts)
+  - Tests unitarios backend (>=90% coverage) [5 pts]
+  - Tests E2E críticos [5 pts]
+  - Tests de integración [3 pts]
+
+**Resumen:**
+- Secciones: 4
+- Tareas: 14-17
+- Story Points: 65-80
+- Esfuerzo estimado: ~40-50 días
+
+¿Crear este backlog en Asana? (s/n)
+```
+
+---
+
+### 5A. Si el usuario acepta: Crear en Asana
+
+```bash
+# Crear proyecto y tareas en Asana
+./scripts/generate-asana-structure.sh -p proyectos/[proyecto]
+```
+
+Esto:
+- Crea proyecto en Asana
+- Crea secciones (Infraestructura, Backend, Frontend, Testing)
+- Crea tareas vinculadas a secciones
+- Asigna story points en notas
+
+**Mostrar confirmación:**
+```markdown
+✅ **Backlog creado en Asana**
+
+**Proyecto:** https://app.asana.com/0/[PROJECT_GID]
+
+**Secciones creadas:**
+- 🛠️ Infraestructura (3 tareas)
+- ⚙️ Backend (5-8 tareas)
+- 🎨 Frontend (3 tareas)
+- 🧪 Testing (3 tareas)
+
+**Actualizar CONTRATO.md con metadata:**
+```yaml
+asana:
+  project_gid: "[PROJECT_GID]"
+  section_count: 4
+  task_count: 14-17
+  synced_at: 2026-03-06T20:00:00Z
+```
+
+✅ CONTRATO.md actualizado.
+
+**Próximos pasos:**
+1. Revisa el proyecto en Asana
+2. Prioriza las tareas
+3. Asigna tareas a miembros del equipo
+4. Ejecuta `implementar` cuando estés listo
+```
+
+---
+
+### 5B. Si el usuario NO acepta: Modo Dry-Run
+
+Usuario puede usar modo dry-run para ver preview sin crear nada:
+
+```bash
+./scripts/generate-asana-structure.sh -p proyectos/[proyecto] --dry-run
+```
+
+```markdown
+💾 **Preview generado (sin crear en Asana)**
+
+Ejecuta sin `--dry-run` cuando estés listo para crear el backlog real.
+```
+
+Ejecuta sin `--dry-run` cuando estés listo para crear el backlog real.
+```
+
+---
+
+## Comandos CLI/Scripts Usados
+
+| Comando | Propósito |
+|---------|-----------|
+| `scripts/generate-asana-structure.sh` | Generar proyecto y tareas en Asana desde CONTRATO.md |
+| `scripts/create-asana-tasks.sh` | Crear tareas individuales en Asana |
+| `scripts/lib/asana-utils.sh` | Utilidades de API Asana |
+
+---
+
+## Personalización
+
+### Ajustar generación de tareas
+
+Edita `scripts/generate-asana-structure.sh`:
+- Líneas 145-200: Secciones y tareas generadas
+- Story points asignados por tipo de tarea
+- Nombres de secciones personalizados
+
+### Crear tareas individuales
+
+```bash
+# Listar proyectos
+./scripts/create-asana-tasks.sh --listar
+
+# Crear tarea
+./scripts/create-asana-tasks.sh \
+  -p [PROJECT_GID] \
+  -t "Nombre de la tarea" \
+  -P 5
+```
+
+---
+
+## Requisitos
+
+1. **CONTRATO.md** existente
+2. **ASANA_ACCESS_TOKEN** configurado en ~/.zshrc
+3. **ASANA_WORKSPACE_GID** configurado (o se detecta automáticamente)
+
+---
+
+## Troubleshooting
+
+### "Script no encontrado"
+
+```bash
+cd ~/.openclaw/workspace/specleap
+ls scripts/generate-asana-structure.sh
+# Si no existe, verifica instalación
+```
+
+### "ASANA_ACCESS_TOKEN no configurado"
+
+```bash
+# Verifica que está en tu ~/.zshrc
+grep ASANA_ACCESS_TOKEN ~/.zshrc
+
+# Si no está, agrégalo:
+echo 'export ASANA_ACCESS_TOKEN="tu-token-aqui"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+### "Error: Not Authorized"
+
+Tu token de Asana puede haber expirado. Genera uno nuevo en:
+https://app.asana.com/0/my-apps
+
+---
+
+## Workflow Típico
+
+1. `/inicio` → genera CONTRATO.md
+2. **`planificar`** → crea backlog en Asana ✅ **ESTÁS AQUÍ**
+3. Asigna tareas en Asana
+4. `implementar` → desarrolla features
+
+---
+
+**Próximo paso:** Revisa el proyecto en Asana y asigna tareas

package/.commands/refinar.md

@@ -0,0 +1,306 @@
+# Comando: refinar
+
+**Sintaxis:** `refinar [TASK_GID]` o `refinar [nombre-tarea]`
+
+**Objetivo:** Refinar una tarea de Asana para que sea completa, específica y lista para implementación técnica.
+
+**Motor:** Usa `openspec enrich` (CLI) para el refinamiento con AI.
+
+---
+
+## 🌐 Idioma
+
+**TODOS los mensajes y análisis deben estar en ESPAÑOL.**
+
+Esto incluye:
+- User stories refinadas
+- Criterios de aceptación
+- Preguntas de clarificación
+- Análisis de complejidad
+- Recomendaciones
+
+---
+
+## Flujo
+
+### 1. Leer Tarea de Asana
+
+**Obtener tarea por GID:**
+
+```bash
+source scripts/lib/asana-utils.sh
+curl -s -H "Authorization: Bearer $ASANA_ACCESS_TOKEN" \
+  "https://app.asana.com/api/1.0/tasks/[TASK_GID]" | jq '.data'
+```
+
+**Si el usuario proporciona nombre de tarea:**
+
+Buscar en el proyecto:
+```bash
+source scripts/lib/asana-utils.sh
+asana_list_tasks [PROJECT_GID] | grep -i "[nombre-tarea]"
+```
+
+**Si no se encuentra:**
+```markdown
+No encontré esa tarea en Asana.
+
+Por favor, proporciona:
+1. El GID de la tarea (número largo)
+2. O el título exacto de la tarea
+3. O pega aquí el contenido completo de la tarea
+```
+
+Espera la respuesta del usuario.
+
+---
+
+### 2. Leer Contexto del Proyecto
+
+Lee los siguientes archivos para entender el proyecto:
+
+1. `proyectos/[proyecto-actual]/CONTRATO.md`
+2. `proyectos/[proyecto-actual]/context/architecture.md`
+3. `proyectos/[proyecto-actual]/context/tech-stack.md`
+4. `proyectos/[proyecto-actual]/context/conventions.md`
+
+**Nota:** El proyecto actual se determina por el último comando `/inicio` ejecutado, o pregunta cuál es si no está claro.
+
+---
+
+### 3. Preparar Input para CLI
+
+Crea un archivo temporal con la user story + contexto:
+
+```bash
+cat > /tmp/user-story-input.md <<EOF
+# User Story Original
+$TICKET_CONTENT
+
+# Contexto del Proyecto
+
+## Stack
+$TECH_STACK
+
+## Arquitectura
+$ARCHITECTURE
+
+## Convenciones
+$CONVENTIONS
+EOF
+```
+
+---
+
+### 4. Refinar con CLI
+
+Ejecuta el refinamiento usando CLI:
+
+```bash
+openspec enrich --file /tmp/user-story-input.md --output /tmp/user-story-refined.md
+```
+
+Esto genera una user story completa con:
+- Contexto técnico
+- Criterios de aceptación (GIVEN/WHEN/THEN)
+- Especificación técnica (endpoints, componentes, DB)
+- Validaciones
+- Reglas de negocio
+- Estimación
+- Riesgos
+- Fuera de alcance
+
+---
+
+### 5. Mostrar Preview
+
+Lee el resultado:
+
+```bash
+cat /tmp/user-story-refined.md
+```
+
+Muestra al usuario:
+
+```markdown
+📋 **Tarea Refinada (Preview):**
+
+[Primeras 30 líneas del contenido refinado]
+
+...
+
+**¿Aprobar y actualizar Asana?** (s/n)
+```
+
+Espera confirmación del usuario.
+
+---
+
+### 6A. Si el usuario aprueba: Actualizar Asana
+
+```bash
+# Actualizar tarea en Asana
+source scripts/lib/asana-utils.sh
+
+# Leer contenido refinado
+REFINED_CONTENT=$(cat /tmp/user-story-refined.md)
+
+# Actualizar notas de la tarea
+curl -s -X PUT \
+  -H "Authorization: Bearer $ASANA_ACCESS_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d "{\"data\": {\"notes\": \"$REFINED_CONTENT\"}}" \
+  "https://app.asana.com/api/1.0/tasks/[TASK_GID]"
+```
+
+**También guardar localmente:**
+
+```bash
+cp /tmp/user-story-refined.md proyectos/[proyecto]/specs/task-[TASK_GID]_refined.md
+```
+
+**Mostrar confirmación:**
+```markdown
+✅ **Tarea actualizada en Asana**
+
+📋 **Local:** `proyectos/[proyecto]/specs/task-[TASK_GID]_refined.md`
+
+📊 **Ver en Asana:** https://app.asana.com/0/[PROJECT_GID]/[TASK_GID]
+
+**Próximos pasos:**
+1. Revisa la tarea refinada en Asana
+2. Asigna la tarea a un desarrollador
+3. Ejecuta `implementar` cuando estés listo
+```
+
+---
+
+### 6B. Si el usuario NO aprueba: Editar
+
+```markdown
+**¿Qué quieres modificar?**
+
+Puedes decir cosas como:
+- "Agrega que debe soportar OAuth"
+- "Cambia la estimación a 5 días"
+- "Elimina el criterio de aceptación 3"
+- "Agrega validación de email único"
+```
+
+Espera feedback, edita `/tmp/user-story-refined.md` y vuelve al paso 5.
+
+---
+
+### 7. Confirmar Actualización
+
+```markdown
+✅ **Tarea refinada exitosamente.**
+
+**Agregado:**
+- ✅ [X] criterios de aceptación (GIVEN/WHEN/THEN)
+- ✅ Especificación técnica completa
+- ✅ Validaciones (server + client)
+- ✅ Estimación: [X días]
+
+**Ubicación:**
+- Asana: https://app.asana.com/0/[PROJECT_GID]/[TASK_GID]
+- Local: `proyectos/[proyecto]/specs/task-[TASK_GID]_refined.md`
+
+🔄 **Próximo paso:**
+- Ejecuta `implementar` para comenzar el desarrollo
+```
+
+---
+
+## Ejemplos de Uso
+
+### Ejemplo 1: Con GID de Asana
+
+```
+Usuario: "refinar 1234567890123456"
+
+IA:
+📥 Leyendo tarea de Asana...
+✅ Tarea leída: "Implementar sistema de login"
+
+📚 Cargando contexto del proyecto...
+✅ CONTRATO.md, architecture.md, tech-stack.md, conventions.md cargados.
+
+🤖 Refinando con openspec enrich...
+✅ Tarea refinada (7 criterios de aceptación, 4 endpoints API, validaciones).
+
+📋 Preview:
+[Muestra primeras 30 líneas]
+
+¿Aprobar y actualizar Asana? (s/n)
+
+Usuario: "s"
+
+IA:
+✅ Tarea actualizada en Asana.
+✅ Guardada localmente en specs/task-1234567890123456_refined.md
+
+Próximo: implementar
+```
+
+### Ejemplo 2: Por nombre de tarea
+
+```
+Usuario: "refinar login"
+
+IA:
+🔍 Buscando tarea 'login' en el proyecto...
+✅ Encontrada: "Implementar sistema de login" (GID: 1234567890123456)
+
+📚 Cargando contexto...
+✅ Contexto cargado.
+
+🤖 Refinando con openspec enrich...
+✅ Tarea refinada.
+
+📋 Preview:
+[Muestra contenido]
+
+¿Aprobar? (s/n)
+
+Usuario: "s"
+
+IA:
+✅ Tarea actualizada en Asana
+✅ Guardado en specs/task-1234567890123456_refined.md
+
+📊 Ver en Asana: https://app.asana.com/0/[PROJECT_GID]/1234567890123456
+```
+
+---
+
+## Comandos CLI Usados
+
+| Comando | Propósito |
+|---------|-----------|
+| `scripts/lib/asana-utils.sh` | Utilidades para API de Asana |
+| `curl ... /api/1.0/tasks/[GID]` | Leer tarea de Asana |
+| `openspec enrich --file <input> --output <output>` | Refinar tarea con AI |
+| `curl -X PUT ... /api/1.0/tasks/[GID]` | Actualizar tarea en Asana |
+
+---
+
+## Reglas Críticas
+
+1. **SIEMPRE usar CLI** — Delegar refinamiento a `openspec enrich`
+2. **Leer CONTRATO.md** — Alinear refinamiento con contrato
+3. **Preview antes de actualizar** — Pedir confirmación al usuario
+4. **Guardar localmente** — Siempre guardar en specs/ además de actualizar Asana
+5. **No asumir** — Si falta contexto, preguntar
+
+---
+
+## Agente Relacionado
+
+- `.agents/producto.md` — El CLI `openspec enrich` sigue este rol
+
+---
+
+## Próximo Comando
+
+- `implementar` — Comenzar el desarrollo de la tarea refinada

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SpecLeap Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.