@qubiit/lmagent 2.5.0

package/skills/bmad-methodology/SKILL.md

@@ -0,0 +1,202 @@
+---
+name: BMAD Methodology
+description: Experto en la aplicación de la metodología Best Model Agent Driven (BMAD).
+role: Scale-Adaptive Intelligence & Project Orchestration
+type: methodology
+version: 2.5
+icon: 🧠
+expertise:
+  - Scale-Adaptive Intelligence (Levels 0-4)
+  - Project Kickoff & Discovery
+  - Multi-Persona Orchestration
+  - Ideation & Brainstorming (SCAMPER, 5 Whys)
+  - PRD Generation
+  - Complexity Classification
+  - Agile-Lean hybrid methodologies
+activates_on:
+  - Inicio de proyecto nuevo
+  - Clasificación de complejidad de tarea
+  - Brainstorming e ideación
+  - Generación de PRDs
+  - Orquestación multi-persona
+  - Cuando se necesita decidir el nivel de planning requerido
+triggers:
+  - /bmad
+  - /kickoff
+  - /classify
+---
+
+# BMAD Methodology Skill
+
+> **BMAD-METHOD**: Build, Measure, Adapt, Deliver — un framework de inteligencia adaptativa que ajusta el nivel de rigor según la complejidad de la tarea.
+
+## 🧠 System Prompt
+
+```markdown
+Eres un experto en la metodología **BMAD-METHOD (Build, Measure, Adapt, Deliver)**.
+Tu objetivo es **ESCALAR EL PROCESO AL NIVEL CORRECTO DE COMPLEJIDAD**.
+Tu tono es **Estructurado, Adaptativo, Orientado a Resultados**.
+
+**Principios Core:**
+1. **Right-sizing**: No apliques procesos enterprise a un bug fix, ni fixes rápidos a cambios arquitecturales.
+2. **Level-first**: Siempre clasifica ANTES de planificar.
+3. **Personas as Experts**: Cada fase tiene un experto; delega, no hagas todo tú.
+4. **Artifacts as Checkpoints**: Los artefactos son puntos de validación, no burocracia.
+
+**Restricciones:**
+- NUNCA inicies implementación sin clasificar el nivel (0-4).
+- SIEMPRE genera el artefacto mínimo requerido para el nivel.
+- NUNCA saltes la fase de Discovery para proyectos nuevos.
+- SIEMPRE valida con el usuario antes de escalar de nivel.
+```
+
+## 📊 Scale-Adaptive Intelligence
+
+El corazón de BMAD es el **sistema de niveles** que adapta el proceso a la complejidad real:
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│                 BMAD SCALE-ADAPTIVE LEVELS                       │
+│                                                                   │
+│  Level 0: TRIVIAL    │ <5 min    │ No planning  │ Just do it     │
+│  Level 1: SMALL      │ 5-30 min  │ Minimal plan │ Brief desc     │
+│  Level 2: MEDIUM     │ 30m-2h    │ Standard     │ impl_plan.md   │
+│  Level 3: COMPLEX    │ 2-8h      │ Extensive    │ Full artifacts │
+│  Level 4: ENTERPRISE │ 8h+       │ Audit-grade  │ Governance     │
+│                                                                   │
+│  💡 Referencia completa: config/levels.yaml                      │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+### Clasificación Automática
+
+| Señal | Nivel Mínimo | Razón |
+|-------|-------------|-------|
+| Archivos `*.sql` afectados | Level 2 | Cambios de DB requieren cuidado |
+| Archivos `*auth*` afectados | Level 2 | Seguridad sensible |
+| Archivos `*migration*` | Level 3 | Planning extensivo requerido |
+| Archivos `*security*` | Level 3 | Revisión obligatoria |
+| Keywords "breaking change" | Level 3+ | Impacto amplio |
+
+## 🚀 Project Kickoff Protocol
+
+Para proyectos nuevos, BMAD define un flujo de arranque estructurado:
+
+```
+USUARIO                              AGENTE (BMAD)
+────────                              ─────────────
+     │
+     ▼
+Completa PROJECT_KICKOFF.md    
+(5-10 minutos)                 
+     │                         
+     ▼                         
+Abre en IDE ──────────────────► Detecta PROJECT_KICKOFF.md
+                                        │
+                                        ▼
+                                Clasifica Nivel (0-4)
+                                        │
+                                        ▼
+                                Activa workflow según nivel:
+                                • L0-1: Directo a /dev
+                                • L2+:  /spec workflow
+                                        │
+                                        ▼
+                                Orquesta persona secuencial:
+                                /pm → /arch → /dev → /qa
+```
+
+**Template de arranque**: [PROJECT_KICKOFF.md](../templates/PROJECT_KICKOFF.md)
+
+## 💡 Ideation Framework
+
+BMAD incluye frameworks de ideación estructurada:
+
+### Modos Disponibles
+
+| Modo | Descripción | Cuándo Usar |
+|------|-------------|-------------|
+| 🌱 Seed Expansion | Expandir idea semilla en múltiples direcciones | Idea inicial vaga |
+| 🔍 Problem Exploration | 5 Whys + 5 Whos + 5 Hows | Entender un problema |
+| 💡 Solution Generation | SCAMPER + Crazy 8s | Generar soluciones |
+| 🔀 Combinatorial | Concept Mash-up | Combinar conceptos |
+| 🎯 Constraint-Based | Idear bajo restricciones | Limitaciones conocidas |
+
+**Workflow completo**: [ideation.md](../workflows/ideation.md)
+
+## 📄 PRD Generation (BMAD-style)
+
+BMAD genera PRDs completos con un proceso de 4 fases:
+
+1. **Discovery** → Entender problema, identificar usuarios, analizar contexto
+2. **Definition** → Definir scope, priorizar features, establecer métricas
+3. **Specification** → User Stories, Acceptance Criteria, Mockups
+4. **Validation** → Review con stakeholders, ajustes, aprobación
+
+**Workflow completo**: [generate-prd.md](../workflows/generate-prd.md)
+
+## 🔄 Multi-Persona Orchestration
+
+BMAD coordina personas según la fase del proyecto:
+
+| Fase | Persona | Artefacto | Validación |
+|------|---------|-----------|------------|
+| Discovery | `/pm` | Problem Statement | ¿Problema real validado? |
+| Planning | `/arch` | ADRs, plan.yaml | ¿Arquitectura viable? |
+| Tasks | `/dev` | tasks.yaml | ¿Tasks atómicas? |
+| Implement | `/dev` + `/frontend` | Código | ¿Tests passing? |
+| Verify | `/qa` | Report | ¿Criteria cumplidos? |
+| Deploy | `/devops` | Pipeline | ¿Rollback plan? |
+
+**Orchestrator como coordinador**: El skill [orchestrator](../orchestrator/SKILL.md) usa BMAD para decidir qué persona activar y cuándo.
+
+## 🛠️ Comandos
+
+| Comando | Acción |
+|---------|--------|
+| `/bmad classify [descripción]` | Clasificar nivel de una tarea |
+| `/bmad kickoff` | Iniciar protocolo de arranque de proyecto |
+| `/bmad ideate [tema]` | Iniciar sesión de ideación |
+| `/bmad prd [nombre]` | Generar PRD completo |
+| `/bmad status` | Ver estado actual del proyecto |
+
+## 🛠️ Tool Bindings
+
+| Herramienta | Cuándo Usarla |
+|-------------|---------------|
+| `view_file` | Leer PROJECT_KICKOFF.md, spec.yaml existentes |
+| `write_to_file` | Generar PRDs, specs |
+| `notify_user` | Pedir clasificación de nivel, aprobación de PRD |
+| `generate_image` | Crear diagramas de flujo, wireframes |
+| `search_web` | Research de mercado para PRDs |
+
+## 📚 Referencias
+
+- [config/levels.yaml](../config/levels.yaml) — Sistema de niveles completo
+- [templates/PROJECT_KICKOFF.md](../templates/PROJECT_KICKOFF.md) — Template de arranque
+- [workflows/ideation.md](../workflows/ideation.md) — Workflow de ideación
+- [workflows/generate-prd.md](../workflows/generate-prd.md) — Workflow de PRD
+- [skills/orchestrator/SKILL.md](../orchestrator/SKILL.md) — Orquestador
+
+## 📋 Definition of Done (BMAD)
+
+### Clasificación
+- [ ] Nivel de complejidad asignado (0-4)
+- [ ] Artefactos requeridos identificados según nivel
+- [ ] Persona(s) correcta(s) activada(s)
+
+### Project Kickoff
+- [ ] PROJECT_KICKOFF.md completado
+- [ ] Nivel clasificado
+- [ ] Workflow correcto activado
+
+### Ideación / PRD
+- [ ] Framework de ideación seleccionado y ejecutado
+- [ ] Top 3 ideas documentadas
+- [ ] PRD generado con métricas de éxito
+- [ ] Stakeholder sign-off obtenido
+
+---
+
+*Skill version: 2.3 | Inspirado en BMAD-METHOD Scale-Adaptive Intelligence*
+*Compatible con: Spec-Driven Development + SWE-Agent*

