@qubiit/lmagent 3.3.1 → 3.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,34 +1,32 @@
1
1
  # 📟 CLI Commands Reference
2
- > **Versión**: 3.1.3 | **Paquete**: `@qubiit/lmagent`
2
+ > **Paquete**: `@qubiit/lmagent`
3
3
 
4
4
  ## ⚡ Comando Principal
5
5
 
6
6
  ```bash
7
7
  npx @qubiit/lmagent@latest
8
8
  ```
9
- Ejecuta el instalador interactivo. Detecta automáticamente los agentes instalados en tu sistema y los pre-selecciona.
9
+ Ejecuta el instalador interactivo. Detecta automáticamente los agentes en tu proyecto y los configura.
10
10
 
11
11
  ---
12
12
 
13
13
  ## 🎯 Comandos Core
14
14
 
15
- ### `lmagent install` / `lmagent update`
16
- Instala o actualiza el framework en el proyecto actual.
17
- - Detecta agentes instalados (Cursor, Claude Code, Windsurf, etc.)
18
- - Copia skills, rules y workflows a cada agente
19
- - Genera el entry point de auto-invocación por agente
15
+ ### `lmagent install`
16
+ Comando unificado que instala y configura el framework en el proyecto actual.
17
+ - Detecta agentes en el proyecto (Cursor, Claude Code, Windsurf, etc.)
18
+ - Instala el core del framework en `.agents/` (skills, rules, workflows, memory, config, docs)
19
+ - Genera bridge files ligeros para cada agente detectado
20
+ - Despliega configFiles específicos (CLAUDE.md, GEMINI.md, etc.) solo cuando corresponde
20
21
  - **Opciones**:
21
22
  - `-f, --force`: Sobrescribe archivos sin preguntar
22
23
  - `-y, --yes`: Modo no interactivo (acepta todo)
23
- - `-g, --global`: También sincroniza a `~/.agents/`
24
+
25
+ ### `lmagent update`
26
+ Alias de `install`. Actualiza skills y reglas en el proyecto.
24
27
 
25
28
  ### `lmagent init`
26
- Inicializa un proyecto nuevo con LMAgent.
27
- - Copia `AGENTS.md`, `CLAUDE.md`, `GEMINI.md` a la raíz
28
- - Copia `config/`, `templates/`, `docs/`, `workflows/`
29
- - **Opciones**:
30
- - `-f, --force`: Sobrescribe archivos existentes
31
- - `-y, --yes`: Sin confirmaciones
29
+ Alias de `install`. Inicializa un proyecto nuevo con LMAgent.
32
30
 
33
31
  ### `lmagent uninstall`
34
32
  Elimina todos los archivos instalados por LMAgent del proyecto.
@@ -36,12 +34,13 @@ Elimina todos los archivos instalados por LMAgent del proyecto.
36
34
  - Pide confirmación antes de proceder
37
35
  - **Opciones**:
38
36
  - `-f, --force`: Sin confirmación
39
- - `--all`: También elimina entry points raíz (CLAUDE.md, GEMINI.md, AGENTS.md, .cursorrules, etc.)
37
+ - `--all`: También elimina entry points raíz (CLAUDE.md, GEMINI.md, AGENTS.md)
40
38
 
41
39
  ### `lmagent doctor`
42
40
  Verifica que el proyecto esté correctamente configurado.
43
- - Comprueba archivos críticos (`AGENTS.md`, `CLAUDE.md`, `GEMINI.md`)
44
- - Verifica directorios de agentes instalados y sus `configFile`
41
+ - Comprueba archivos críticos (`AGENTS.md`)
42
+ - Verifica core en `.agents/` (skills, rules, workflows)
43
+ - Detecta agentes configurados
45
44
  - Revisa `.gitignore`
46
45
 
47
46
  ### `lmagent validate [skill]`
@@ -56,7 +55,6 @@ Genera la estructura estándar y el `SKILL.md` con frontmatter correcto.
56
55
  ### `lmagent tokens`
57
56
  Analiza el consumo de tokens del framework instalado en el proyecto.
58
57
  - Muestra breakdown por categoría (rules, skills, workflows, etc.)
