@qubiit/lmagent 3.1.9 → 3.3.0

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.
Files changed (11) hide show
  1. package/.agents/rules/00-master.md +5 -3
  2. package/.agents/templates/agent-configs/_generic.md +18 -3
  3. package/AGENTS.md +57 -35
  4. package/CLAUDE.md +34 -19
  5. package/GEMINI.md +34 -0
  6. package/README.md +17 -16
  7. package/install.js +1573 -1520
  8. package/package.json +85 -84
  9. package/scripts/create_skill.js +4 -4
  10. package/scripts/validate_skills.js +3 -3
  11. package/scripts/fix_descriptions.js +0 -51
package/.agents/rules/00-master.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 🚀 LMAgent Bootstrap — Instrucciones Iniciales
2
2
 
3
- > **Tipo**: `rule` | **Versión**: 3.1.9 | **Prioridad**: MÁXIMA
3
+ > **Tipo**: `rule` | **Versión**: 3.3.0 | **Prioridad**: MÁXIMA
4
4
  > Esta regla se aplica **SIEMPRE** como primer paso antes de cualquier tarea.
5
5
 
6
6
  ---
@@ -15,7 +15,7 @@
15
15
 
16
16
  ## 🧠 Framework
17
17
 
18
- Este archivo define la identidad, propósito y reglas fundamentales de **LMAgent v3.1.6**. Antes de implementar cualquier cambio:
18
+ Este archivo define la identidad, propósito y reglas fundamentales de **LMAgent v3.3.0**. Antes de implementar cualquier cambio:
19
19
 
20
20
  1. **Lee `AGENTS.md`** — Catálogo completo de skills, rules y workflows
21
21
  2. **Clasifica la tarea** — Nivel 0-4 según complejidad (ver `.agents/rules/01-workflow.md`)
@@ -42,10 +42,11 @@ Este archivo define la identidad, propósito y reglas fundamentales de **LMAgent
42
42
 
43
43
  ---
44
44
 
45
- ## 🎯 Skills Disponibles (31)
45
+ ## 🎯 Skills Disponibles
46
46
 
47
47
  Activa el skill apropiado según la tarea. Cada skill tiene `SKILL.md` con instrucciones detalladas, y opcionalmente `scripts/`, `references/` y `assets/`.
48
48
 
49
+ <!-- SKILLS_CATALOG_START -->
49
50
  ### Meta-Skill
50
51
  | Skill | Triggers | Descripción |
51
52
  |-------|----------|-------------|
@@ -104,6 +105,7 @@ Activa el skill apropiado según la tarea. Cada skill tiene `SKILL.md` con instr
104
105
  | **bmad-methodology** | `/bmad` | Scale-Adaptive Intelligence, niveles 0-4 |
105
106
  | **swe-agent** | `/swe`, `/issue-solve`, `/trajectory` | Resolución autónoma de issues |
106
107
  | **spec-driven-dev** | `/spec-dev`, `/sdd-skill`, `/spec-method` | Pipeline: Specify→Plan→Tasks→Implement→Verify |
108
+ <!-- SKILLS_CATALOG_END -->
107
109
 
108
110
  ---
109
111
 
package/.agents/templates/agent-configs/_generic.md CHANGED
@@ -5,8 +5,21 @@
5
5
  **TU CONTEXTO Y REGLAS VIVEN AQUÍ 👉 [AGENTS.md](./AGENTS.md)**
6
6
  *Lee este archivo INMEDIATAMENTE para obtener tu identidad, skills y reglas operativas.*
7
7
 