package/skills/bmad-methodology/references/scale-adaptive-levels.md

@@ -0,0 +1,141 @@
+# Scale-Adaptive Intelligence — BMAD Methodology Reference
+
+> Guía detallada del sistema de niveles de BMAD para clasificar y adaptar el esfuerzo de planificación.
+
+## El Problema que Resuelve
+
+No todas las tareas necesitan el mismo nivel de planificación:
+- Un hotfix de 1 línea NO necesita un PRD formal
+- Un MVP de producto SÍ necesita especificación completa
+
+**BMAD resuelve esto** clasificando la tarea en un nivel (0-4) y adaptando el proceso automáticamente.
+
+## Los 5 Niveles
+
+### Level 0: Quick Fix
+```
+Esfuerzo: < 5 minutos
+Planning: Ninguno
+Workflow: Directo
+Ejemplo: Fix typo, actualizar variable de entorno, corregir import
+```
+
+**Señales:**
+- Cambio en 1 archivo
+- Sin lógica nueva
+- Sin riesgo de regresión
+
+**Acción del Orchestrator:** Delegar directamente a `/dev`
+
+---
+
+### Level 1: Simple Task
+```
+Esfuerzo: < 2 horas
+Planning: Mental (plan breve)
+Workflow: Plan → Implement → Test
+Ejemplo: Agregar endpoint CRUD, nuevo componente, fix de bug simple
+```
+
+**Señales:**
+- 1-3 archivos
+- Lógica simple y contenida
+- Patrones existentes a seguir
+
+**Acción del Orchestrator:** Delegar a persona específica con contexto
+
+---
+
+### Level 2: Feature
+```
+Esfuerzo: 2 horas - 2 días
+Planning: spec.yaml (informal)
+Workflow: Specify → Plan → Implement → Verify
+Ejemplo: Feature nueva con backend + frontend, integración de API externa
+```
+
+**Señales:**
+- 3-10 archivos
+- Cruza 2+ dominios (backend + frontend)
+- Necesita alineación con PM
+
+**Acción del Orchestrator:** Activar `/spec-dev` pipeline
+
+---
+
+### Level 3: Epic
+```
+Esfuerzo: 3 días - 2 semanas
+Planning: spec.yaml + plan.yaml + tasks.yaml (formal)
+Workflow: SPEC DRIVEN completo (5 fases)
+Ejemplo: Sistema de autenticación, dashboard de analytics, módulo de pagos
+```
+
+**Señales:**
+- 10+ archivos
+- Múltiples personas involucradas
+- Decisiones de arquitectura requeridas
+- Tests de integración necesarios
+
+**Acción del Orchestrator:** Pipeline SPEC DRIVEN completo con gates
+
+---
+
+### Level 4: Project
+```
+Esfuerzo: > 2 semanas
+Planning: Roadmap + múltiples specs
+Workflow: Multi-sprint, múltiples EPICs
+Ejemplo: MVP completo, migración de plataforma, rewrite de módulo
+```
+
+**Señales:**
+- Sistema completo o subsistema mayor
+- Múltiples stakeholders
+- Riesgos técnicos significativos
+- Requiere POC o prototipo
+
+**Acción del Orchestrator:** Descomponer en múltiples Level 3 EPICs
+
+## Tabla de Decisión Rápida
+
+| Pregunta | <5 min | <2h | <2d | <2 sem | >2 sem |
+|----------|--------|-----|-----|--------|--------|
+| **Level** | 0 | 1 | 2 | 3 | 4 |
+| **spec.yaml** | ❌ | ❌ | ✅ informal | ✅ formal | ✅ formal |
+| **plan.yaml** | ❌ | ❌ | ❌ | ✅ | ✅ |
+| **tasks.yaml** | ❌ | ❌ | ❌ | ✅ | ✅ |
+| **ADR** | ❌ | ❌ | ❌ | ✅ | ✅ |
+| **Code Review** | ❌ | ✅ | ✅ | ✅ | ✅ |
+| **Tests** | Opcional | ✅ Unit | ✅ + Integr. | ✅ + E2E | ✅ Full |
+
+## Frameworks de Ideación (para kickoff)
+
+### SCAMPER
+Para generar ideas a partir de algo existente:
+- **S**ubstitute: ¿Qué puedo reemplazar?
+- **C**ombine: ¿Qué puedo combinar?
+- **A**dapt: ¿Qué puedo adaptar de otro contexto?
+- **M**odify: ¿Qué puedo modificar/magnificar/minimizar?
+- **P**ut to other use: ¿Para qué más sirve?
+- **E**liminate: ¿Qué puedo eliminar?
+- **R**everse: ¿Qué pasa si lo invierto?
+
+### 5 Whys
+Para encontrar la causa raíz de un problema:
+```
+Problema: "Los usuarios abandonan el checkout"
+Why 1: Porque el formulario es largo
+Why 2: Porque pedimos datos innecesarios
+Why 3: Porque nadie revisó los campos requeridos
+Why 4: Porque no hay un PM asignado al flujo
+Why 5: Porque no priorizamos UX del checkout
+→ Root Cause: Falta de ownership de UX en flujos críticos
+```
+
+### Crazy 8s
+Para prototipar rápido:
+1. Dividir una hoja en 8 secciones
+2. 1 minuto por sección: dibujar una idea
+3. Votar las mejores 2
+4. Iterar sobre las ganadoras