@qubiit/lmagent 2.5.0

package/templates/PROJECT_KICKOFF.md

@@ -0,0 +1,284 @@
+# 🚀 PROJECT KICKOFF
+## LMAgent Framework v3.0 (SPEC+LM)
+
+> **🤖 AGENTE DE IA**: Si detectas este archivo, activa el **AUTO-START PROTOCOL** (ver final del documento).
+> 
+> Si las secciones están vacías `[...]`, activa el **MODO INTERACTIVO** y haz las preguntas al usuario.
+
+---
+
+# INFORMACIÓN DEL PROYECTO
+
+## 1. Visión del Producto 🔭
+
+### Nombre del Proyecto
+<!-- Nombre clave o final del proyecto -->
+```
+[Escribe el nombre aquí]
+```
+> *Ejemplo: "AgentFlow 2026" o "NutriTrack AI"*
+
+### Elevator Pitch
+<!-- En UNA frase: ¿Qué es y para quién? Máximo 280 caracteres -->
+```
+[Describe tu producto aquí]
+```
+> *Ejemplo: "Un asistente de IA que organiza automáticamente la agenda de médicos conectándose a WhatsApp y Google Calendar, reduciendo el ausentismo de pacientes en un 40%."*
+
+### Tipo de Proyecto
+<!-- Marca UNA opción con [x] -->
+- [ ] **MVP (Speed)** - Validar idea rápido, priorizar velocidad sobre perfección
+- [ ] **Producto Escalable (Quality)** - Arquitectura limpia, TDD, para producción
+- [ ] **Prototipo/Demo** - Visualmente impactante, puede tener mocks
+- [ ] **Herramienta Interna** - Utilidad sobre estética
+
+---
+
+## 2. Usuarios y Problema 👥
+
+### Usuario Principal
+<!-- ¿Quién usará esto principalmente? -->
+```
+Rol: [ej: Contador, Médico, Developer]
+Edad/Perfil: [ej: 40+ años, poco tecnológico]
+Contexto: [ej: Usa principalmente celular, prefiere WhatsApp]
+```
+> *Ejemplo: "Médico Cardiólogo: 50+ años, poco tecnológico, usa voz para notas."*
+
+### Usuario Secundario (opcional)
+```
+Rol: [ej: Cliente del usuario principal]
+Contexto: [ej: Quiere confirmar turno sin instalar apps]
+```
+> *Ejemplo: "Paciente: Quiere confirmar turno por WhatsApp sin instalar apps."*
+
+### Problema Principal a Resolver
+<!-- ¿Qué dolor específico resuelves? Sé concreto con números si es posible. -->
+```
+[Describe el problema aquí]
+```
+> *Ejemplo: "El médico pierde 2 horas diarias confirmando turnos manualmente por teléfono."*
+
+### ¿Por qué ahora?
+<!-- ¿Por qué este problema es urgente? -->
+```
+[Explica la urgencia]
+```
+
+---
+
+## 3. Funcionalidades Clave ✨
+
+### 🟢 MUST HAVE (MVP)
+<!-- Sin esto, el producto NO funciona. Máximo 5 items. -->
+1. [Feature 1]
+   > *Ej: "Chatbot en WhatsApp que entienda lenguaje natural."*
+2. [Feature 2]
+   > *Ej: "Sincronización bi-direccional con Google Calendar."*
+3. [Feature 3]
+4. [Feature 4]
+5. [Feature 5]
+
+### 🟡 SHOULD HAVE (v1.1)
+<!-- Importante pero puede esperar a la siguiente versión -->
+1. [Feature extra 1]
+   > *Ej: "Recordatorios automáticos 24hs antes."*
+2. [Feature extra 2]
+
+### 🔴 OUT OF SCOPE (NO hacer ahora)
+<!-- Explícitamente excluido para evitar scope creep -->
+1. [Lo que NO haremos]
+   > *Ej: "Pagos online (se hará en Q3)."*
+2. [Otra cosa que NO haremos]
+
+---
+
+## 4. Stack Tecnológico 🛠️
+
+> **Instrucción**: Marca con [x] lo que prefieras. Si no sabes, deja TODO vacío y el Architect decidirá lo mejor para tu caso.
+
+### Frontend
+- [ ] **Next.js 15+ / React 19** *(Recomendado para web apps)*
+- [ ] **React Native / Expo** *(Apps móviles)*
+- [ ] **Vue 3 / Nuxt 4** *(Alternativa a React)*
+- [ ] **Sin Frontend** *(Solo backend/API)*
+- [ ] **Otro**: _________
+
+### Backend
+- [ ] **Python 3.12+ (FastAPI)** *(Recomendado para IA/Agents)*
+- [ ] **Node.js 22+ (NestJS)** *(TypeScript estricto)*
+- [ ] **Go** *(Alto rendimiento)*
+- [ ] **Otro**: _________
+
+### Base de Datos
+- [ ] **PostgreSQL 16+** *(Recomendado - relacional + vectores)*
+- [ ] **Supabase** *(BaaS rápido con auth incluido)*
+- [ ] **MongoDB** *(Documentos)*
+- [ ] **Otro**: _________
+
+### Infraestructura
+- [ ] **Docker Compose** *(Desarrollo local standard)*
+- [ ] **Vercel** *(Fácil deploy para frontend)*
+- [ ] **Railway** *(Fácil con base de datos)*
+- [ ] **AWS/GCP** *(Enterprise)*
+
+### IA & Agents
+- [ ] **OpenAI (GPT-4o)** *(Más popular)*
+- [ ] **Anthropic (Claude)** *(Mejor para código)*
+- [ ] **Gemini (Google)** *(Multi-modal)*
+- [ ] **Local (Ollama)** *(Sin costo de API)*
+
+---
+
+## 5. Diseño y UX 🎨 (opcional)
+
+### Estilo Visual Preferido
+- [ ] **Neo-Brutalism** *(Tendencia 2025/26)*
+- [ ] **Glassmorphism / Apple Style** *(Elegante)*
+- [ ] **Minimal SaaS** *(Inter font, Tailwind)*
+- [ ] **Dark Mode First**
+- [ ] **Sin preferencia** *(el diseñador decide)*
+
+---
+
+## 6. Integraciones Externas 🔌 (opcional)
+
+<!-- ¿Con qué servicios debe conectarse? -->
+- [ ] WhatsApp Business API
+- [ ] Stripe / MercadoPago (Pagos)
+- [ ] Google Calendar / Outlook
+- [ ] Email (SendGrid, Resend)
+- [ ] Auth0 / Clerk (Autenticación)
+- [ ] Otro: _________
+
+---
+
+## 7. Restricciones 📅 (opcional)
+
+### Deadline
+```
+[Si hay fecha límite, escríbela. Ej: "Demo para inversores el 15 de marzo"]
+```
+
+### Presupuesto de Infraestructura
+```
+[Límite mensual. Ej: "$50/mes máximo en cloud"]
+```
+
+### Otras Restricciones
+```
+[Cualquier otra limitación técnica o de negocio]
+```
+
+---
+
+## 8. Métricas de Éxito 📊 (recomendado)
+
+<!-- ¿Cómo sabrás que el proyecto fue exitoso? -->
+| Métrica | Valor Actual | Meta |
+|---------|--------------|------|
+| [Ej: Tiempo de categorización] | [3 horas] | [10 minutos] |
+| [Ej: Usuarios activos] | [0] | [100 en primer mes] |
+| [Ej: NPS] | [N/A] | [> 50] |
+
+---
+
+## 9. Contexto Adicional 💬 (opcional)
+
+<!-- Links, documentos, competidores, diseños existentes -->
+```
+[Cualquier información extra que ayude a entender el proyecto]
+```
+
+---
+
+# ═══════════════════════════════════════════════════════════════════════════════
+#                           🤖 SECCIÓN PARA EL AGENTE
+# ═══════════════════════════════════════════════════════════════════════════════
+
+## AUTO-START PROTOCOL
+
+**Cuando detectes este archivo en la raíz del proyecto:**
+
+### Caso A: Template Completado (secciones tienen contenido)
+```
+1. Ejecutar: lmagent init (si no está inicializado)
+2. Leer PROJECT_KICKOFF.md completo
+3. Clasificar como Level 3-4 (proyecto nuevo)
+4. Ejecutar workflow /spec automáticamente:
+   - Crear specs/[project-name]/spec.yaml
+   - Mostrar al usuario → Pedir aprobación
+   - Crear specs/[project-name]/plan.yaml
+   - Mostrar al usuario → Pedir aprobación
+   - Crear specs/[project-name]/tasks.yaml
+   - Implementar tasks en orden
+5. Documentar todo en el proceso
+```
+
+### Caso B: Template Vacío o Incompleto (secciones tienen [...])
+```
+ACTIVAR MODO INTERACTIVO:
+
+1. Saludar al usuario:
+   "Detecté que este es un proyecto nuevo. Voy a hacerte algunas 
+   preguntas para entender qué quieres construir."
+
+2. Hacer preguntas en ESTE ORDEN (una a la vez):
+
+   Q1: "¿Cómo se llama tu proyecto? (nombre clave)"
+   
+   Q2: "En una frase, ¿qué es y para quién?"
+   
+   Q3: "¿Es un MVP rápido, un producto escalable, un prototipo/demo, 
+        o una herramienta interna?"
+   
+   Q4: "¿Quién es el usuario principal? Describe su perfil brevemente."
+   
+   Q5: "¿Qué problema específico resuelve? Sé concreto."
+   
+   Q6: "Dame 3-5 features que DEBEN estar en el MVP (sin esto no funciona)."
+   
+   Q7: "¿Hay alguna restricción de tecnología, deadline o presupuesto?"
+
+3. Con las respuestas, llenar el template internamente
+4. Continuar con Caso A (workflow /spec)
+```
+
+## Estructura de Salida Esperada
+
+```
+proyecto/
+├── PROJECT_KICKOFF.md    ← Este archivo (input del usuario)
+├── AGENTS.md             ← Copiado de LMAgent
+├── .lmagent              ← Marker del framework
+│
+├── specs/
+│   └── [project-name]/
+│       ├── spec.yaml     ← Generado por /pm
+│       ├── plan.yaml     ← Generado por /arch
+│       └── tasks.yaml    ← Generado por /dev
+│
+├── src/                  ← Código implementado
+├── tests/                ← Tests
+├── docs/                 ← Documentación
+│   └── adr/              ← Architecture Decision Records
+└── README.md             ← Generado automáticamente
+```
+
+## Validación de Completitud
+
+Considerar **COMPLETO** si tiene al menos:
+- [ ] Nombre del proyecto
+- [ ] Descripción/Pitch
+- [ ] Tipo de proyecto seleccionado
+- [ ] Usuario principal descrito
+- [ ] Problema definido
+- [ ] Al menos 2 MUST HAVE features
+
+Si faltan ≥3 de estos → Activar **MODO INTERACTIVO**.
+
+---
+
+**FIN DEL TEMPLATE**
+
+*LMAgent v3.0 (SPEC+LM) - Build More, Automate Dreams* 🚀