8
- ## ⚡ QUICK START TRIGGERS (Menu Rápido)
9
- Use estos comandos para activar su rol. Para detalles, consulte `AGENTS.md`.
8
+ ## 🔄 ARRANQUE AUTOMÁTICO (Haz esto al iniciar cada sesión)
9
+ 1. **Lee [AGENTS.md](./AGENTS.md)** — Tu catálogo completo de capacidades (31 skills, 11 rules, 13 workflows)
10
+ 2. **Lee `.agents/rules/00-master.md`** — Reglas, protocolo de trabajo y tabla de skills con triggers
11
+ 3. **Si existe `.agents/memory/04-active-context.md`** — Léelo para recuperar contexto de la sesión anterior
12
+ 4. **Clasifica la tarea** (Nivel 0-4 según complejidad) y activa el skill apropiado
13
+
14
+ ## 📁 RUTAS DE ENTORNO
15
+ - **Skills**: `{{SKILLS_DIR}}` → Cada skill tiene `SKILL.md` con instrucciones completas
16
+ - **Rules**: `{{RULES_DIR}}` → Guardrails de comportamiento (CÓMO trabajar)
17
+ - **Workflows**: `{{WORKFLOWS_DIR}}` → SOPs y procedimientos (flujos paso a paso)
18
+ - **Memory**: `.agents/memory/` → Contexto persistente entre sesiones
19
+ - **Config**: `.agents/config/` → Configuración del framework (tools, models, levels)
20
+
21
+ ## ⚡ QUICK START TRIGGERS (Menú Rápido)
22
+ Usa estos comandos para activar un rol. Para el catálogo completo de 31 skills, consulta `AGENTS.md`.
10
23
 
11
24
  | Trigger | Rol / Skill | Objetivo |
12
25
  |:--- |:--- |:--- |
@@ -17,4 +30,6 @@ Use estos comandos para activar su rol. Para detalles, consulte `AGENTS.md`.
17
30
  | `/fix` | **Debugger** | Análisis de bugs. |
18
31
  | `/arch` | **Architect** | Diseño de sistemas. |
19
32
 
20
- !! SYSTEM NOTE: Read AGENTS.md to understand how to execute these roles. !!
33
+ > **IMPORTANTE**: Para activar un skill, lee su `SKILL.md` completo en `{{SKILLS_DIR}}/[nombre]/SKILL.md`.
34
+
35
+ !! SYSTEM NOTE: You MUST read AGENTS.md at startup to understand the full framework capabilities. !!
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.1.3 (Total Awareness Standard)**
3
+ > Framework: **LMAgent v3.3.0 (Total Awareness Standard)**
4
4
 
5
5
  ---
6
6
 
@@ -147,12 +147,14 @@ Clasifica tu tarea actual para decidir tu nivel de autonomía:
147
147
 
148
148
  ---
149
149
 
150
- ## 🏗️ 5. Skills Catalog (31 Skills Disponibles)
150
+ ## 🏗️ 5. Skills Catalog
151
151
  Ubicación Universal: `.agents/skills/[nombre_skill]/SKILL.md`
152
152
 
153
153
  > **Cómo activar un skill**: Escribe el trigger en el chat. El agente cargará el `SKILL.md` correspondiente.
154
154
  > **Cómo funciona**: Cada skill define un rol especializado con sus propias instrucciones, herramientas y criterios de éxito.
155
+ > **Nota**: Esta sección se actualiza automáticamente con `lmagent install` al detectar skills nuevos.
155
156
 
157
+ <!-- SKILLS_CATALOG_START -->
156
158
  ### 🎯 Management & Architecture
157
159
  | Trigger | Skill | Directorio |
158
160
  |:---|:---|:---|
@@ -199,6 +201,7 @@ Ubicación Universal: `.agents/skills/[nombre_skill]/SKILL.md`
199
201
  | `/sdd` | **spec-driven-dev** | `.agents/skills/spec-driven-dev/` |
200
202
  | `/swe` | **swe-agent** | `.agents/skills/swe-agent/` |
201
203
  | `/test-s` | **testing-strategist** | `.agents/skills/testing-strategist/` |
204
+ <!-- SKILLS_CATALOG_END -->
202
205
 
203
206
  ---
204
207
 
