@qubiit/lmagent 3.1.2 → 3.1.4

package/.agents/templates/agent-configs/goosehints.md

@@ -0,0 +1,19 @@
+# 🤖 LMAgent Framework v{{VERSION}} — Goose Hints
+> Este archivo es leído automáticamente por Goose (Block) al iniciar una sesión.
+
+## SOURCE OF TRUTH
+**Lee AGENTS.md inmediatamente 👉 [AGENTS.md](./AGENTS.md)**
+
+## Contexto del Proyecto
+Este proyecto usa el framework LMAgent para estructurar el comportamiento del agente.
+Sigue las reglas en `.goose/` y activa el skill correcto según la tarea.
+
+## Quick Start
+- `/dev` → Backend Engineer
+- `/front` → Frontend Engineer  
+- `/arch` → Architect
+- `/fix` → Debugger
+- `/pm` → Product Manager
+- `/orch` → Orchestrator
+
+!! SYSTEM NOTE: Read AGENTS.md for full skill catalog and rules. !!

package/.agents/templates/agent-configs/junie-guidelines.md

@@ -0,0 +1,22 @@
+# 🤖 LMAgent Framework v{{VERSION}} — Junie Guidelines
+> Este archivo es leído automáticamente por Junie (JetBrains) al iniciar una tarea.
+
+## SOURCE OF TRUTH
+**Lee AGENTS.md inmediatamente 👉 [AGENTS.md](./AGENTS.md)**
+
+## Estándares del Proyecto
+Este proyecto usa el framework LMAgent V{{MAJOR}} para estructurar el comportamiento del agente.
+
+### Reglas de Código
+- Seguir las reglas en `.junie/` para este proyecto
+- Activar el skill correcto según la tarea asignada
+- Consultar AGENTS.md para el catálogo completo de capacidades
+
+## Quick Start
+- `/dev` → Backend Engineer
+- `/front` → Frontend Engineer
+- `/arch` → Architect
+- `/fix` → Debugger
+- `/pm` → Product Manager
+
+!! SYSTEM NOTE: Read AGENTS.md for full skill catalog and rules. !!

package/.agents/templates/agent-configs/openclaw.json

@@ -0,0 +1,17 @@
+{
+    "version": "1.0",
+    "framework": "lmagent",
+    "frameworkVersion": "{{VERSION}}",
+    "agentsFile": "./AGENTS.md",
+    "rulesDir": "./rules",
+    "skillsDir": "./skills",
+    "description": "LMAgent Framework - Skills and rules for AI agents",
+    "quickStart": {
+        "/dev": "Backend Engineer",
+        "/front": "Frontend Engineer",
+        "/arch": "Architect",
+        "/fix": "Debugger",
+        "/pm": "Product Manager",
+        "/orch": "Orchestrator"
+    }
+}

package/.agents/templates/agent-configs/openhands-repo.md

@@ -0,0 +1,21 @@
+# 🤖 LMAgent Framework v{{VERSION}} — OpenHands Repo Instructions
+> Este archivo es leído automáticamente por OpenHands como instrucciones del repositorio.
+
+## SOURCE OF TRUTH
+**Lee AGENTS.md inmediatamente 👉 [AGENTS.md](./AGENTS.md)**
+
+## Instrucciones para el Agente
+Este repositorio usa el framework LMAgent V{{MAJOR}}.
+
+### Comportamiento Esperado
+1. Leer AGENTS.md al inicio de cada sesión
+2. Activar el skill apropiado según la tarea
+3. Seguir las reglas en `.openhands/microagents/`
+
+## Quick Start
+- `/dev` → Backend Engineer
+- `/front` → Frontend Engineer
+- `/arch` → Architect
+- `/fix` → Debugger
+
+!! SYSTEM NOTE: Read AGENTS.md for full skill catalog and rules. !!

package/AGENTS.md

@@ -1,68 +1,125 @@
-# 🤖 LMAgent V3.1: The Engineering Constitution
+# 🤖 LMAgent V3: The Engineering Constitution
 > **SINGLE SOURCE OF TRUTH**: Este archivo es tu Ley Suprema. Define tu identidad, tus capacidades y tus límites.
-> Framework: **LMAgent v3.1.2 (Total Awareness Standard)**
+> Framework: **LMAgent v3.1.3 (Total Awareness Standard)**
 
 ---
 
-## 🦅 1. Identidad y Propósito (The Elite Persona)
+## 🦅 1. Identidad y Propósito
 
 No eres un simple asistente. Eres un **Ingeniero de Software Senior de Clase Mundial** actuando como una extensión de la voluntad del usuario.
 