package/templates/SKILL_TEMPLATE.md

@@ -0,0 +1,131 @@
+---
+name: "[Nombre del Skill]"
+description: "[Descripción breve: qué hace este skill en una oración]"
+role: "[Rol profesional que desempeña]"
+type: agent_persona  # agent_persona | methodology
+version: 2.3
+icon: "🔧"
+expertise:
+  - "[Área de expertise 1]"
+  - "[Área de expertise 2]"
+  - "[Área de expertise 3]"
+activates_on:
+  - "[Contexto en que se activa 1]"
+  - "[Contexto en que se activa 2]"
+  - "[Contexto en que se activa 3]"
+triggers:
+  - "/[trigger1]"
+  - "/[trigger2]"
+---
+
+# [Nombre del Skill] Persona
+
+## 🧠 System Prompt
+> **Instrucciones para el LLM**: Copia este bloque en tu system prompt o contexto inicial.
+
+```markdown
+Eres **[Nombre]**, un experto en [dominio].
+Tu objetivo es **[OBJETIVO EN MAYÚSCULAS]**.
+Tu tono es **[Adjetivo 1, Adjetivo 2, Adjetivo 3]**.
+
+**Principios Core:**
+1. **[Principio 1]**: [Descripción]
+2. **[Principio 2]**: [Descripción]
+3. **[Principio 3]**: [Descripción]
+4. **[Principio 4]**: [Descripción]
+
+**Restricciones:**
+- NUNCA [restricción 1].
+- SIEMPRE [restricción 2].
+- SIEMPRE [restricción 3].
+- NUNCA [restricción 4].
+```
+
+## 🔄 Arquitectura Cognitiva (Cómo Pensar)
+
+### 1. Fase de Análisis
+Antes de actuar, pregúntate:
+- **Input**: ¿Qué se necesita?
+- **Contexto**: ¿Qué restricciones existen?
+- **Riesgo**: ¿Qué puede salir mal?
+- **Salida**: ¿Cuál es el resultado esperado?
+
+### 2. Fase de Diseño
+- Definir **estructura** del entregable.
+- Planear **enfoque** paso a paso.
+- Identificar **dependencias** y **bloqueantes**.
+
+### 3. Fase de Ejecución
+- Implementar según el plan.
+- Verificar en cada paso.
+- Documentar decisiones.
+
+### 4. Auto-Corrección
+Antes de finalizar, verifica:
+- "¿Cumple con los criterios de aceptación?"
+- "¿Sigue los patrones del proyecto?"
+- "¿Es mantenible y documentado?"
+
+---
+
+## Rol
+
+[Descripción extendida del rol: experiencia, fortalezas, enfoque]
+
+## Responsabilidades
+
+1. **[Responsabilidad 1]**: [Detalle]
+2. **[Responsabilidad 2]**: [Detalle]
+3. **[Responsabilidad 3]**: [Detalle]
+4. **[Responsabilidad 4]**: [Detalle]
+5. **[Responsabilidad 5]**: [Detalle]
+
+## Stack Técnico
+
+```
+[Tecnología 1]    → [Propósito]
+[Tecnología 2]    → [Propósito]
+[Tecnología 3]    → [Propósito]
+```
+
+## Patrones y Ejemplos
+
+```[lenguaje]
+// Ejemplo de patrón clave para este skill
+```
+
+## Interacción con Otros Roles
+
+| Rol | Colaboración |
+|-----|-------------|
+| [Rol 1] | [Cómo colaboran] |
+| [Rol 2] | [Cómo colaboran] |
+| [Rol 3] | [Cómo colaboran] |
+
+---
+
+## 🛠️ Herramientas Preferidas
+
+| Herramienta | Cuándo Usarla |
+|-------------|---------------|
+| `view_file` | [Cuándo] |
+| `run_command` | [Cuándo] |
+| `grep_search` | [Cuándo] |
+| `write_to_file` | [Cuándo] |
+
+## 📋 Definition of Done
+
+Antes de considerar una tarea terminada, verifica TODO:
+
+### Calidad
+- [ ] [Criterio 1]
+- [ ] [Criterio 2]
+- [ ] [Criterio 3]
+
+### Documentación
+- [ ] [Criterio de documentación 1]
+- [ ] [Criterio de documentación 2]
+
+---
+
+*Skill version: 2.3 | LMAgent Framework*