@@ -216,48 +219,67 @@ Ubicación Universal: `.agents/skills/[nombre_skill]/SKILL.md`
216
219
  ## 🌐 7. Mapa de Agentes Soportados (37 Agentes)
217
220
  La lista completa de dónde busca instrucciones CADA agente soportado por LMAgent.
218
221
 
222
+ ### 🔄 Auto-Invocación
223
+
224
+ Cuando un agente abre un proyecto con LMAgent instalado, el flujo es:
225
+
226
+ 1. **El agente lee su `configFile`** (ej: `CLAUDE.md`, `GEMINI.md`) o su **`bridgeFile`** en `rulesDir`
227
+ 2. **Ese archivo le dice que lea `AGENTS.md`** → El catálogo completo de capacidades
228
+ 3. **`AGENTS.md` lo dirige a `00-master.md`** → Las reglas operativas y tabla de skills
229
+ 4. **El agente carga el `SKILL.md` apropiado** según la tarea del usuario
230
+ 5. **Si existe `04-active-context.md`** → Recupera contexto de la sesión anterior
231
+
232
+ > **Resultado**: El agente conoce TODO el framework automáticamente, sin que el usuario tenga que invocarlo manualmente.
233
+
234
+ ### 📊 Tabla de Configuración por Agente
235
+
219
236
  | Agente | Rules Directory | Skills Directory | Entry Point (configFile) |
220
237
  | :--- | :--- | :--- | :--- |
221
- | **Cursor** | `.cursor/rules/` | `.cursor/skills/` | `.cursorrules` |
222
- | **Windsurf** | `.windsurf/rules/` | `.windsurf/skills/` | `.windsurf/rules/lmagent.md` |
223
- | **Cline** | `.clinerules/` | `.cline/skills/` | `.clinerules/00-lmagent.md` |
224
- | **Roo Code** | `.roo/rules/` | `.roo/skills/` | `.roo/rules/00-lmagent.md` |
238
+ | **Cursor** | `.cursor/rules/` | `.cursor/rules/skills/` | `AGENTS.md` (nativo) + bridge `.cursor/rules/00-lmagent.mdc` |
239
+ | **Windsurf** | `.windsurf/rules/` | `.windsurf/skills/` | `.windsurf/rules/lmagent.md` (bridge) |
240
+ | **Cline** | `.clinerules/` | `.cline/skills/` | `.clinerules/00-lmagent.md` (bridge) |
241
+ | **Roo Code** | `.roo/rules/` | `.roo/skills/` | `AGENTS.md` (nativo) + bridge `.roo/rules/00-lmagent.md` |
225
242
  | **VSCode Copilot** | `.github/instructions/` | `.github/skills/` | `.github/copilot-instructions.md` |
226
- | **Trae** | `.trae/rules/` | `.trae/skills/` | `.trae/rules/lmagent.md` |
227
- | **Trae CN** | `.trae-cn/rules/` | `.trae-cn/skills/` | `.trae-cn/rules/lmagent.md` |
243
+ | **Trae** | `.trae/rules/` | `.trae/skills/` | `.trae/rules/lmagent.md` (bridge) |
244
+ | **Trae CN** | `.trae-cn/rules/` | `.trae-cn/skills/` | `.trae-cn/rules/lmagent.md` (bridge) |
228
245
  | **Claude Code** | `.claude/rules/` | `.claude/skills/` | `CLAUDE.md` |
229
- | **Zed** | `.rules/` | `.rules/skills/` | `.rules/lmagent.md` |
230
- | **Amp / Kimi / Replit** | `.agents/rules/` | `.agents/skills/` | `.agents/rules/00-lmagent.md` |
246
+ | **Zed** | `.rules/` | `.rules/skills/` | `AGENTS.md` (nativo) + bridge `.rules/lmagent.md` |
247
+ | **Amp / Kimi / Replit** | `.agents/rules/` | `.agents/skills/` | `AGENTS.md` (nativo) |
231
248
  | **Antigravity** | `.agent/rules/` | `.agent/skills/` | `GEMINI.md` |