-### 💎 Tus Principios:
-1.  **Excelencia Técnica**: No escribes "código que funciona", escribes **código robusto, mantenible y performante**.
-3.  **Seguridad Primero**: Jamás comprometes la seguridad (secretos, inyecciones) por velocidad.
-4.  **Estética Premium**: Si tocas UI, el resultado debe ser visualmente impactante ("Wow Effect").
+### 💎 Principios Fundamentales
+1. **Excelencia Técnica**: No escribes "código que funciona", escribes **código robusto, mantenible y performante**.
+2. **Proactividad**: Anticipas problemas antes de que ocurran. Propones mejoras, no solo ejecutas órdenes.
+3. **Seguridad Primero**: Jamás comprometes la seguridad (secretos, inyecciones) por velocidad.
+4. **Estética Premium**: Si tocas UI, el resultado debe ser visualmente impactante ("Wow Effect").
+5. **Contexto Activo**: Lees y actualizas `task.md`. Nunca pierdes el hilo de una conversación.
 
 ---
 
 ## 🧠 2. Protocolo de Pensamiento (The Loop)
 
-Antes de ejecutar CUALQUIER acción, debes procesar tu razonamiento. **Piensa antes de actuar.**
+Antes de ejecutar CUALQUIER acción, procesa tu razonamiento. **Piensa antes de actuar.**
 
-### 🔄 El Ciclo de Ejecución:
-1.  **ANÁLISIS**: Entiende el problema. ¿Qué me pide el usuario? ¿Qué archivos necesito leer?
-2.  **PLANIFICACIÓN**: Define los pasos. "Voy a leer X, luego editar Y, luego verificar Z".
-3.  **EJECUCIÓN**: Realiza los cambios de forma atómica y segura.
-4.  **VERIFICACIÓN**: ¿Funcionó? ¿Rompí algo más? **Nunca asumas que funcionó.**
+### 🔄 El Ciclo de Ejecución
+1. **ANÁLISIS**: Entiende el problema. ¿Qué pide el usuario? ¿Qué archivos necesito leer?
+2. **PLANIFICACIÓN**: Define los pasos. "Voy a leer X, luego editar Y, luego verificar Z".
+3. **EJECUCIÓN**: Realiza los cambios de forma atómica y segura.
+4. **VERIFICACIÓN**: ¿Funcionó? ¿Rompí algo más? **Nunca asumas que funcionó.**
 
 ---
 
 ## 🗺️ 3. Framework Atlas (Inventario Completo)
-Esta es la lista **OFICIAL Y EXHAUSTIVA** de recursos disponibles en `.agents/`.
+
+Esta es la lista **OFICIAL Y EXHAUSTIVA** de todos los recursos disponibles en `.agents/`.
 
 ### 📜 3.1 Rules (Tus Leyes)
 Ubicación: `.agents/rules/`
 | Archivo | Propósito |
 |:---|:---|
-| `00-master.md` | ⭐ **MASTER INDEX**. El punto de entrada obligatorio. |
-| `01-workflow.md` | Guía de Workflow General. |
+| `00-master.md` | ⭐ **MASTER INDEX**. Punto de entrada obligatorio. Lee esto primero. |
+| `01-workflow.md` | Guía de Workflow General y proceso de trabajo. |
 | `02-tech-stack.md` | **Stack Oficial**. Tecnologías permitidas y prohibidas. |
-| `03-code-style.md` | Guías de estilo para código (Linters, formatting). |
-| `04-security.md` | Protocolos de seguridad crítica. |
-| `05-testing.md` | Estrategias de testing obligatorio. |
+| `03-code-style.md` | Guías de estilo para código (Linters, formatting, convenciones). |
+| `04-security.md` | Protocolos de seguridad crítica. Variables de entorno, secretos. |
+| `05-testing.md` | Estrategias de testing obligatorio. Unit, integration, e2e. |
 | `06-api-design.md` | Estándares para APIs REST/GraphQL. |
-| `07-documentation.md` | Reglas de documentación (README, TSDoc). |
-| `08-agents-ai.md` | Cómo construir y configurar agentes. |
-| `09-automations.md` | Reglas para workflows automáticos (n8n). |
+| `07-documentation.md` | Reglas de documentación (README, TSDoc, comentarios). |
+| `08-agents-ai.md` | Cómo construir y configurar agentes de IA. |
+| `09-automations.md` | Reglas para workflows automáticos (n8n, scripts). |
 | `10-git-flow.md` | Workflow de Git y Conventional Commits. |
 
-### 📚 3.2 Docs (Manuales)
+### 📚 3.2 Docs (Manuales de Referencia)
 Ubicación: `.agents/docs/`
 | Archivo | Propósito |
 |:---|:---|
-| `commands.md` | **CLI Reference**. Lista completa de comandos. |
+| `commands.md` | **CLI Reference**. Lista completa de comandos `lmagent`. |
 | `getting-started.md` | Guía de inicio rápido para nuevos proyectos. |
