@qubiit/lmagent 2.6.3 → 2.6.5

package/AGENTS.md

@@ -1,6 +1,6 @@
 # 🤖 LMAgent Intelligence Catalog
 
-> Catálogo completo de capacidades del ecosistema **LMAgent v2.6.3**.
+> Catálogo completo de capacidades del ecosistema **LMAgent v2.6.5**.
 > Última actualización: 2026-02-11
 
 ---
@@ -105,7 +105,19 @@ skills/{skill-name}/
 | **scrum-master** | `/sm`, `/agile`, `/coach` | Ceremonias Scrum, sprints, retrospectivas | `references/sprint-ceremonies.md` |
 | **technical-writer** | `/doc`, `/readme`, `/guide` | Documentación, API refs, guías de usuario | `references/doc-templates.md` |
 | **ux-ui-designer** | `/ux`, `/ui`, `/design` | Design systems, UX research, accesibilidad | `references/design-system-foundation.md` |
-| **testing-strategist** | `/test-plan`, `/strategy` | Pirámide de testing, planificación y estrategia de QA | **Uso:** Definición de estrategia. **Vs QA:** Strategist piensa el 'qué'; QA ejecuta el 'cómo'. |
+
+## 📚 2. Knowledge Base (Documentación)
+*Ubicación: `docs/` en la raíz del proyecto.*
+
+El agente debe consultar estos archivos si el usuario tiene dudas sobre el framework:
+
+| Archivo | Propósito |
+| :--- | :--- |
+| `docs/getting-started.md` | Configuración inicial y primeros pasos |
+| `docs/usage-guide.md` | Cómo interactuar con el agente y comandos |
+| `docs/customization-guide.md` | Cómo crear nuevos skills o reglas |
+| `docs/commands.md` | Referencia de comandos CLI (`lmagent ...`) |
+| `docs/navigation-index.md` | Mapa completo de archivos y sus relaciones |
 
 ### 📐 Methodologies
 
@@ -141,6 +153,8 @@ Rules definen **CÓMO** debe comportarse el agente. Son restricciones y estánda
 
 Workflows son **SOPs (Standard Operating Procedures)** que guían al agente en procesos complejos multi-paso.
 
+> **Instrucción para Agente**: Antes de iniciar una tarea compleja, **verifica si existe un workflow** aquí. Si existe, **LÉELO** y síguelo paso a paso.
+
 | Workflow | Propósito |
 |----------|----------|
 | **bugfix-backend.md** | Protocolo para diagnosticar, corregir y verificar bugs de backend |
@@ -178,6 +192,8 @@ Workflows son **SOPs (Standard Operating Procedures)** que guían al agente en p
 
 👉 **[Ver Guía de Uso de Templates](templates/USAGE.md)**
 