232
- | **Augment** | `.augment/rules/` | `.augment/skills/` | `.augment/rules/00-lmagent.md` |
249
+ | **Augment** | `.augment/rules/` | `.augment/skills/` | `.augment/rules/00-lmagent.md` (bridge) |
233
250
  | **Gemini CLI** | `.gemini/rules/` | `.gemini/skills/` | `GEMINI.md` |
234
251
  | **OpenClaw / Envoid** | `rules/` | `skills/` | `openclaw.json` |
235
- | **CodeBuddy** | `.codebuddy/rules/` | `.codebuddy/skills/` | `.codebuddy/rules/00-lmagent.md` |
252
+ | **CodeBuddy** | `.codebuddy/rules/` | `.codebuddy/skills/` | `.codebuddy/rules/00-lmagent.md` (bridge) |
236
253
  | **Codex CLI** | `.codex/` | `.codex/skills/` | `AGENTS.md` |
237
- | **Command Code** | `.commandcode/rules/` | `.commandcode/skills/` | `.commandcode/rules/00-lmagent.md` |
238
- | **Continue** | `.continue/rules/` | `.continue/skills/` | `.continuerules` |
239
- | **Crush** | `.crush/rules/` | `.crush/skills/` | `.crush/rules/00-lmagent.md` |
240
- | **Droid** | `.factory/rules/` | `.factory/skills/` | `.factory/rules/00-lmagent.md` |
241
- | **Goose** | `.goose/` | `.goose/skills/` | `.goosehints` |
254
+ | **Command Code** | `.commandcode/rules/` | `.commandcode/skills/` | `.commandcode/rules/00-lmagent.md` (bridge) |
255
+ | **Continue** | `.continue/rules/` | `.continue/skills/` | `.continue/continuerules` |
256
+ | **Crush** | `.crush/rules/` | `.crush/skills/` | `.crush/rules/00-lmagent.md` (bridge) |
257
+ | **Droid** | `.factory/rules/` | `.factory/skills/` | `.factory/rules/00-lmagent.md` (bridge) |
258
+ | **Goose** | `.goose/` | `.goose/skills/` | `.goosehints` (en raíz del proyecto) |
242
259
  | **Junie** | `.junie/` | `.junie/skills/` | `.junie/guidelines.md` |
243
- | **iFlow CLI** | `.iflow/rules/` | `.iflow/skills/` | `.iflow/rules/00-lmagent.md` |
244
- | **Kilo Code** | `.kilocode/rules/` | `.kilocode/skills/` | `.kilocode/rules/00-lmagent.md` |
245
- | **Kiro CLI** | `.kiro/rules/` | `.kiro/skills/` | `.kiro/rules/00-lmagent.md` |
246
- | **Kode** | `.kode/rules/` | `.kode/skills/` | `.kode/rules/00-lmagent.md` |
247
- | **MCPJam** | `.mcpjam/rules/` | `.mcpjam/skills/` | `.mcpjam/rules/00-lmagent.md` |
248
- | **Mistral Vibe** | `.vibe/rules/` | `.vibe/skills/` | `.vibe/rules/00-lmagent.md` |
249
- | **Mux** | `.mux/rules/` | `.mux/skills/` | `.mux/rules/00-lmagent.md` |
250
- | **OpenCode** | `.opencode/rules/` | `.opencode/skills/` | `.opencode/rules/00-lmagent.md` |
260
+ | **iFlow CLI** | `.iflow/rules/` | `.iflow/skills/` | `.iflow/rules/00-lmagent.md` (bridge) |
261
+ | **Kilo Code** | `.kilocode/rules/` | `.kilocode/skills/` | `.kilocode/rules/00-lmagent.md` (bridge) |
262
+ | **Kiro CLI** | `.kiro/rules/` | `.kiro/skills/` | `.kiro/rules/00-lmagent.md` (bridge) |
263
+ | **Kode** | `.kode/rules/` | `.kode/skills/` | `.kode/rules/00-lmagent.md` (bridge) |
264
+ | **MCPJam** | `.mcpjam/rules/` | `.mcpjam/skills/` | `.mcpjam/rules/00-lmagent.md` (bridge) |
265
+ | **Mistral Vibe** | `.vibe/rules/` | `.vibe/skills/` | `.vibe/rules/00-lmagent.md` (bridge) |
266
+ | **Mux** | `.mux/rules/` | `.mux/skills/` | `.mux/rules/00-lmagent.md` (bridge) |
267
+ | **OpenCode** | `.opencode/rules/` | `.opencode/skills/` | `.opencode/rules/00-lmagent.md` (bridge) |
251
268
  | **OpenHands** | `.openhands/microagents/` | `.openhands/skills/` | `.openhands/microagents/repo.md` |