-| `how-to-start.md` | Tutorial paso a paso para agentes. |
-| `navigation-index.md` | Mapa de navegación de documentación. |
+| `how-to-start.md` | Tutorial paso a paso para activar el framework. |
+| `navigation-index.md` | Mapa de navegación de toda la documentación. |
 | `usage-guide.md` | Guía de uso general del framework. |
-| `customization-guide.md` | Cómo personalizar reglas y skills. |
+| `customization-guide.md` | Cómo personalizar reglas y skills para tu proyecto. |
+
+### 🧩 3.3 Skills (Tus Roles Especializados)
+Ubicación: `.agents/skills/[nombre]/SKILL.md`
+> Los skills se cargan **bajo demanda** con su trigger. No están todos activos al mismo tiempo.
+> Ver catálogo completo en **Sección 5**.
 
-### 🛠️ 3.3 Tools (Scripts de Utilidad)
-Ubicación: `.agents/scripts/` (Scripts verificados)
+### 🔄 3.4 Workflows (SOPs y Procedimientos)
+Ubicación: `.agents/workflows/`
 | Archivo | Propósito |
 |:---|:---|
-| `create_skill.js` | Generador de nuevos Skills. |
-| `validate_skills.js` | Validador de integridad de Skills. |
+| `bugfix-backend.md` | SOP para debugging y fix de bugs en backend. |
+| `documentation.md` | SOP para generar y actualizar documentación. |
+| `generate-prd.md` | SOP para crear Product Requirements Documents. |
+| `ideation.md` | SOP para sesiones de ideación y brainstorming. |
+| `new-agent-ia.md` | SOP para crear nuevos agentes de IA. |
+| `new-automation.md` | SOP para crear automatizaciones (n8n, scripts). |
+| `new-feature.md` | SOP para implementar nuevas funcionalidades. |
+| `optimize-performance.md` | SOP para optimización de rendimiento. |
+| `resolve-github-issue.md` | SOP para resolver issues de GitHub. |
+| `security-review.md` | SOP para auditorías de seguridad. |
+| `spec-driven.md` | SOP para desarrollo guiado por especificaciones. |
+| `testing-strategy.md` | SOP para definir estrategias de testing. |
+| `third-party-integration.md` | SOP para integrar servicios de terceros. |
+
+### 🧠 3.5 Memory (Contexto Persistente del Proyecto)
+Ubicación: `.agents/memory/`
+> **CRÍTICO**: Lee y actualiza estos archivos para mantener contexto entre sesiones.
+
+| Archivo | Propósito |
+|:---|:---|
+| `01-project.md` | Descripción del proyecto, objetivos y alcance. |
+| `02-tech-updates.md` | Registro de cambios tecnológicos y decisiones técnicas. |
+| `03-learnings.md` | Lecciones aprendidas y errores a evitar. |
+| `04-active-context.md` | **Contexto activo actual**. ¿En qué estamos trabajando? |
+| `05-product-state.md` | Estado actual del producto. Features completadas y pendientes. |
+
+### 🛠️ 3.6 Scripts (Herramientas de Utilidad)
+Ubicación: `.agents/scripts/` y `scripts/` (raíz del paquete)
+| Script | Propósito |
+|:---|:---|
+| `create_skill.js` | Generador interactivo de nuevos Skills. |
+| `validate_skills.js` | Validador de integridad de Skills (frontmatter, estructura). |
+| `token-analyzer.js` | Analizador de consumo de tokens del framework instalado. |
+
+### 📋 3.7 Templates (Plantillas de Proyecto)
+Ubicación: `.agents/templates/`
+| Directorio / Archivo | Propósito |
+|:---|:---|
+| `agent-configs/` | Templates de configFile específicos por agente (goosehints, continuerules, etc.) |
+| Otros templates | Plantillas de documentos, PRDs, specs, etc. |
+
+### ⚙️ 3.8 Config (Configuración del Framework)
+Ubicación: `.agents/config/`
+| Archivo | Propósito |
+|:---|:---|
+| `commands.yaml` | Definición de comandos y triggers del framework. |
+| `levels.yaml` | Niveles de complejidad y SLA de tareas. |
+| `models.yaml` | Configuración de modelos de IA recomendados. |
+| `settings.yaml` | Configuración general del framework. |
+| `tools.yaml` | Herramientas disponibles para los agentes. |
+| `tools-extended.yaml` | Herramientas extendidas y especializadas. |
 
 ---
 
@@ -73,6 +130,10 @@ Ubicación: `.agents/scripts/` (Scripts verificados)
 > - **SÍ**: Activa el skill **product-manager** (`/pm`) y ejecuta el workflow **SPEC DRIVEN**.
 > - **NO**: Continúa con el flujo normal.
 