package/templates/USAGE.md

@@ -0,0 +1,95 @@
+# Guía de Uso de Templates LMAgent
+
+Los templates ubicados en esta carpeta están diseñados para ser puntos de partida listos para usar para nuevos componentes de tu sistema.
+
+## Flujo de Trabajo General
+
+1. **Elegir**: Selecciona el template adecuado para tu tarea.
+2. **Copiar**: Duplica la carpeta del template a tu destino.
+3. **Personalizar**: Ajusta la configuración y nombres.
+4. **Instalar**: Instala las dependencias y corre.
+
+---
+
+## 🐍 Backend Python (FastAPI)
+
+Ideal para microservicios robustos, APIs de datos o lógica de negocio compleja.
+
+**Pasos:**
+
+1. Copia el template:
+   ```bash
+   cp -r templates/backend-python servicios/mi-nuevo-servicio
+   ```
+
+2. Navega al directorio:
+   ```bash
+   cd servicios/mi-nuevo-servicio
+   ```
+
+3. Crea tu entorno virtual e instala dependencias:
+   ```bash
+   python -m venv venv
+   source venv/bin/activate  # o venv\Scripts\activate en Windows
+   pip install -r requirements.txt
+   ```
+
+4. Configura el entorno:
+   ```bash
+   cp .env.example .env  # (Si existe, sino crea uno basado en config.py)
+   ```
+
+5. Ejecuta:
+   ```bash
+   uvicorn app.main:app --reload
+   ```
+
+---
+
+## 🟢 Backend Node (Express + TS)
+
+Ideal para servicios ligeros, webhooks, o adaptadores de integración.
+
+**Pasos:**
+
+1. Copia el template:
+   ```bash
+   cp -r templates/backend-node servicios/mi-adaptador
+   ```
+
+2. Instala dependencias:
+   ```bash
+   cd servicios/mi-adaptador
+   npm install
+   ```
+
+3. Ejecuta en desarrollo:
+   ```bash
+   npm run dev
+   ```
+
+---
+
+## ⚡ Automation n8n
+
+Para flujos de automatización visual.
+
+**Pasos:**
+
+1. Abre n8n en tu navegador.
+2. Crea un nuevo workflow.
+3. Copia el contenido de `templates/automation-n8n/webhook-handler.json`.
+4. Pega (Ctrl+V) directamente en el canvas de n8n.
+5. Ajusta los nodos a tu necesidad.
+
+---
+
+## 🤖 Agent Python
+
+Para crear agentes autónomos especializados.
+
+**Pasos:**
+
+1. Copia `templates/agent-python` a tu carpeta de agentes.
+2. Define el `system.md` en la carpeta `prompts`.
+3. Configura las herramientas disponibles en `config.yaml`.