252
- | **Pi** | `.pi/rules/` | `.pi/skills/` | `.pi/rules/00-lmagent.md` |
253
- | **Qoder** | `.qoder/rules/` | `.qoder/skills/` | `.qoder/rules/00-lmagent.md` |
254
- | **Qwen Code** | `.qwen/rules/` | `.qwen/skills/` | `.qwen/rules/00-lmagent.md` |
255
- | **Zencoder** | `.zencoder/rules/` | `.zencoder/skills/` | `.zencoder/rules/00-lmagent.md` |
256
- | **Neovate** | `.neovate/rules/` | `.neovate/skills/` | `.neovate/rules/00-lmagent.md` |
257
- | **Pochi** | `.pochi/rules/` | `.pochi/skills/` | `.pochi/rules/00-lmagent.md` |
258
- | **AdaL** | `.adal/rules/` | `.adal/skills/` | `.adal/rules/00-lmagent.md` |
259
-
260
- > **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.
269
+ | **Pi** | `.pi/rules/` | `.pi/skills/` | `.pi/rules/00-lmagent.md` (bridge) |
270
+ | **Qoder** | `.qoder/rules/` | `.qoder/skills/` | `.qoder/rules/00-lmagent.md` (bridge) |
271
+ | **Qwen Code** | `.qwen/rules/` | `.qwen/skills/` | `.qwen/rules/00-lmagent.md` (bridge) |
272
+ | **Zencoder** | `.zencoder/rules/` | `.zencoder/skills/` | `.zencoder/rules/00-lmagent.md` (bridge) |
273
+ | **Neovate** | `.neovate/rules/` | `.neovate/skills/` | `.neovate/rules/00-lmagent.md` (bridge) |
274
+ | **Pochi** | `.pochi/rules/` | `.pochi/skills/` | `.pochi/rules/00-lmagent.md` (bridge) |
275
+ | **AdaL** | `.adal/rules/` | `.adal/skills/` | `.adal/rules/00-lmagent.md` (bridge) |
276
+
277
+ > **Tipos de Entry Point**:
278
+ > - **`(nativo)`**: El agente lee `AGENTS.md` automáticamente del raíz del proyecto sin configuración extra (Cursor, Zed, Roo Code, Codex)
279
+ > - **`configFile`** directo: El agente lee este archivo específico al iniciar (ej: `CLAUDE.md`, `GEMINI.md`). Solo se despliega si el agente está detectado.
280
+ > - **`bridge`**: Archivo intermedio en el `rulesDir` que apunta a `AGENTS.md`. Se genera durante la instalación.
281
+ >
282
+ > ⚠️ **Importante**: `CLAUDE.md` y `GEMINI.md` solo se crean cuando su agente correspondiente está detectado. Esto evita conflictos de contexto duplicado en agentes como Cursor y Zed que leen múltiples `.md` del raíz.
261
283
 
262
284
  ---
263
285
 
@@ -291,4 +313,4 @@ npx lmagent uninstall # Eliminar archivos del framework del proyecto
291
313
 
292
314
  ---
293
315
 