+> **Instrucción para Agente**: Cuando debas crear nuevos archivos o proyectos, **usa estos templates como referencia** para mantener la consistencia, no inventes estructuras desde cero.
+
 | Template | Descripción |
 |----------|-------------|
 | **backend-python/** | FastAPI backend con SQLModel |

package/CLAUDE.md

@@ -1,12 +1,12 @@
-# LMAgent Framework v2.6.3 - Claude Code Instructions
+# LMAgent Framework v2.6.5 - Claude Code Instructions
 
 > [!IMPORTANT]
-> **ANTES DE HACER CUALQUIER COSA**: Este proyecto usa el framework **LMAgent v2.6.3**.
+> **ANTES DE HACER CUALQUIER COSA**: Este proyecto usa el framework **LMAgent v2.6.5**.
 > **DEBES** leer `AGENTS.md` y `rules/_bootstrap.md` antes de implementar cualquier cambio.
 
 ## Framework
 
-Estás trabajando con **LMAgent v2.6.3**, un framework para desarrollo de automatizaciones y agentes de IA. Organiza las capacidades del agente en tres pilares: **Skills**, **Rules** y **Workflows**.
+Estás trabajando con **LMAgent v2.6.4**, un framework para desarrollo de automatizaciones y agentes de IA. Organiza las capacidades del agente en tres pilares: **Skills**, **Rules** y **Workflows**.
 
 ## ⚡ Inicio Rápido
 

package/README.md

@@ -6,11 +6,11 @@
 ██║     ██╔████╔██║███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║   
 ██║     ██║╚██╔╝██║██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║   
 ███████╗██║ ╚═╝ ██║██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   
-╚══════╝╚═╝     ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   
+╚══════╝╚╚═╝     ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   
                                                   by QuBit
 ```
 
-![Version](https://img.shields.io/badge/Version-2.6.3-purple?style=for-the-badge) ![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge) ![Agentic](https://img.shields.io/badge/AI-Agentic_Workflow-cyan?style=for-the-badge)
+![Version](https://img.shields.io/badge/version-2.6.5-blue.svg) ![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge) ![Agentic](https://img.shields.io/badge/AI-Agentic_Workflow-cyan?style=for-the-badge)
 
 > **"Separate the reasoning from the execution."**  
 > LMAgent is the foundational runtime that empowers your AI Agents with standardized **Skills**, **Rules**, and **Workflows** across any IDE (Cursor, Windsurf, VSCode, Zed, Qodo).

package/install.js

@@ -29,6 +29,7 @@ const INIT_DIRS = [
     { src: 'config', desc: 'Configuración del framework' },
     { src: 'templates', desc: 'Templates de proyecto' },
     { src: 'docs', desc: 'Documentación extendida' },
+    { src: 'workflows', desc: 'SOPs y Procedimientos' },
 ];
 
 // Configuración: IDEs y Agentes soportados
@@ -368,7 +369,7 @@ const IDE_CONFIGS = [
 program
     .name('lmagent')
     .description('CLI para instalar skills y reglas de LMAgent')
-    .version('2.6.3'); // Version bump
+    .version('2.6.5'); // Version bump
 
 program.command('install')
     .description('Instalar skills, rules y workflows en el IDE del proyecto')
@@ -514,6 +515,7 @@ async function runInstall(options) {
         installTarget = targetAnswer.target;
         targetRoot = (installTarget === 'user') ? userHome : projectRoot;
 
+        console.log('');
         const methodAnswer = await inquirer.prompt([
             {
                 type: 'list',
@@ -587,21 +589,31 @@ async function runInstall(options) {
 
         console.log('');
         console.log(chalk.gray('--- Selección de Contenido ---'));
-        const contentAnswers = await inquirer.prompt([
+        const skillsAnswer = await inquirer.prompt([
             {
                 type: 'checkbox',
                 name: 'skills',
                 message: 'Selecciona los Skills:',
                 choices: availableSkills.map(s => ({ name: s, checked: true })),
                 pageSize: 15
-            },
+            }
+        ]);
+        selectedSkills = skillsAnswer.skills;
+
+        console.log('');
+        const rulesAnswer = await inquirer.prompt([
             {
                 type: 'checkbox',
                 name: 'rules',
                 message: 'Selecciona las Reglas:',
                 choices: availableRules.map(r => ({ name: r, checked: true })),
                 pageSize: 15
-            },
+            }
+        ]);
+        selectedRules = rulesAnswer.rules;
+
+        console.log('');
+        const workflowsAnswer = await inquirer.prompt([
             {
                 type: 'checkbox',
                 name: 'workflows',
@@ -610,10 +622,9 @@ async function runInstall(options) {
                 pageSize: 15
             }
         ]);
-        selectedSkills = contentAnswers.skills;
-        selectedRules = contentAnswers.rules;
-        selectedWorkflows = contentAnswers.workflows;
+        selectedWorkflows = workflowsAnswer.workflows;
 
+        console.log('');
         const { confirm } = await inquirer.prompt([{
             type: 'confirm',
             name: 'confirm',
@@ -843,6 +854,7 @@ function getAllItems(dir, isNested) {
 // ============================================
 
 async function runInit(options) {
+    let targetIdes = []; // Initialize targetIdes
     console.clear();
     const branding = figlet.textSync('LMAGENT', { font: 'ANSI Shadow' });
     console.log(gradient.pastel.multiline(branding));
@@ -898,34 +910,73 @@ async function runInit(options) {
         ]);
         filesToCopy = INIT_FILES.filter(f => answers.files.includes(f.src));
         dirsToCopy = INIT_DIRS.filter(d => answers.dirs.includes(d.src));
+        filesToCopy = INIT_FILES.filter(f => answers.files.includes(f.src));
+        dirsToCopy = INIT_DIRS.filter(d => answers.dirs.includes(d.src));
+
+        // Seleccionar IDE para destino de archivos
+        console.log('');
+        const ideAnswer = await inquirer.prompt([
+            {
+                type: 'checkbox',
+                name: 'ides',
+                message: 'Selecciona tu IDE principal (para ubicar las carpetas):',
+                choices: IDE_CONFIGS.filter(i => i.value !== 'custom').map(i => ({
+                    name: i.name,
+                    value: i.value,
+                    checked: i.value === 'cursor'
+                }))
+            }
+        ]);
+        targetIdes = IDE_CONFIGS.filter(i => ideAnswer.ides.includes(i.value));
+    } else {
+        // Defaults for non-interactive
+        targetIdes = [IDE_CONFIGS.find(i => i.value === 'cursor')];
     }
 
-    // Copiar archivos individuales
-    console.log(chalk.bold('\n📄 Copiando archivos de proyecto:'));
-    for (const file of filesToCopy) {
-        const src = path.join(__dirname, file.src);
-        const dest = path.join(projectRoot, file.src);
-        if (fs.existsSync(src)) {
-            const exists = fs.existsSync(dest);
-            fs.copyFileSync(src, dest);
-            console.log(`  ${chalk.green('✔')} ${file.src} ${exists ? chalk.yellow('(actualizado)') : chalk.green('(nuevo)')}`);
-        } else {
-            console.log(`  ${chalk.red('✘')} ${file.src} ${chalk.red('(no encontrado en el paquete)')}`);
+    // Copiar archivos del framework a la carpeta del Agente (Clean Root)
+    console.log(chalk.bold('\n📦 Instalando framework en directorios de Agente:'));
+
+    for (const ide of targetIdes) {
+        if (!ide.skillsDir) continue; // Skip custom/manual if no dir defined
+
+        // Determinar "Agent Root" (ej: .cursor/ o .github/)
+        // Asume que skillsDir es "root/skills", así que dirname obtiene "root"
+        const agentRootDir = path.join(targetRoot, path.dirname(ide.skillsDir));
+
+        console.log(chalk.dim(`   Destino: ${agentRootDir}`));
+
+        // Crear directorio root si no existe
+        if (!fs.existsSync(agentRootDir)) fs.mkdirSync(agentRootDir, { recursive: true });
+
+        // Copiar Archivos (AGENTS.md, etc - EXCEPTO CLAUDE.md que suele ir en root)
+        for (const file of filesToCopy) {
+            if (file.src === 'CLAUDE.md') {
+                // CLAUDE.md se queda en projectRoot para visibilidad inmediata si se usa Claude
+                // Opcional: Podríamos moverlo también, pero por ahora lo dejamos en root para compatibilidad
+                const dest = path.join(projectRoot, file.src);
+                if (fs.existsSync(path.join(__dirname, file.src))) {
+                    fs.copyFileSync(path.join(__dirname, file.src), dest);
+                    console.log(`   ${chalk.green('✔')} ${file.src} (Project Root)`);
+                }
+                continue;
+            }
+
+            const src = path.join(__dirname, file.src);
+            const dest = path.join(agentRootDir, file.src);
+            if (fs.existsSync(src)) {
+                fs.copyFileSync(src, dest);
+                console.log(`   ${chalk.green('✔')} ${file.src} -> ${path.dirname(ide.skillsDir)}/${file.src}`);
+            }
         }
-    }
 
-    // Copiar directorios
-    console.log(chalk.bold('\n📁 Copiando directorios:'));
-    for (const dir of dirsToCopy) {
-        const src = path.join(__dirname, dir.src);
-        const dest = path.join(projectRoot, dir.src);
-        if (fs.existsSync(src)) {
-            const exists = fs.existsSync(dest);
-            copyRecursiveSync(src, dest, true);
-            const itemCount = getAllItemsFlat(src).length;
-            console.log(`  ${chalk.green('✔')} ${dir.src}/ (${itemCount} archivos) ${exists ? chalk.yellow('(actualizado)') : chalk.green('(nuevo)')}`);
-        } else {
-            console.log(`  ${chalk.red('✘')} ${dir.src}/ ${chalk.red('(no encontrado en el paquete)')}`);
+        // Copiar Directorios (docs, config, templates)
+        for (const dir of dirsToCopy) {
+            const src = path.join(__dirname, dir.src);
+            const dest = path.join(agentRootDir, dir.src);
+            if (fs.existsSync(src)) {
+                copyRecursiveSync(src, dest, true); // Force overwrite
+                console.log(`   ${chalk.green('✔')} ${dir.src}/ -> ${path.dirname(ide.skillsDir)}/${dir.src}/`);
+            }
         }
     }
 
@@ -965,7 +1016,7 @@ DEBUG=true
     }
 
     // Resumen
-    console.log(gradient.pastel.multiline('\n✨ Proyecto inicializado con LMAgent v2.3.0 ✨'));
+    console.log(gradient.pastel.multiline('\n✨ Proyecto inicializado con LMAgent v2.6.5 ✨'));
     console.log('');
     console.log(chalk.cyan('Próximos pasos:'));
     console.log(`  1. ${chalk.bold('lmagent install')} - Instalar skills/rules/workflows en tu IDE`);

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "2.6.3",
+  "version": "2.6.5",
   "description": "CLI to install LMAgent skills and rules into your IDE",
   "main": "install.js",
   "bin": {

package/rules/_bootstrap.md

@@ -1,6 +1,6 @@
 # 🚀 LMAgent Bootstrap — Instrucciones Iniciales
 
-> **Tipo**: `rule` | **Versión**: 2.6.3 | **Prioridad**: MÁXIMA
+> **Tipo**: `rule` | **Versión**: 2.6.5 | **Prioridad**: MÁXIMA
 > Esta regla se aplica **SIEMPRE** como primer paso antes de cualquier tarea.
 
 ---
@@ -15,7 +15,7 @@
 
 ## 🧠 Framework
 
-Estás trabajando con **LMAgent v2.6.3**. Antes de implementar cualquier cambio:
+Estás trabajando con **LMAgent v2.6.5**. Antes de implementar cualquier cambio:
 
 1. **Lee `AGENTS.md`** — Catálogo completo de skills, rules y workflows
 2. **Clasifica la tarea** — Nivel 0-4 según complejidad (ver `rules/workflow.md`)

package/scripts/create_skill.js

@@ -212,7 +212,7 @@ Antes de considerar una tarea terminada, verifica TODO:
 
 // ─── Main ─────────────────────────────────────────────────────
 async function main() {
-    console.log(c.bold('\n🛠️  LMAgent Skill Generator v2.6.3\n'));
+    console.log(c.bold('\n🛠️  LMAgent Skill Generator v2.6.5\n'));
 
     const prompt = createPrompt();
 

package/scripts/validate_skills.js

@@ -194,12 +194,13 @@ function validateSkill(skillDir) {
 function main() {
     const filterSkill = process.argv[2];
 
-    console.log(gradient.pastel.multiline('\n🚀 LMAgent Skills Validator v2.6.3\n'));
+    const c = chalk;
+
+    console.log(c.bold('\n🔍 LMAgent Skill Validator v2.6.5\n'));
     console.log(chalk.dim(`   Directorio: ${SKILLS_DIR}`));
     console.log(chalk.dim(`   Campos obligatorios: ${REQUIRED_FIELDS.length}`));
     console.log('');
 
-    const c = chalk;
 
     if (!existsSync(SKILLS_DIR)) {
         console.error(c.red('❌ No se encontró el directorio skills/'));