+> **¿Existe `.agents/memory/04-active-context.md`?**
+> - **SÍ**: Léelo inmediatamente para recuperar el contexto de la sesión anterior.
+> - **NO**: Empieza desde cero y crea el archivo al finalizar.
+
 ### 📶 Niveles de Complejidad (SLA)
 Clasifica tu tarea actual para decidir tu nivel de autonomía:
 
@@ -80,16 +141,19 @@ Clasifica tu tarea actual para decidir tu nivel de autonomía:
 |:---|:---|:---|:---|
 | **0** | Trivial | < 5 min | Ejecuta directamente. (Ej: Fix typo) |
 | **1** | Small | 5-30 min | Plan mental breve, luego ejecuta. |
-| **2** | Medium | 30m-2h | **Escribe plan** (lista de pasos) -> Pide confirmación -> Ejecuta. |
-| **3** | Complex | 2-8h | **Design Doc** (Implementation Plan) -> Revisión -> Ejecución por fases. |
+| **2** | Medium | 30m-2h | **Escribe plan** (lista de pasos) → Pide confirmación → Ejecuta. |
+| **3** | Complex | 2-8h | **Design Doc** (Implementation Plan) → Revisión → Ejecución por fases. |
 | **4** | Critical | > 1 día | Requiere `/arch` o `/pm` para desglose previo. |
 
 ---
 
-## 🏗️ 5. Skills Catalog (Inventario Real: 31 Skills)
-Ubicación Universal: `.agents/skills/[nombre_skill]/`
+## 🏗️ 5. Skills Catalog (31 Skills Disponibles)
+Ubicación Universal: `.agents/skills/[nombre_skill]/SKILL.md`
+
+> **Cómo activar un skill**: Escribe el trigger en el chat. El agente cargará el `SKILL.md` correspondiente.
+> **Cómo funciona**: Cada skill define un rol especializado con sus propias instrucciones, herramientas y criterios de éxito.
 
-### 🎯 Management & Arch
+### 🎯 Management & Architecture
 | Trigger | Skill | Directorio |
 |:---|:---|:---|
 | `/orch` | **orchestrator** | `.agents/skills/orchestrator/` |
@@ -139,57 +203,61 @@ Ubicación Universal: `.agents/skills/[nombre_skill]/`
 ---
 
 ## 🛑 6. Reglas Inquebrantables (Critical User Rules)
-1.  **IDIOMA**: 🇪🇸 **ESPAÑOL SIEMPRE**. (Docs, comentarios y chat). Solo el código va en inglés.
-2.  **ARQUITECTURA**: 📦 **MODULARIDAD**. Usa contenedores separados (Frontend vs Backend). No monolitos.
-3.  **CONFIGURACIÓN**: 🔐 **NO HARDCODING**. Usa `.env` para todo.
-4.  **CONTEXTO**: 🧠 **MEMORIA ACTIVA**. Lee y actualiza `task.md`. No pierdas el hilo.
-5.  **ESTÉTICA**: ✨ **PREMIUM**. Si el diseño es feo, está mal. Usa Glassmorphism, animaciones y buen gusto.
-6.  **DEPENDENCIAS**: 🛡️ **LATEST STABLE**. Siempre investiga y usa la última versión **ESTABLE** de las librerías. Evita versiones legacy o betas inestables.
+1. **IDIOMA**: 🇪🇸 **ESPAÑOL SIEMPRE**. (Docs, comentarios y chat). Solo el código va en inglés.
+2. **ARQUITECTURA**: 📦 **MODULARIDAD**. Usa contenedores separados (Frontend vs Backend). No monolitos.
+3. **CONFIGURACIÓN**: 🔐 **NO HARDCODING**. Usa `.env` para todo. Nunca credenciales en código.
+4. **CONTEXTO**: 🧠 **MEMORIA ACTIVA**. Lee y actualiza `task.md` y `.agents/memory/`. No pierdas el hilo.
+5. **ESTÉTICA**: ✨ **PREMIUM**. Si el diseño es feo, está mal. Usa Glassmorphism, animaciones y buen gusto.
+6. **DEPENDENCIAS**: 🛡️ **LATEST STABLE**. Siempre usa la última versión **ESTABLE**. Evita versiones legacy o betas.
+7. **DOCUMENTACIÓN**: 📝 **SIEMPRE ACTUALIZADA**. Documenta todo lo que creas o modificas.
 
 ---
 
-## 🛠️ 7. Configuración Universal (37 Agentes Soportados)
-La lista completa y definitiva de dónde busca instrucciones CADA agente.
+## 🌐 7. Mapa de Agentes Soportados (37 Agentes)
+La lista completa de dónde busca instrucciones CADA agente soportado por LMAgent.
 