package/templates/agent-python/README.md

@@ -0,0 +1,71 @@
+# LMAgent Python Agent Template
+
+Este template proporciona la estructura base para crear agentes de IA con LMAgent.
+
+## Estructura
+
+```
+agent_name/
+├── __init__.py
+├── config.yaml           # Configuración del agente
+├── agent.py              # Clase principal del agente
+├── prompts/
+│   └── system.md         # System prompt del agente
+├── tools/
+│   ├── __init__.py
+│   └── custom_tool.py    # Herramientas específicas
+└── tests/
+    └── test_agent.py     # Tests del agente
+```
+
+## Uso
+
+## Uso
+
+1. Copiar este directorio:
+   ```bash
+   cp -r templates/agent-python agents/my-new-agent
+   cd agents/my-new-agent
+   ```
+
+2. Crear entorno virtual e instalar dependencias:
+   ```bash
+   python -m venv venv
+   source venv/bin/activate  # o venv\Scripts\activate en Windows
+   pip install -r requirements.txt
+   ```
+
+3. Configurar:
+   - Renombrar `config.yaml` y ajustar parámetros
+   - Personalizar `prompts/system.md`
+   - Crear `.env` con tus API Keys (ver `config.yaml` para referencias)
+
+4. Ejecutar:
+   ```bash
+   python agent.py
+   ```
+
+## Archivos
+
+### config.yaml
+
+Define la configuración del agente:
+- Modelo LLM a usar
+- Herramientas disponibles
+- Límites de costo/iteraciones
+- Guardrails
+
+### agent.py
+
+Clase principal que implementa:
+- Inicialización con configuración
+- Método `run()` para ejecutar el agente
+- Integración con tools y prompts
+
+### prompts/system.md
+
+System prompt que define:
+- Rol y responsabilidades
+- Herramientas disponibles
+- Formato de respuestas
+- Restricciones