@qubiit/lmagent 3.0.0 → 3.0.4

package/.agents/config/models.yaml

@@ -1,7 +1,7 @@
 # LMAgent LLM Models Configuration
 # Configuración de proveedores de modelos de lenguaje
 
-version: "3.0.0"
+version: "3.0.3"
 
 # Configuración global
 settings:

package/.agents/config/settings.yaml

@@ -1,7 +1,7 @@
 # LMAgent Global Settings
 # Configuración global personalizable del framework
 
-version: "3.0.0"
+version: "3.0.3"
 
 # ============================================
 # PERSONALIZACIÓN DEL FRAMEWORK
@@ -386,6 +386,14 @@ templates:
     - name: "automation-n8n"
       description: "n8n webhook handler"
       path: "templates/automation-n8n"
+    
+    - name: "database"
+      description: "Database schema and migrations"
+      path: "templates/database"
+
+    - name: "frontend-react"
+      description: "React Frontend template"
+      path: "templates/frontend-react"
 
 # ============================================
 # EXTENSIONES

package/.agents/docs/commands.md

@@ -1,132 +1,46 @@
-# LMAgent IDE Commands & Aliases
-
-Este documento define los comandos rápidos para activar personas y funcionalidades.
-
-## Personas
-
-| Comando | Alias | Activa | Uso |
-|---------|-------|--------|-----|
-| `/pm` | `/product` | Product Manager | Requisitos, user stories, PRDs |
-| `/arch` | `/architect` | Architect | Diseño de sistemas, ADRs |
-| `/dev` | `/backend` | Backend Engineer | Implementación backend |
-| `/frontend` | `/fe` | Frontend Engineer | React/Next.js, UI |
-| `/auto` | `/n8n` | Automation Engineer | Automatizaciones, webhooks |
-| `/ai` | `/agent` | AI Agent Engineer | Agentes de IA, prompts |
-| `/qa` | `/test` | QA Engineer | Testing, calidad |
-| `/sec` | `/security` | Security Analyst | Seguridad, auditoría |
-| `/sm` | `/scrum` | Scrum Master | Ceremonias, métricas |
-| `/orch` | `/orchestrator` | Orchestrator | Meta-routing automático |
-| `/ux` | `/ui`, `/design` | UX/UI Designer | Diseño, accesibilidad |
-| `/devops` | `/ops` | DevOps Engineer | CI/CD, infraestructura |
-| `/dba` | `/db`, `/data` | Data Engineer | Base de datos, SQL |
-| `/lead` | `/tl` | Tech Lead | Decisiones, mentoring |
-| `/writer` | `/docs` | Technical Writer | Documentación |
-| `/mobile` | `/rn` | Mobile Engineer | React Native, apps |
-| `/perf` | `/performance` | Performance Engineer | Optimización |
-| `/bmad` | `/kickoff`, `/classify` | BMAD Methodology | Scale-adaptive intelligence, niveles |
-| `/swe` | `/issue-solve`, `/trajectory` | SWE-Agent | Resolución autónoma de issues |
-| `/spec-dev` | `/sdd-skill`, `/spec-method` | Spec-Driven Dev | Pipeline SPECIFY→PLAN→TASKS→IMPL→VERIFY |
-
-## Modos
-
-| Comando | Descripción |
-|---------|-------------|
-| `/yolo` | Modo sin confirmaciones (Level 0-2) |
-| `/verbose` | Respuestas detalladas |
-| `/minimal` | Respuestas concisas |
-| `/plan` | Solo planificar, no ejecutar |
-| `/execute` | Ejecutar plan previamente aprobado |
-
-## Workflows
-
-| Comando | Workflow |
-|---------|----------|
-| `/new-auto` | new-automation.md |
-| `/new-agent` | new-agent-ia.md |
-| `/fix` | bugfix-backend.md |
-| `/perf` | optimize-performance.md |
-| `/issue` | resolve-github-issue.md |
-| `/security-review` | security-review.md |
-| `/prd` | generate-prd.md |
-| `/brainstorm` | ideation.md |
-| `/spec` | spec-driven.md |
-| `/feature` | new-feature.md |
-
-## Niveles
-
-| Comando | Nivel | Confirmación |
-|---------|-------|--------------|
-| `/l0` | Trivial | No |
-| `/l1` | Small | No |
-| `/l2` | Medium | Sí |
-| `/l3` | Complex | Sí + Artefactos |
-| `/l4` | Enterprise | Múltiples |
-
-## Ejemplos de Uso
-
-```
-Usuario: /pm Necesito definir requisitos para un sistema de login
-
-→ Activa Product Manager, inicia análisis de requisitos
-```
-
-```
-Usuario: /yolo /dev Arregla el typo en la línea 42 de app.py
-
-→ Activa Backend Engineer en modo sin confirmación
-```
-
-```
-Usuario: /issue #123
-
-→ Inicia workflow de resolución autónoma de GitHub issue
-```
-
-```
-Usuario: /brainstorm Ideas para mejorar el onboarding
-
-→ Inicia sesión de ideación
-```
-
-## Configuración de Shortcuts
-
-Para configurar en cada IDE:
-
-### Antigravity
-Los comandos se reconocen automáticamente al usar `/` al inicio.
-
-### Cursor
-Agregar en `.cursorrules`:
-```
-# Shortcuts
-/pm = Activate Product Manager persona
-/dev = Activate Backend Engineer persona
-...
-```
-
-### Claude Code
-Agregar en `CLAUDE.md`:
-```markdown
-## Quick Commands
-- /pm: Product Manager mode
-- /dev: Developer mode
-...
-```
-
-### VS Code (con extensión)
-Configurar snippets en `settings.json`.
-
-## Combinaciones Avanzadas
-
-```
-/pm + /arch     # PM + Architect para diseño de producto técnico
-/dev + /qa      # Dev + QA para TDD
-/ai + /sec      # AI Engineer + Security para agentes seguros
-/auto + /dev    # Automation + Dev para webhooks con backend
-```
-
-## Notas
-
-- Los comandos son **case-insensitive** (`/PM` = `/pm`)
-- Se pueden combinar comandos (`/yolo /dev`)
-- El Orchestrator (`/orch`) decide automáticamente si no especificas
+# 📟 CLI Commands Reference
+> **Tipo**: `doc` | **Versión**: 3.0.0
+
+## 🎯 **Core Commands**
+
+### `lmagent init`
+- **Descripción**: Inicializa un nuevo proyecto o actualiza la configuración existente.
+- **Acciones**: Copia `AGENTS.md`, `CLAUDE.md`, y configura `.agents/`.
+- **Opciones**:
+  - `--force (-f)`: Sobrescribe archivos sin preguntar.
+  - `--yes (-y)`: Modo no interactivo (defaults).
+
+### `lmagent install`
+- **Descripción**: Instala skills, rules, workflows y memory en el IDE del proyecto.
+- **Alias**: `lmagent update`.
+- **Acciones**: Detecta el IDE (Cursor, VSCode, etc.) y copia los artefactos necesarios.
+- **Opciones**:
+  - `--force`: Reescribe configuraciones.
+
+### `lmagent doctor`
+- **Descripción**: Verifica la salud del entorno.
+- **Chequeos**:
+  - Archivos críticos (`AGENTS.md`).
+  - `.gitignore` correctamente configurado.
+  - Versiones de dependencias.
+
+### `lmagent validate`
+- **Descripción**: Valida la integridad de los Skills (YAML Frontmatter).
+- **Uso**: `lmagent validate [skill-name]`
+
+### `lmagent create-skill`
+- **Descripción**: Wizard interactivo para crear un nuevo Skill desde cero.
+
+---
+
+## ⚡ **Triggers (Chat Interface)**
+Estos no son comandos de terminal, son comandos para el LLM en el chat.
+
+| Trigger | Skill |
+|:---|:---|
+| `/orch` | Orchestrator (Triage) |
+| `/pm` | Product Manager |
+| `/dev` | Backend Engineer |
+| `/front` | Frontend Engineer |
+| `/fix` | Debugger |
+| `/arch` | Architect |