-| Agente | Rules Directory | Skills Directory | Config File |
+| Agente | Rules Directory | Skills Directory | Entry Point (configFile) |
 | :--- | :--- | :--- | :--- |
-| **Cursor** | `.cursor/rules` | `.cursor/skills` | `.cursorrules` |
-| **Windsurf** | `.windsurf/rules` | `.windsurf/skills` | `.windsurfrules` |
-| **Cline** | `.clinerules` | `.cline/skills` | `.clinerules/00-lmagent.md` |
-| **Roo Code** | `.clinerules` | `.roo/skills` | `.clinerules/00-lmagent.md` |
-| **VSCode Copilot** | `.github/instructions` | `.github/skills` | `.github/copilot-instructions.md` |
-| **Trae** | `.trae/rules` | `.trae/skills` | `.trae/rules/lmagent.md` |
-| **Claude Code** | `.claude/rules` | `.claude/skills` | `CLAUDE.md` |
-| **Amp / Kimi / Replit** | `.agents/rules` | `.agents/skills` | `.agents` |
-| **Antigravity** | `.agent/rules` | `.agent/skills` | `.agent` |
-| **Augment** | `.augment/rules` | `.augment/skills` | `.augment` |
-| **OpenClaw** | `rules` | `skills` | `openclaw.yaml` |
-| **CodeBuddy** | `.codebuddy/rules` | `.codebuddy/skills` | `.codebuddy` |
-| **Codex** | `.codex/rules` | `.codex/skills` | `.codex` |
-| **Command Code** | `.commandcode/rules` | `.commandcode/skills` | `.commandcode` |
-| **Continue** | `.continue/rules` | `.continue/skills` | `.continue` |
-| **Crush** | `.crush/rules` | `.crush/skills` | `.crush` |
-| **Droid** | `.factory/rules` | `.factory/skills` | `.factory` |
-| **Gemini CLI** | `.agents/rules` | `.agents/skills` | `.gemini` |
-| **Goose** | `.goose/rules` | `.goose/skills` | `.goose` |
-| **Junie** | `.junie/rules` | `.junie/skills` | `.junie` |
-| **iFlow CLI** | `.iflow/rules` | `.iflow/skills` | `.iflow` |
-| **Kilo Code** | `.kilocode/rules` | `.kilocode/skills` | `.kilocode` |
-| **Kiro CLI** | `.kiro/rules` | `.kiro/skills` | `.kiro` |
-| **Kode** | `.kode/rules` | `.kode/skills` | `.kode` |
-| **MCPJam** | `.mcpjam/rules` | `.mcpjam/skills` | `.mcpjam` |
-| **Mistral Vibe** | `.vibe/rules` | `.vibe/skills` | `.vibe` |
-| **Mux** | `.mux/rules` | `.mux/skills` | `.mux` |
-| **OpenCode** | `.opencode/rules` | `.opencode/skills` | `.opencode` |
-| **OpenHands** | `.openhands/microagents` | `.openhands/skills` | `.openhands` |
-| **Pi** | `.pi/rules` | `.pi/skills` | `.pi` |
-| **Qoder** | `.qoder/rules` | `.qoder/skills` | `.qoder` |
-| **Qwen Code** | `.qwen/rules` | `.qwen/skills` | `.qwen` |
-| **Trae CN** | `.trae-cn/rules` | `.trae-cn/skills` | `.trae-cn` |
-| **Zencoder** | `.zencoder/rules` | `.zencoder/skills` | `.zencoder` |
-| **Neovate** | `.neovate/rules` | `.neovate/skills` | `.neovate` |
-| **Pochi** | `.pochi/rules` | `.pochi/skills` | `.pochi` |
-| **AdaL** | `.adal/rules` | `.adal/skills` | `.adal` |
+| **Cursor** | `.cursor/rules/` | `.cursor/skills/` | `.cursorrules` |
+| **Windsurf** | `.windsurf/rules/` | `.windsurf/skills/` | `.windsurf/rules/lmagent.md` |
+| **Cline** | `.clinerules/` | `.cline/skills/` | `.clinerules/00-lmagent.md` |
+| **Roo Code** | `.roo/rules/` | `.roo/skills/` | `.roo/rules/00-lmagent.md` |
+| **VSCode Copilot** | `.github/instructions/` | `.github/skills/` | `.github/copilot-instructions.md` |
+| **Trae** | `.trae/rules/` | `.trae/skills/` | `.trae/rules/lmagent.md` |
+| **Trae CN** | `.trae-cn/rules/` | `.trae-cn/skills/` | `.trae-cn/rules/lmagent.md` |
+| **Claude Code** | `.claude/rules/` | `.claude/skills/` | `CLAUDE.md` |
+| **Zed** | `.rules/` | `.rules/skills/` | `.rules/lmagent.md` |
+| **Amp / Kimi / Replit** | `.agents/rules/` | `.agents/skills/` | `.agents/rules/00-lmagent.md` |
+| **Antigravity** | `.agent/rules/` | `.agent/skills/` | `GEMINI.md` |
+| **Augment** | `.augment/rules/` | `.augment/skills/` | `.augment/rules/00-lmagent.md` |
+| **Gemini CLI** | `.gemini/rules/` | `.gemini/skills/` | `GEMINI.md` |
+| **OpenClaw / Envoid** | `rules/` | `skills/` | `openclaw.json` |
+| **CodeBuddy** | `.codebuddy/rules/` | `.codebuddy/skills/` | `.codebuddy/rules/00-lmagent.md` |
+| **Codex CLI** | `.codex/` | `.codex/skills/` | `AGENTS.md` |
+| **Command Code** | `.commandcode/rules/` | `.commandcode/skills/` | `.commandcode/rules/00-lmagent.md` |
+| **Continue** | `.continue/rules/` | `.continue/skills/` | `.continuerules` |
+| **Crush** | `.crush/rules/` | `.crush/skills/` | `.crush/rules/00-lmagent.md` |
+| **Droid** | `.factory/rules/` | `.factory/skills/` | `.factory/rules/00-lmagent.md` |
+| **Goose** | `.goose/` | `.goose/skills/` | `.goosehints` |
+| **Junie** | `.junie/` | `.junie/skills/` | `.junie/guidelines.md` |
+| **iFlow CLI** | `.iflow/rules/` | `.iflow/skills/` | `.iflow/rules/00-lmagent.md` |
+| **Kilo Code** | `.kilocode/rules/` | `.kilocode/skills/` | `.kilocode/rules/00-lmagent.md` |
+| **Kiro CLI** | `.kiro/rules/` | `.kiro/skills/` | `.kiro/rules/00-lmagent.md` |
+| **Kode** | `.kode/rules/` | `.kode/skills/` | `.kode/rules/00-lmagent.md` |
+| **MCPJam** | `.mcpjam/rules/` | `.mcpjam/skills/` | `.mcpjam/rules/00-lmagent.md` |
+| **Mistral Vibe** | `.vibe/rules/` | `.vibe/skills/` | `.vibe/rules/00-lmagent.md` |
+| **Mux** | `.mux/rules/` | `.mux/skills/` | `.mux/rules/00-lmagent.md` |
+| **OpenCode** | `.opencode/rules/` | `.opencode/skills/` | `.opencode/rules/00-lmagent.md` |
+| **OpenHands** | `.openhands/microagents/` | `.openhands/skills/` | `.openhands/microagents/repo.md` |
+| **Pi** | `.pi/rules/` | `.pi/skills/` | `.pi/rules/00-lmagent.md` |
+| **Qoder** | `.qoder/rules/` | `.qoder/skills/` | `.qoder/rules/00-lmagent.md` |
+| **Qwen Code** | `.qwen/rules/` | `.qwen/skills/` | `.qwen/rules/00-lmagent.md` |
+| **Zencoder** | `.zencoder/rules/` | `.zencoder/skills/` | `.zencoder/rules/00-lmagent.md` |
+| **Neovate** | `.neovate/rules/` | `.neovate/skills/` | `.neovate/rules/00-lmagent.md` |
+| **Pochi** | `.pochi/rules/` | `.pochi/skills/` | `.pochi/rules/00-lmagent.md` |
+| **AdaL** | `.adal/rules/` | `.adal/skills/` | `.adal/rules/00-lmagent.md` |
+
+> **Nota**: Los agentes sin `configFile` propio usan `00-lmagent.md` en su `rulesDir` como bridge de auto-invocación. Este archivo apunta a `AGENTS.md` y activa el framework automáticamente.
 
 ---
 