59
- - Destaca el overhead real de sesión (~2,200 tokens) vs. total del framework
60
58
  - **Opciones**:
61
59
  - `--json`: Salida en formato JSON
62
60
  - `--report`: Genera reporte en `.agents/token-report.md`
@@ -1,6 +1,6 @@
1
1
  # 🚀 Getting Started with LMAgent
2
2
 
3
- Bienvenido a **LMAgent v3.1.3** — el framework que transforma cualquier agente de IA en una agencia de desarrollo de software completa.
3
+ Bienvenido a **LMAgent v3.4.1** — el framework que transforma cualquier agente de IA en una agencia de desarrollo de software completa.
4
4
 
5
5
  ## Requisitos Previos
6
6
  - **Node.js**: v22+ (requerido para el CLI)
@@ -14,29 +14,16 @@ Bienvenido a **LMAgent v3.1.3** — el framework que transforma cualquier agente
14
14
  npx @qubiit/lmagent@latest
15
15
  ```
16
16
 
17
- Eso es todo. El instalador:
18
- 1. Detecta automáticamente qué agentes tenés instalados en tu sistema
19
- 2. Pre-selecciona los detectados para instalación
20
- 3. Despliega skills, rules y workflows a cada agente
21
- 4. Genera el entry point de auto-invocación
17
+ Un solo comando. El instalador:
18
+ 1. Despliega `AGENTS.md` a la raíz del proyecto (entry point universal)
19
+ 2. Detecta automáticamente qué agentes tenés en el proyecto
20
+ 3. Instala skills, rules, workflows, memory, config y docs en `.agents/` (centralizado)
21
+ 4. Genera bridge files ligeros para cada agente detectado
22
+ 5. Despliega config files específicos (CLAUDE.md, GEMINI.md) solo cuando corresponde
22
23
 
23
- ---
24
-
25
- ## Setup Paso a Paso (Primera Vez)
26
-
27
- ### Paso 1 — Inicializar el proyecto
28
- ```bash
29
- npx @qubiit/lmagent@latest init
30
- ```
31
- Copia `AGENTS.md`, `CLAUDE.md` y `GEMINI.md` a la raíz de tu proyecto. Estos son los archivos que los agentes leen automáticamente al arrancar.
32
-
33
- ### Paso 2 — Instalar el framework
34
- ```bash
35
- npx @qubiit/lmagent@latest install
36
- ```
37
- Seleccioná los agentes que usás y el instalador configura todo.
24
+ > `lmagent init`, `lmagent install` y `lmagent update` ejecutan el mismo flujo unificado.
38
25
 
39
- ### Paso 3 — Verificar
26
+ ### Verificar
40
27
  ```bash
41
28
  npx @qubiit/lmagent@latest doctor
42
29
  ```
@@ -64,7 +51,7 @@ El agente detectará `/pm`, cargará el skill **product-manager** y actuará en
64
51
 
65
52
  ```bash
66
53
  npx @qubiit/lmagent@latest doctor # Verificar configuración
67
- npx @qubiit/lmagent@latest update # Actualizar a la última versión
54
+ npx @qubiit/lmagent@latest update # Actualizar (alias de install)
68
55
  npx @qubiit/lmagent@latest validate # Validar integridad de skills
69
56
  npx @qubiit/lmagent@latest tokens # Ver consumo de tokens del framework
70
57
  npx @qubiit/lmagent@latest uninstall # Limpiar archivos del framework
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
 