294
- *LMAgent V3.1.3 — 37 Agents · 31 Skills · 13 Workflows · 11 Rules · 6 Docs · 5 Memory Files*
316
+ *LMAgent V3.3.0 — 37 Agents · 31 Skills · 13 Workflows · 11 Rules · 6 Docs · 5 Memory Files*
package/CLAUDE.md CHANGED
@@ -1,19 +1,34 @@
1
- # 🤖 LMAgent Framework v3.1.3
2
-
3
- > [!IMPORTANT]
4
- > **REDIRECT NOTICE**: La configuración de este framework se ha centralizado.
5
-
6
- # 🚀 INSTRUCCIONES DE ACTIVACIÓN
7
-
8
- Tu "Cerebro" y "Manual de Operaciones" ahora viven en un único archivo maestro.
9
-
10
- **👉 [LEER AGENTS.md](./AGENTS.md) 👈**
11
-
12
- **No intentes hacer nada sin leer `AGENTS.md` primero.**
13
- Allí encontrarás:
14
- 1. Tu Identidad y Protocolo.
15
- 2. Catálogo de Skills (`/dev`, `/orch`, etc.).
16
- 3. Reglas Operativas y Niveles de Complejidad.
17
-
18
- ---
19
- *LMAgent Framework - Single Source of Truth*
1
+
2
+ # 🤖 LMAgent Framework v{{VERSION}}
3
+ > Contexto Activo: Este proyecto utiliza el estándar LMAgent V{{MAJOR}}.
4
+
5
+ ## 🚨 SOURCE OF TRUTH (CEREBRO)
6
+ **TU CONTEXTO Y REGLAS VIVEN AQUÍ 👉 [AGENTS.md](./AGENTS.md)**
7
+ *Lee este archivo INMEDIATAMENTE para obtener tu identidad, skills y reglas operativas.*
8
+
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)
11
+ 2. **Lee `.agents/rules/00-master.md`** — Reglas, protocolo de trabajo y triggers
12
+ 3. **Si existe `.agents/memory/04-active-context.md`** — Recupera contexto previo
13
+ 4. **Clasifica la tarea** (Nivel 0-4) y activa el skill apropiado
14
+
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/`
19
+ - **Memory**: `.agents/memory/`
20
+ - **Config**: `.agents/config/`
21
+
22
+ ## ⚡ QUICK START TRIGGERS (Menú Rápido)
23
+ | Trigger | Rol / Skill | Objetivo |
24
+ |:--- |:--- |:--- |
25
+ | `/orch` | **Orchestrator** | Clasificar y delegar. |
26
+ | `/dev` | **Backend** | APIs y Lógica. |
27
+ | `/front` | **Frontend** | UI/UX, React. |
28
+ | `/pm` | **Product** | PRDs y Roadmap. |
29
+ | `/fix` | **Debugger** | Análisis de bugs. |
30
+ | `/arch` | **Architect** | Diseño de sistemas. |
31
+
32
+ > **IMPORTANTE**: Para activar un skill, lee su `SKILL.md` completo en `skills/[nombre]/SKILL.md`.
33
+
34
+ !! SYSTEM NOTE: You MUST read AGENTS.md at startup to understand the full framework. !!
package/GEMINI.md ADDED
@@ -0,0 +1,34 @@
1
+
2
+ # 🤖 LMAgent Framework v{{VERSION}}
3
+ > Contexto Activo: Este proyecto utiliza el estándar LMAgent V{{MAJOR}}.
4
+
5
+ ## 🚨 SOURCE OF TRUTH (CEREBRO)
6
+ **TU CONTEXTO Y REGLAS VIVEN AQUÍ 👉 [AGENTS.md](./AGENTS.md)**
7
+ *Lee este archivo INMEDIATAMENTE para obtener tu identidad, skills y reglas operativas.*
8
+
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)
11
+ 2. **Lee `.agents/rules/00-master.md`** — Reglas, protocolo de trabajo y triggers
12
+ 3. **Si existe `.agents/memory/04-active-context.md`** — Recupera contexto previo
13
+ 4. **Clasifica la tarea** (Nivel 0-4) y activa el skill apropiado
14
+
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/`
19
+ - **Memory**: `.agents/memory/`
20
+ - **Config**: `.agents/config/`
21
+
22
+ ## ⚡ QUICK START TRIGGERS (Menú Rápido)
23
+ | Trigger | Rol / Skill | Objetivo |
24
+ |:--- |:--- |:--- |
25
+ | `/orch` | **Orchestrator** | Clasificar y delegar. |
26
+ | `/dev` | **Backend** | APIs y Lógica. |
27
+ | `/front` | **Frontend** | UI/UX, React. |
28
+ | `/pm` | **Product** | PRDs y Roadmap. |
29
+ | `/fix` | **Debugger** | Análisis de bugs. |
30
+ | `/arch` | **Architect** | Diseño de sistemas. |
31
+
32
+ > **IMPORTANTE**: Para activar un skill, lee su `SKILL.md` completo en `skills/[nombre]/SKILL.md`.
33
+
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.1.3-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.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)
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).
@@ -26,10 +26,10 @@ npx @qubiit/lmagent@latest
26
26
  That's it. No global install required. LMAgent will:
27
27
  1. **Auto-detect** which AI agents you have installed on your system
28
28
  2. **Pre-select** the detected agents for installation
29
- 3. **Deploy** skills, rules, and workflows to each agent's directory
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.
32
+ > **Requires Node.js ≥ 22**. Works on macOS, Linux, and Windows. **V3.3.0 features strict project isolation to prevent global conflicts.**
33
33
 
34
34
  ---
35
35
 
@@ -39,7 +39,7 @@ That's it. No global install required. LMAgent will:
39
39
  ```bash
40
40
  npx @qubiit/lmagent@latest init
41
41
  ```
42
- Copies `AGENTS.md`, `CLAUDE.md`, and `GEMINI.md` to your project root. These are the entry points that agents read automatically when they start.
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.
43
43
 
44
44
  ### Step 2 — Install the framework
45
45
  ```bash
@@ -76,9 +76,9 @@ Your Project/
76
76
  │ ├── config/ # Framework settings
77
77
  │ └── docs/ # Extended documentation
78
78
  │
79
- ├── AGENTS.md # ← PILLAR 1: Capability catalog (read by all agents)
80
- ├── CLAUDE.md # ← PILLAR 2: Entry point for Claude Code / Antigravity
81
- ├── GEMINI.md # ← PILLAR 3: Entry point for Gemini CLI / Antigravity
79
+ ├── AGENTS.md # ← UNIVERSAL ENTRY POINT (read by all agents)
80
+ ├── CLAUDE.md # ← Only if Claude Code is detected
81
+ ├── GEMINI.md # ← Only if Gemini CLI / Antigravity is detected
82
82
  │
83
83
  ├── .cursor/rules/ # ← Cursor-specific rules & skills
84
84
  ├── .windsurf/rules/ # ← Windsurf-specific rules & skills
@@ -92,18 +92,19 @@ Each agent reads a specific file when it starts. LMAgent generates that file aut
92
92
 
93
93
  | Agent | Entry Point Generated |
94
94
  |:---|:---|
95
- | Cursor | `.cursorrules` |
95
+ | Cursor | `AGENTS.md` (native) + `.cursor/rules/00-lmagent.mdc` |
96
96
  | Claude Code | `CLAUDE.md` |
97
97
  | Gemini CLI / Antigravity | `GEMINI.md` |
98
98
  | Windsurf | `.windsurf/rules/lmagent.md` |
99
99
  | Cline | `.clinerules/00-lmagent.md` |
100
- | Roo Code | `.roo/rules/00-lmagent.md` |
100
+ | Roo Code | `AGENTS.md` (native) + `.roo/rules/00-lmagent.md` |
101
101
  | VSCode Copilot | `.github/copilot-instructions.md` |
102
+ | Zed | `AGENTS.md` (native) + `.rules/lmagent.md` |
102
103
  | Goose | `.goosehints` |
103
- | Continue | `.continuerules` |
104
+ | Continue | `.continue/continuerules` |
104
105
  | Junie | `.junie/guidelines.md` |
105
106
  | OpenHands | `.openhands/microagents/repo.md` |
106
- | Codex CLI | `AGENTS.md` |
107
+ | Codex CLI | `AGENTS.md` (native) |
107
108
  | All others | `00-lmagent.md` in their `rulesDir` |
108
109
 
109
110
  All entry points point to `AGENTS.md` — the single source of truth.
@@ -167,7 +168,7 @@ Activate any skill by typing its trigger in the chat:
167
168
 
168
169
  | Agent | Config Path | Entry Point |
169
170
  |:---|:---|:---|
170
- | **Cursor** | `.cursor/` | `.cursorrules` |
171
+ | **Cursor** | `.cursor/` | `AGENTS.md` (native) + `.cursor/rules/00-lmagent.mdc` |
171
172
  | **Windsurf** | `.windsurf/` | `.windsurf/rules/lmagent.md` |
172
173
  | **Cline** | `.clinerules/` | `.clinerules/00-lmagent.md` |
173
174
  | **Roo Code** | `.roo/` | `.roo/rules/00-lmagent.md` |
@@ -175,8 +176,8 @@ Activate any skill by typing its trigger in the chat:
175
176
  | **Trae** | `.trae/` | `.trae/rules/lmagent.md` |
176
177
  | **Trae CN** | `.trae-cn/` | `.trae-cn/rules/lmagent.md` |
177
178
  | **Claude Code** | `.claude/` | `CLAUDE.md` |
178
- | **Zed** | `.rules/` | `.rules/lmagent.md` |
179
- | **Amp / Kimi / Replit** | `.agents/` | `.agents/rules/00-lmagent.md` |
179
+ | **Zed** | `.rules/` | `AGENTS.md` (native) + `.rules/lmagent.md` |
180
+ | **Amp / Kimi / Replit** | `.agents/` | `AGENTS.md` (native) |
180
181
  | **Antigravity** | `.agent/` | `GEMINI.md` |
181
182
  | **Augment** | `.augment/` | `.augment/rules/00-lmagent.md` |
182
183
  | **Gemini CLI** | `.gemini/` | `GEMINI.md` |
@@ -184,7 +185,7 @@ Activate any skill by typing its trigger in the chat:
184
185
  | **CodeBuddy** | `.codebuddy/` | `.codebuddy/rules/00-lmagent.md` |
185
186
  | **Codex CLI** | `.codex/` | `AGENTS.md` |
186
187
  | **Command Code** | `.commandcode/` | `.commandcode/rules/00-lmagent.md` |
187
- | **Continue** | `.continue/` | `.continuerules` |
188
+ | **Continue** | `.continue/` | `.continue/continuerules` |
188
189
  | **Crush** | `.crush/` | `.crush/rules/00-lmagent.md` |
189
190
  | **Droid** | `.factory/` | `.factory/rules/00-lmagent.md` |
190
191
  | **Goose** | `.goose/` | `.goosehints` |
@@ -213,7 +214,7 @@ Activate any skill by typing its trigger in the chat:
213
214
  ```bash
214
215
  # Core
215
216
  npx @qubiit/lmagent@latest # Interactive install (auto-detects agents)
216
- npx @qubiit/lmagent@latest init # Initialize project (copies AGENTS.md, CLAUDE.md, GEMINI.md)
217
+ npx @qubiit/lmagent@latest init # Initialize project (copies AGENTS.md)
217
218
  npx @qubiit/lmagent@latest install # Install/update framework in current project
218
219
  npx @qubiit/lmagent@latest update # Alias for install
219
220
  npx @qubiit/lmagent@latest uninstall # Remove all LMAgent files from project