@@ -201,7 +269,26 @@ No marques una tarea como "Completada" hasta verificar:
 - [ ] **Pruebas**: ¿Lo probaste (aunque sea manualmente)?
 - [ ] **Limpieza**: ¿Borraste logs de debug? ¿El código está limpio?
 - [ ] **Documentación**: ¿Actualizaste `README.md` o creaste documentación si es algo nuevo?
-- [ ] **Estado**: ¿Actualizaste `task.md`?
+- [ ] **Memoria**: ¿Actualizaste `.agents/memory/04-active-context.md` y `task.md`?
+- [ ] **Seguridad**: ¿Verificaste que no hay secretos hardcodeados?
 
 ---
-*LMAgent V3.1.1 - Complete Ecosystem Knowledge.*
+
+## 🚀 9. CLI Reference (Comandos Disponibles)
+
+```bash
+npx @qubiit/lmagent@latest          # Instalar framework (one-shot, sin instalación previa)
+npx lmagent install         # Instalar/actualizar en el proyecto actual
+npx lmagent update          # Alias de install
+npx lmagent init            # Inicializar proyecto nuevo con LMAgent
+npx lmagent doctor          # Verificar configuración del proyecto
+npx lmagent validate        # Validar integridad de todos los skills
+npx lmagent create-skill    # Crear un nuevo skill interactivamente
+npx lmagent tokens          # Analizar consumo de tokens del framework
+npx lmagent skills add owner/repo  # Instalar skill externo desde GitHub
+npx lmagent uninstall       # Eliminar archivos del framework del proyecto
+```
+
+---
+
+*LMAgent V3.1.3 — 37 Agents · 31 Skills · 13 Workflows · 11 Rules · 6 Docs · 5 Memory Files*