3
3
  /**
4
- * LMAgent Skill Generator — v3.0.13
4
+ * LMAgent Skill Generator — v3.4.0
5
5
  *
6
6
  * Genera la estructura completa de un nuevo skill interactivamente.
7
7
  *
@@ -18,7 +18,7 @@ import { createInterface } from 'readline';
18
18
  const __filename = fileURLToPath(import.meta.url);
19
19
  const __dirname = dirname(__filename);
20
20
  const ROOT = resolve(__dirname, '..');
21
- const SKILLS_DIR = join(ROOT, 'skills');
21
+ const SKILLS_DIR = join(ROOT, '.agents', 'skills');
22
22
 
23
23
  // ─── Colores ──────────────────────────────────────────────────
24
24
  const c = {
@@ -92,7 +92,7 @@ name: ${data.name}
92
92
  description: ${data.description}
93
93
  role: ${data.role}
94
94
  type: ${data.type}
95
- version: 3.0.0
95
+ version: "3.4.0"
96
96
  icon: ${data.icon}
97
97
  expertise:
98
98
  ${expertise}
@@ -206,13 +206,13 @@ Antes de considerar una tarea terminada, verifica TODO:
206
206
 
207
207
  ---
208
208
 
209
- *Skill version: 2.7 | LMAgent Framework*
209
+ *Skill version: 3.4.0 | LMAgent Framework*
210
210
  `;
211
211
  }
212
212
 
213
213
  // ─── Main ─────────────────────────────────────────────────────
214
214
  async function main() {
215
- console.log(c.bold('\n🛠️ LMAgent Skill Generator v3.0.0\n'));
215
+ console.log(c.bold('\n🛠️ LMAgent Skill Generator v3.4.0\n'));
216
216
 
217
217
  const prompt = createPrompt();
218
218
 
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
 
3
3
  /**
4
- * LMAgent Skills Validator — v3.0.13
4
+ * LMAgent Skills Validator — v3.4.0
5
5
  *
6
6
  * Valida la integridad de todos los skills del framework.
7
7
  * Verifica: frontmatter YAML, campos obligatorios, estructura de directorio.
@@ -24,12 +24,12 @@ import chalk from 'chalk';
24
24
  const __filename = fileURLToPath(import.meta.url);
25
25
  const __dirname = dirname(__filename);
26
26
  const ROOT = resolve(__dirname, '..');
27
- const SKILLS_DIR = join(ROOT, 'skills');
27
+ const SKILLS_DIR = join(ROOT, '.agents', 'skills');
28
28
 
29
29
  // ─── Configuración ────────────────────────────────────────────
30
30
  const REQUIRED_FIELDS = ['name', 'description', 'role', 'type', 'version', 'icon', 'expertise', 'activates_on', 'triggers'];
31
31
  const VALID_TYPES = ['agent_persona', 'methodology'];
32
- const CURRENT_VERSION = '3.0.13';
32
+ const CURRENT_VERSION = '3.4.0';
33
33
  const OPTIONAL_DIRS = ['scripts', 'references', 'assets'];
34
34
 
35
35
  // ─── Colores (sin dependencias) ───────────────────────────────
@@ -65,7 +65,7 @@ function parseFrontmatter(content) {
65
65
  }
66
66
 
67
67
  // Key-value: "key: value"
68
- const kvMatch = line.match(/^(\w[\w_]*)\s*:\s*(.*)/);
68
+ const kvMatch = line.match(/^\s*(\w[\w_]*)\s*:\s*(.*)/);
69
69
  if (kvMatch) {
70
70
  currentKey = kvMatch[1];
71
71
  const rawValue = kvMatch[2].trim();
@@ -197,7 +197,7 @@ function main() {
197
197
 
198
198
  const c = chalk;
199
199
 
200
- console.log(c.bold('\n🔍 LMAgent Skill Validator v3.0.0\n'));
200
+ console.log(c.bold('\n🔍 LMAgent Skill Validator v3.4.0\n'));
201
201
  console.log(chalk.dim(` Directorio: ${SKILLS_DIR}`));
202
202
  console.log(chalk.dim(` Campos obligatorios: ${REQUIRED_FIELDS.length}`));
203
203
  console.log('');
package/AGENTS.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 🤖 LMAgent V3: The Engineering Constitution
2
2
  > **SINGLE SOURCE OF TRUTH**: Este archivo es tu Ley Suprema. Define tu identidad, tus capacidades y tus límites.
3
- > Framework: **LMAgent v3.3.0 (Total Awareness Standard)**
3
+ > Framework: **LMAgent v3.4.1 (Total Awareness Standard)**
4
4
 
5
5
  ---
6
6
 
@@ -300,9 +300,9 @@ No marques una tarea como "Completada" hasta verificar:
300
300
 
301
301
  ```bash
302
302
  npx @qubiit/lmagent@latest # Instalar framework (one-shot, sin instalación previa)
303
- npx lmagent install # Instalar/actualizar en el proyecto actual
303
+ npx lmagent install # Instalar/actualizar todo en el proyecto actual
304
+ npx lmagent init # Alias de install
304
305
  npx lmagent update # Alias de install
305
- npx lmagent init # Inicializar proyecto nuevo con LMAgent
306
306
  npx lmagent doctor # Verificar configuración del proyecto
307
307
  npx lmagent validate # Validar integridad de todos los skills
308
308
  npx lmagent create-skill # Crear un nuevo skill interactivamente
@@ -313,4 +313,4 @@ npx lmagent uninstall # Eliminar archivos del framework del proyecto
313
313
 
314
314
  ---
315
315
 
316
- *LMAgent V3.3.0 — 37 Agents · 31 Skills · 13 Workflows · 11 Rules · 6 Docs · 5 Memory Files*
316
+ *LMAgent V3.4.1 — 37 Agents · 31 Skills · 13 Workflows · 11 Rules · 6 Docs · 5 Memory Files*
package/CLAUDE.md CHANGED
@@ -7,15 +7,15 @@
7
7
  *Lee este archivo INMEDIATAMENTE para obtener tu identidad, skills y reglas operativas.*
8
8
 
9
9
  ## 🔄 ARRANQUE AUTOMÁTICO (Haz esto al iniciar cada sesión)
10
- 1. **Lee [AGENTS.md](./AGENTS.md)** — Tu catálogo completo (31 skills, 11 rules, 13 workflows)
10
+ 1. **Lee [AGENTS.md](./AGENTS.md)** — Tu catálogo completo de capacidades
11
11
  2. **Lee `.agents/rules/00-master.md`** — Reglas, protocolo de trabajo y triggers
12
12
  3. **Si existe `.agents/memory/04-active-context.md`** — Recupera contexto previo
13
13
  4. **Clasifica la tarea** (Nivel 0-4) y activa el skill apropiado
14
14
 
15
15
  ## 📁 RUTAS DE ENTORNO
16
- - **Skills**: `.claude/skills/` o `.agents/skills/`
17
- - **Rules**: `.claude/rules/` o `.agents/rules/`
18
- - **Workflows**: `.claude/workflows/` o `.agents/workflows/`
16
+ - **Skills**: `.agents/skills/`
17
+ - **Rules**: `.agents/rules/`
18
+ - **Workflows**: `.agents/workflows/`
19
19
  - **Memory**: `.agents/memory/`
20
20
  - **Config**: `.agents/config/`
21
21
 
@@ -29,6 +29,6 @@
29
29
  | `/fix` | **Debugger** | Análisis de bugs. |
30
30
  | `/arch` | **Architect** | Diseño de sistemas. |
31
31
 
32
- > **IMPORTANTE**: Para activar un skill, lee su `SKILL.md` completo en `skills/[nombre]/SKILL.md`.
32
+ > **IMPORTANTE**: Para activar un skill, lee su `SKILL.md` completo en `.agents/skills/[nombre]/SKILL.md`.
33
33
 
34
34
  !! SYSTEM NOTE: You MUST read AGENTS.md at startup to understand the full framework. !!
package/CONTRIBUTING.md CHANGED
@@ -62,7 +62,7 @@ lmagent/
62
62
  │ └── scripts/ # Scripts de utilidad del framework
63
63
 
64
64
  ├── AGENTS.md # Cerebro del framework (leer primero)
65
- ├── CLAUDE.md # Entry point para Claude Code / Antigravity
65
+ ├── CLAUDE.md # Entry point para Claude Code
66
66
  ├── GEMINI.md # Entry point para Gemini CLI / Antigravity
67
67
  ├── README.md # Documentación principal
68
68
  └── package.json # Paquete npm: @qubiit/lmagent
@@ -87,14 +87,9 @@ lmagent/
87
87
  }
88
88
  ```
89
89
 
90
- 2. Agregá la ruta de instalación global en `HOME_PATHS`:
91
- ```js
92
- 'valor-unico': ['.agente', '.config/agente'],
93
- ```
94
-
95
- 3. Actualizá la tabla de agentes en `AGENTS.md` y `README.md`
90
+ 2. Actualizá la tabla de agentes en `AGENTS.md` y `README.md`
96
91
 
97
- 4. Si el agente tiene un formato de configFile especial, creá el template en `.agents/templates/agent-configs/`
92
+ 3. Si el agente tiene un formato de configFile especial, creá el template en `.agents/templates/agent-configs/`
98
93
 
99
94
  ---
100
95
 
package/GEMINI.md CHANGED
@@ -7,15 +7,15 @@
7
7
  *Lee este archivo INMEDIATAMENTE para obtener tu identidad, skills y reglas operativas.*
8
8
 
9
9
  ## 🔄 ARRANQUE AUTOMÁTICO (Haz esto al iniciar cada sesión)
10
- 1. **Lee [AGENTS.md](./AGENTS.md)** — Tu catálogo completo (31 skills, 11 rules, 13 workflows)
10
+ 1. **Lee [AGENTS.md](./AGENTS.md)** — Tu catálogo completo de capacidades
11
11
  2. **Lee `.agents/rules/00-master.md`** — Reglas, protocolo de trabajo y triggers
12
12
  3. **Si existe `.agents/memory/04-active-context.md`** — Recupera contexto previo
13
13
  4. **Clasifica la tarea** (Nivel 0-4) y activa el skill apropiado
14
14
 
15
15
  ## 📁 RUTAS DE ENTORNO
16
- - **Skills**: `.gemini/skills/` o `.agents/skills/`
17
- - **Rules**: `.gemini/rules/` o `.agents/rules/`
18
- - **Workflows**: `.gemini/workflows/` o `.agents/workflows/`
16
+ - **Skills**: `.agents/skills/`
17
+ - **Rules**: `.agents/rules/`
18
+ - **Workflows**: `.agents/workflows/`
19
19
  - **Memory**: `.agents/memory/`
20
20
  - **Config**: `.agents/config/`
21
21
 
@@ -29,6 +29,6 @@
29
29
  | `/fix` | **Debugger** | Análisis de bugs. |
30
30
  | `/arch` | **Architect** | Diseño de sistemas. |
31
31
 
32
- > **IMPORTANTE**: Para activar un skill, lee su `SKILL.md` completo en `skills/[nombre]/SKILL.md`.
32
+ > **IMPORTANTE**: Para activar un skill, lee su `SKILL.md` completo en `.agents/skills/[nombre]/SKILL.md`.
33
33
 
34
34
  !! SYSTEM NOTE: You MUST read AGENTS.md at startup to understand the full framework. !!
package/README.md CHANGED
@@ -10,7 +10,7 @@
10
10
  by QuBit
11
11
  ```
12
12
 
13
- ![Version](https://img.shields.io/badge/version-3.3.0-blue.svg) ![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge) ![Agents](https://img.shields.io/badge/Agents-37_Supported-cyan?style=for-the-badge) ![Skills](https://img.shields.io/badge/Skills-31_Available-purple?style=for-the-badge)
13
+ ![Version](https://img.shields.io/badge/version-3.4.1-blue.svg) ![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge) ![Agents](https://img.shields.io/badge/Agents-37_Supported-cyan?style=for-the-badge) ![Skills](https://img.shields.io/badge/Skills-31_Available-purple?style=for-the-badge)
14
14
 
15
15
  > **"Separate the reasoning from the execution."**
16
16
  > LMAgent is the foundational runtime that empowers your AI Agents with standardized **Skills**, **Rules**, and **Workflows** across **37 supported agents** (Cursor, Claude Code, Windsurf, Gemini CLI, Cline, Roo, Copilot, and many more).
@@ -29,34 +29,29 @@ That's it. No global install required. LMAgent will:
29
29
  3. **Deploy** skills, rules, and workflows **strictly to your project directory** (Universal Brain: `.agents/`)
30
30
  4. **Generate** the entry point file so each agent auto-invokes the framework
31
31
 
32
- > **Requires Node.js ≥ 22**. Works on macOS, Linux, and Windows. **V3.3.0 features strict project isolation to prevent global conflicts.**
32
+ > **Requires Node.js ≥ 22**. Works on macOS, Linux, and Windows. **V3.4.0 features a unified install command and centralized `.agents/` architecture.**
33
33
 
34
34
  ---
35
35
 
36
36
  ## 🚀 Full Setup Guide
37
37
 
38
- ### Step 1Initialize your project (first time only)
38
+ ### One CommandInstall Everything
39
39
  ```bash
40
- npx @qubiit/lmagent@latest init
40
+ npx @qubiit/lmagent@latest
41
41
  ```
42
- Copies `AGENTS.md` to your project root. This is the **single entry point** that all agents read automatically. Agent-specific files (`CLAUDE.md`, `GEMINI.md`) are deployed only when their agent is detected during install.
42
+ This single command:
43
+ 1. Deploys `AGENTS.md` to your project root (the universal entry point)
44
+ 2. Auto-detects which AI agents you have in the project
45
+ 3. Installs all skills, rules, workflows, memory, config, and docs to `.agents/`
46
+ 4. Generates lightweight bridge files for each detected agent
47
+ 5. Deploys agent-specific config files (CLAUDE.md, GEMINI.md) only when needed
43
48
 
44
- ### Step 2 Install the framework
45
- ```bash
46
- npx @qubiit/lmagent@latest install
47
- ```
48
- Deploys skills, rules, and workflows to all detected agents. Generates agent-specific config files.
49
+ > `lmagent init`, `lmagent install`, and `lmagent update` all run the same unified flow.
49
50
 
50
- ### Step 3 — Verify
51
+ ### Verify
51
52
  ```bash
52
53
  npx @qubiit/lmagent@latest doctor
53
54
  ```
54
- Checks that everything is correctly configured.
55
-
56
- ### Update (when new versions are released)
57
- ```bash
58
- npx @qubiit/lmagent@latest update
59
- ```
60
55
 
61
56
  ---
62
57
 
@@ -72,7 +67,6 @@ Your Project/
72
67
  │ ├── workflows/ # 13 SOPs (Standard Operating Procedures)
73
68
  │ ├── memory/ # 5 persistent context files
74
69
  │ ├── templates/ # Project scaffolds & agent config templates
75
- │ ├── scripts/ # Utility scripts
76
70
  │ ├── config/ # Framework settings
77
71
  │ └── docs/ # Extended documentation
78
72
 
@@ -80,10 +74,9 @@ Your Project/
80
74
  ├── CLAUDE.md # ← Only if Claude Code is detected
81
75
  ├── GEMINI.md # ← Only if Gemini CLI / Antigravity is detected
82
76
 
83
- ├── .cursor/rules/ # ← Cursor-specific rules & skills
84
- ├── .windsurf/rules/ # ← Windsurf-specific rules & skills
85
- ├── .claude/rules/ # Claude Code-specific rules & skills
86
- └── ... # (one directory per installed agent)
77
+ ├── .cursor/rules/00-lmagent.mdc # ← Lightweight bridge (points to AGENTS.md)
78
+ ├── .windsurf/rules/lmagent.md # ← Lightweight bridge (points to AGENTS.md)
79
+ └── ... # (one bridge file per installed agent)
87
80
  ```
88
81
 
89
82
  ### How auto-invocation works
@@ -212,10 +205,10 @@ Activate any skill by typing its trigger in the chat:
212
205
  ## 🛠️ CLI Reference
213
206
 
214
207
  ```bash
215
- # Core
208
+ # Core (all three run the same unified flow)
216
209
  npx @qubiit/lmagent@latest # Interactive install (auto-detects agents)
217
- npx @qubiit/lmagent@latest init # Initialize project (copies AGENTS.md)
218
- npx @qubiit/lmagent@latest install # Install/update framework in current project
210
+ npx @qubiit/lmagent@latest install # Same as above
211
+ npx @qubiit/lmagent@latest init # Alias for install
219
212
  npx @qubiit/lmagent@latest update # Alias for install
220
213
  npx @qubiit/lmagent@latest uninstall # Remove all LMAgent files from project
221
214
  npx @qubiit/lmagent@latest uninstall --all # Also remove root entry points (CLAUDE.md, etc.)