package/.agents/docs/customization-guide.md

@@ -1,445 +1,37 @@
-# LMAgent Customization Guide
+# 🛠️ Customization Guide
 
-Esta guía explica cómo personalizar el framework LMAgent para las necesidades de tu equipo.
+LMAgent es 100% personalizable. Aquí te explicamos cómo adaptarlo a tu equipo.
 
-## Tabla de Contenidos
+## 1. Personalizando Skills (Roles)
+Los Skills viven en `.agents/skills/`. Cada carpeta es un "cerebro" especializado.
 
-1. [Configuración Inicial](#configuración-inicial)
-2. [Personalizar Niveles](#personalizar-niveles)
-3. [Crear Personas Custom](#crear-personas-custom)
-4. [Agregar Herramientas](#agregar-herramientas)
-5. [Crear Workflows Custom](#crear-workflows-custom)
-6. [Configurar Modelos LLM](#configurar-modelos-llm)
-7. [Extensiones](#extensiones)
-
----
-
-## Configuración Inicial
-
-### 1. Clonar y Configurar
-
-```bash
-# Clonar el repo
-git clone https://github.com/tu-org/lmagent-template.git mi-proyecto
-cd mi-proyecto
-
-# Configurar información del proyecto
-# Editar config/settings.yaml
-```
-
-### 2. Personalizar settings.yaml
-
-```yaml
-# config/settings.yaml
-
-project:
-  name: "Mi Proyecto"
-  description: "Descripción de mi proyecto"
-  team: "Mi Equipo"
-  version: "0.1.0"
-
-agent_behavior:
-  language: "es"  # Idioma preferido
-  autonomy:
-    mode: "auto"  # auto, always_ask, never_ask
-```
-
-### 3. Variables de Entorno
-
-```bash
-# Copiar template
-cp .env.example .env
-
-# Configurar tus API keys
-OPENAI_API_KEY=sk-...
-DATABASE_URL=postgresql://...
-REDIS_URL=redis://...
-```
-
----
-
-## Personalizar Niveles
-
-### Opción 1: Ajustar Tiempos
-
-Si tu equipo es más rápido o lento que el promedio:
-
-```yaml
-# config/settings.yaml
-levels:
-  time_multiplier: 1.5  # 1.5x más lento que default
-```
-
-### Opción 2: Crear Niveles Custom
-
-```yaml
-# config/levels-custom.yaml
-# Luego en settings.yaml:
-levels:
-  use_custom: true
-  custom_file: "config/levels-custom.yaml"
-```
-
-Ejemplo de level custom:
-
-```yaml
-levels:
-  0:
-    name: "Micro"
-    description: "Cambios de < 1 minuto"
-    planning_required: false
-    estimated_time: "< 1 min"
-    
-  5:
-    name: "Multi-Team"
-    description: "Proyectos que involucran múltiples equipos"
-    planning_required: true
-    planning_depth: "strategic"
-    estimated_time: "1+ mes"
-    human_review: true
-    human_approval_required: true
-    artifacts:
-      - project_charter.md
-      - implementation_plan.md
-      - architecture.md
-      - test_plan.md
-      - security_review.md
-      - rollback_plan.md
-      - communication_plan.md
-```
-
-### Agregar Reglas de Auto-Clasificación
-
-```yaml
-# config/settings.yaml
-levels:
-  auto_classification:
-    level_bumps:
-      # Tus patrones custom
-      - pattern: "*payment*"
-        min_level: 3
-        reason: "Cambios de pagos son críticos"
-      
-      - pattern: "*api/v2/*"
-        min_level: 2
-        reason: "API v2 requiere más cuidado"
-```
-
----
-
-## Crear Personas Custom
-
-### 1. Crear Archivo de Persona
-
-```markdown
-# personas/custom/devops-engineer.md
-
----
-name: DevOps Engineer
-role: Infrastructure and CI/CD
-expertise:
-  - Docker/Kubernetes
-  - CI/CD pipelines
-  - Cloud infrastructure
-  - Monitoring
-activates_on:
-  - Cambios de Dockerfile
-  - Configuración de CI/CD
-  - Infrastructure as Code
----
-
-# DevOps Engineer Persona
-
-Eres un DevOps Engineer especializado en...
-
-## Responsabilidades
-1. ...
-
-## Stack
-- Docker, Kubernetes
-- GitHub Actions
-- Terraform
-- ...
-
-## Patrones
-...
-```
-
-### 2. Habilitar en Settings
-
-```yaml
-# config/settings.yaml
-personas:
-  allow_custom: true
-  custom_directory: "personas/custom"
-  enabled:
-    - product-manager
-    - architect
-    - backend-engineer
-    - devops-engineer  # Tu persona custom
-```
-
----
-
-## Agregar Herramientas
-
-### 1. Definir en tools.yaml
-
-```yaml
-# config/tools.yaml
-
-tools:
-  # Tu herramienta custom
-  jira_integration:
-    name: "Jira Integration"
-    module: "agents.python.tools.jira_tool"
-    class: "JiraTool"
-    description: "Interact with Jira for issue management"
-    category: "project_management"
-    parameters:
-      - name: action
-        type: string
-        enum: [get_issue, create_issue, update_status]
-        required: true
-      - name: issue_key
-        type: string
-        required: false
-      - name: data
-        type: object
-        required: false
-    requires:
-      - JIRA_URL
-      - JIRA_API_TOKEN
-```
-
-### 2. Implementar la Herramienta
-
-```python
-# agents/python/tools/jira_tool.py
-
-from lmagent.tools.base import BaseTool, ToolResult
-from pydantic import Field
-import httpx
-
-class JiraTool(BaseTool):
-    """
-    Interactúa con Jira para gestión de issues.
-    
-    Usa esta herramienta cuando necesites:
-    - Obtener información de un issue
-    - Crear nuevos issues
-    - Actualizar estados
-    """
-    
-    name: str = "jira_integration"
-    description: str = "Interact with Jira for issue management"
-    
-    async def execute(
-        self,
-        action: str = Field(..., description="Action: get_issue, create_issue, update_status"),
-        issue_key: str = Field(None, description="Issue key for get/update"),
-        data: dict = Field(None, description="Data for create/update")
-    ) -> ToolResult:
-        """Execute Jira operation."""
-        # Implementación...
-        pass
-```
-
-### 3. Habilitar en Settings
-
-```yaml
-# config/settings.yaml
-tools:
-  default_enabled:
-    - http_request
-    - database_query
-    - jira_integration  # Tu tool
-```
-
----
-
-## Crear Workflows Custom
-
-### 1. Crear Archivo de Workflow
-
-```markdown
-# workflows/custom/deploy-to-production.md
-
----
-description: Workflow para deploy a producción
-level: 3
-personas: [devops-engineer, backend-engineer]
----
-
-# Deploy to Production Workflow
-
-## Pre-requisitos
-1. Código mergeado a main
-2. Tests pasando
-3. Aprobación de QA
-
-## Paso 1: Pre-deploy Checks
-...
-
-## Paso 2: Deploy
-...
-
-## Paso 3: Verification
-...
-
-## Rollback
-...
-```
-
-### 2. Habilitar en Settings
-
-```yaml
-# config/settings.yaml
-workflows:
-  allow_custom: true
-  custom_directory: "workflows/custom"
-  enabled:
-    - new-automation
-    - deploy-to-production  # Tu workflow
-```
-
----
-
-## Configurar Modelos LLM
-
-### Agregar Proveedor Custom
-
-```yaml
-# config/models.yaml
-
-providers:
-  # Tu proveedor custom
-  azure_openai:
-    name: "Azure OpenAI"
-    api_base: "https://your-resource.openai.azure.com/"
-    env_key: "AZURE_OPENAI_API_KEY"
-    models:
-      gpt-4:
-        name: "GPT-4 (Azure)"
-        context_window: 128000
-        max_output: 4096
-        cost_per_1k_input: 0.03
-        cost_per_1k_output: 0.06
-        supports_tools: true
-```
-
-### Configurar por Tipo de Tarea
+### Estructura de un Skill
+- `SKILL.md`: (**Obligatorio**) El prompt maestro. Define la personalidad y capacidades.
+- `scripts/`: Scripts ejecutables (Python/Node) que el skill puede usar.
+- `references/`: Documentación estática que el skill lee para aprender.
 
+### Cómo crear un Skill nuevo
+Basta con crear un archivo `SKILL.md`:
 ```yaml
-# config/models.yaml
-
-task_models:
-  # Tu configuración custom
-  financial_analysis:
-    primary: "openai/o1"
-    fallback: "anthropic/claude-sonnet-4"
-    reason: "O1 para análisis financiero complejo"
-```
-
 ---
-
-## Extensiones
-
-### Estructura de Extensión
-
-```
-extensions/
-└── my-extension/
-    ├── extension.yaml    # Metadata
-    ├── __init__.py
-    ├── tools/            # Tools adicionales
-    ├── workflows/        # Workflows adicionales
-    └── personas/         # Personas adicionales
-```
-
-### extension.yaml
-
-```yaml
-name: "my-extension"
-version: "1.0.0"
-description: "Mi extensión custom"
-author: "Tu Nombre"
-
-# Qué agrega
-provides:
-  tools:
-    - my_custom_tool
-  workflows:
-    - my_custom_workflow
-  personas:
-    - my_custom_persona
-
-# Configuración
-settings:
-  api_url: ""
-  api_key_env: "MY_API_KEY"
-```
-
-### Habilitar Extensión
-
-```yaml
-# config/settings.yaml
-extensions:
-  enabled: true
-  installed:
-    - my-extension
-```
-
+name: Cloud Architect
+description: Experto en AWS y Terraform
+triggers: [/cloud, /aws]
 ---
 
-## Tips de Personalización
-
-### 1. Empezar Simple
-
-- Primero usa el framework como está
-- Identifica qué necesitas cambiar
-- Personaliza incrementalmente
-
-### 2. Documentar Cambios
-
-- Documenta por qué personalizaste algo
-- Facilita onboarding de nuevos miembros
-
-### 3. Mantener Compatibilidad
-
-- No modifiques archivos core directamente
-- Usa archivos custom y overrides
-- Facilita actualizar a nuevas versiones
-
-### 4. Compartir con el Equipo
-
-```bash
-# Commitear solo lo necesario
-git add config/settings.yaml
-git add personas/custom/
-git add workflows/custom/
-git add config/tools-custom.yaml
-git commit -m "chore: add team customizations"
+# Cloud Architect Persona
+Eres un experto en infraestructura...
 ```
 
----
-
-## Troubleshooting
-
-### Persona Custom No Funciona
-
-1. Verificar que está en `personas/custom/` o directorio correcto
-2. Verificar YAML frontmatter
-3. Verificar que está habilitada en settings.yaml
-
-### Tool Custom No Se Registra
+## 2. Personalizando Reglas (Governance)
+Las reglas en `.agents/rules/` son leídas por **todos** los skills.
 
-1. Verificar path del módulo en tools.yaml
-2. Verificar que la clase existe e importa
-3. Verificar las dependencias necesarias
+- **00-master.md**: El índice maestro. Si agregas una regla, enlázala aquí.
+- **Tech Stack**: Edita `02-tech-stack.md` para definir qué librerías permites.
 
-### Workflow No Aparece
+## 3. Personalizando Workflows (SOPs)
+Los workflows en `.agents/workflows/` son "recetas" paso a paso.
+El Orchestrator los usa para guiar procesos complejos.
 
-1. Verificar que está habilitado en settings.yaml
-2. Verificar YAML frontmatter
-3. Verificar path del archivo
+## 4. Extendiendo el CLI
+Si quieres lógica imperativa (comandos), puedes modificar `install.js` o agregar scripts en `.agents/scripts/` y llamarlos con `npx lmagent run tu-script`.