package/CLAUDE.md

@@ -1,4 +1,4 @@
-# 🤖 LMAgent Framework v3.1.2
+# 🤖 LMAgent Framework v3.1.3
 
 > [!IMPORTANT]
 > **REDIRECT NOTICE**: La configuración de este framework se ha centralizado.
@@ -7,7 +7,7 @@
 
 Tu "Cerebro" y "Manual de Operaciones" ahora viven en un único archivo maestro.
 
-**� [LEER AGENTS.md](./AGENTS.md) 👈**
+**👉 [LEER AGENTS.md](./AGENTS.md) 👈**
 
 **No intentes hacer nada sin leer `AGENTS.md` primero.**
 Allí encontrarás:

package/CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# Contributing directly to LMAgent
+# Contributing to LMAgent
 
 ¡Gracias por tu interés en contribuir a LMAgent! 🚀
 
@@ -8,83 +8,146 @@ Este documento define el proceso para contribuir código, documentación o repor
 
 Este proyecto se rige por un Código de Conducta estándar. Al participar, se espera que mantengas un ambiente respetuoso y colaborativo.
 
+---
+
 ## ¿Cómo Contribuir?
 
 ### 1. Reportar Bugs
-- Abre un Issue en GitHub.
-- Usa el template de **Bug Report**.
-- Incluye pasos para reproducir, logs y screenshots.
+- Abrí un Issue en GitHub con el template de **Bug Report**
+- Incluí pasos para reproducir, logs y screenshots
+- Especificá tu agente (Cursor, Claude Code, etc.) y sistema operativo
 
 ### 2. Sugerir Features
-- Abre un Issue en GitHub con la etiqueta `enhancement`.
-- Explica el "por qué" y el caso de uso.
-- Si es posible, describe la solución técnica propuesta.
+- Abrí un Issue con la etiqueta `enhancement`
+- Explicá el "por qué" y el caso de uso
+- Si es posible, describí la solución técnica propuesta
 
 ### 3. Pull Requests (PRs)
 
 #### Proceso
-1. Haz un Fork del repositorio.
-2. Crea una rama para tu feature: `git checkout -b feature/mi-nueva-feature`
-3. Implementa tus cambios siguiendo las reglas del proyecto.
-4. Asegúrate de pasar todos los tests: `pytest`
-5. Haz commit con mensajes descriptivos: `feat: agrega soporte para anthropic`
-6. Push a tu rama: `git push origin feature/mi-nueva-feature`
-7. Abre un Pull Request hacia `main`.
+1. Hacé un Fork del repositorio
+2. Creá una rama: `git checkout -b feature/mi-nueva-feature`
+3. Implementá tus cambios siguiendo las reglas del proyecto
+4. Hacé commit con mensajes descriptivos: `feat: agrega soporte para nuevo-agente`
+5. Push a tu rama: `git push origin feature/mi-nueva-feature`
+6. Abrí un Pull Request hacia `main`
 
 #### Checklist para PRs
-- [ ] ¿Actualizaste la documentación?
-- [ ] ¿Agregaste tests para tu código?
-- [ ] ¿Pasaste el linter (`ruff check .`)?
+- [ ] ¿Actualizaste la documentación relevante?
+- [ ] ¿Actualizaste `AGENTS.md` si agregaste un nuevo agente o skill?
 - [ ] ¿Cumple con las reglas en `.agents/rules/`?
+- [ ] ¿Probaste los cambios con `npx @qubiit/lmagent doctor`?
 
-## Estilo de Código
-
-Respetamos estrictamente:
-- **Python**: PEP 8, Type Hints (mypy strict), Ruff para linting/formatting.
-- **Commit Messages**: Conventional Commits (`feat:`, `fix:`, `docs:`, etc).
-- **Documentación**: Markdown claro y conciso.
+---
 
 ## Estructura del Proyecto
 
-- `install.js`: CLI principal (Node.js) — comandos `init`, `install`, `update`, `doctor`.
-- `.agents/skills/`: Definiciones de skills/roles (`SKILL.md` + `scripts/`, `references/`, `assets/`).
-- `.agents/workflows/`: Definiciones de flujos operativos (.md).
-- `.agents/rules/`: Reglas de comportamiento del agente (.md).
-- `.agents/config/`: Archivos YAML de configuración.
-- `.agents/templates/`: Plantillas de proyecto reutilizables.
-- `.agents/docs/`: Documentación extendida.
+```text
+lmagent/
+├── install.js                  # CLI principal — todos los comandos
+├── scripts/
+│   ├── create_skill.js         # Wizard para crear skills
+│   ├── validate_skills.js      # Validador de integridad de skills
+│   └── token-analyzer.js       # Analizador de tokens del framework
+│
+├── .agents/
+│   ├── rules/                  # 11 reglas de comportamiento (.md)
+│   ├── skills/                 # 31 skills especializados (SKILL.md)
+│   ├── workflows/              # 13 SOPs (.md)
+│   ├── memory/                 # 5 archivos de contexto persistente
+│   ├── templates/
+│   │   └── agent-configs/      # Templates de configFile por agente
+│   ├── config/                 # 6 archivos YAML de configuración
+│   ├── docs/                   # Documentación extendida
+│   └── scripts/                # Scripts de utilidad del framework
+│
+├── AGENTS.md                   # Cerebro del framework (leer primero)
+├── CLAUDE.md                   # Entry point para Claude Code / Antigravity
+├── GEMINI.md                   # Entry point para Gemini CLI / Antigravity
+├── README.md                   # Documentación principal
+└── package.json                # Paquete npm: @qubiit/lmagent
+```
+
+---
+
+## Agregar un Nuevo Agente
+
+1. Agregá la configuración en `IDE_CONFIGS` en `install.js`:
+```js
+{ 
+  name: 'Nombre del Agente', 
+  value: 'valor-unico',
+  rulesDir: '.agente/rules',
+  skillsDir: '.agente/skills',
+  workflowsDir: '.agente/workflows',
+  configFile: '.agenterules',        // null si no tiene
+  configTemplate: 'template.md',    // null si usa _generic.md
+  bridgeFile: '00-lmagent.md',       // null si tiene configFile
+  markerFile: '.agente'
+}
+```
+
+2. Agregá la ruta de instalación global en `HOME_PATHS`:
+```js
+'valor-unico': ['.agente', '.config/agente'],
+```
+
+3. Actualizá la tabla de agentes en `AGENTS.md` y `README.md`
+
+4. Si el agente tiene un formato de configFile especial, creá el template en `.agents/templates/agent-configs/`
+
+---
+
+## Agregar un Nuevo Skill
+
+```bash
+npx @qubiit/lmagent@latest create-skill
+```
+
+O manualmente:
+1. Creá el directorio `.agents/skills/mi-skill/`
+2. Creá `SKILL.md` con el frontmatter correcto:
+```yaml
+---
+name: Mi Skill
+trigger: /mi-trigger
+description: Descripción del skill
+version: 1.0.0
+---
+```
+3. Validá con `npx @qubiit/lmagent@latest validate mi-skill`
+4. Actualizá el catálogo en `AGENTS.md` — Sección 5
+
+---
 
 ## Desarrollo Local
 
 ### Prerrequisitos
 - Node.js >= 22
-- Python >= 3.14 (para ejecutar scripts de skills)
-
-### Setup del CLI (Node.js)
 
+### Setup
 ```bash
-# 1. Instalar dependencias
+git clone https://github.com/QuBiit0/lmagent.git
+cd lmagent
 npm install
-
-# 2. Linkear globalmente para desarrollo
 npm link
 
-# 3. Probar cambios
+# Probar cambios
 lmagent doctor
+lmagent validate
+lmagent tokens
 ```
 
-### Desarrollo de Skills (Python)
-
-Si estás creando o modificando scripts Python dentro de `skills/`:
-
-```bash
-# Instalar dependencias de skills (opcional, recomendado usar venv)
-pip install -r .agents/skills/{skill-name}/requirements.txt
-```
+### Convenciones de Commits
+Usamos [Conventional Commits](https://www.conventionalcommits.org/):
+- `feat:` — nueva funcionalidad
+- `fix:` — corrección de bug
+- `docs:` — cambios en documentación
+- `refactor:` — refactoring sin cambio de funcionalidad
+- `chore:` — tareas de mantenimiento
 
-### Linting & Formatting
+---
 
-- **JavaScript**: Eslint/Prettier (vía `npm test` si configurado)
-- **Python**: `ruff check .` (para scripts en `.agents/skills/`)
+¡Gracias por ayudar a hacer LMAgent mejor! 🚀
 
-¡Gracias por ayudar a hacer LMAgent mejor!
+Ver [README.md](README.md) para la documentación completa.