@qubiit/lmagent 3.1.8 → 3.3.0

package/.agents/rules/00-master.md

@@ -1,6 +1,6 @@
 # 🚀 LMAgent Bootstrap — Instrucciones Iniciales
 
-> **Tipo**: `rule` | **Versión**: 3.1.8 | **Prioridad**: MÁXIMA
+> **Tipo**: `rule` | **Versión**: 3.3.0 | **Prioridad**: MÁXIMA
 > Esta regla se aplica **SIEMPRE** como primer paso antes de cualquier tarea.
 
 ---
@@ -15,7 +15,7 @@
 
 ## 🧠 Framework
 
-Este archivo define la identidad, propósito y reglas fundamentales de **LMAgent v3.1.6**. Antes de implementar cualquier cambio:
+Este archivo define la identidad, propósito y reglas fundamentales de **LMAgent v3.3.0**. 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 `.agents/rules/01-workflow.md`)
@@ -42,10 +42,11 @@ Este archivo define la identidad, propósito y reglas fundamentales de **LMAgent
 
 ---
 
-## 🎯 Skills Disponibles (31)
+## 🎯 Skills Disponibles
 
 Activa el skill apropiado según la tarea. Cada skill tiene `SKILL.md` con instrucciones detalladas, y opcionalmente `scripts/`, `references/` y `assets/`.
 
+<!-- SKILLS_CATALOG_START -->
 ### Meta-Skill
 | Skill | Triggers | Descripción |
 |-------|----------|-------------|
@@ -104,6 +105,7 @@ Activa el skill apropiado según la tarea. Cada skill tiene `SKILL.md` con instr
 | **bmad-methodology** | `/bmad` | Scale-Adaptive Intelligence, niveles 0-4 |
 | **swe-agent** | `/swe`, `/issue-solve`, `/trajectory` | Resolución autónoma de issues |
 | **spec-driven-dev** | `/spec-dev`, `/sdd-skill`, `/spec-method` | Pipeline: Specify→Plan→Tasks→Implement→Verify |
+<!-- SKILLS_CATALOG_END -->
 
 ---
 

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

@@ -5,8 +5,21 @@
 **TU CONTEXTO Y REGLAS VIVEN AQUÍ 👉 [AGENTS.md](./AGENTS.md)**
 *Lee este archivo INMEDIATAMENTE para obtener tu identidad, skills y reglas operativas.*
 
-## ⚡ QUICK START TRIGGERS (Menu Rápido)
-Use estos comandos para activar su rol. Para detalles, consulte `AGENTS.md`.
+## 🔄 ARRANQUE AUTOMÁTICO (Haz esto al iniciar cada sesión)
+1. **Lee [AGENTS.md](./AGENTS.md)** — Tu catálogo completo de capacidades (31 skills, 11 rules, 13 workflows)
+2. **Lee `.agents/rules/00-master.md`** — Reglas, protocolo de trabajo y tabla de skills con triggers
+3. **Si existe `.agents/memory/04-active-context.md`** — Léelo para recuperar contexto de la sesión anterior
+4. **Clasifica la tarea** (Nivel 0-4 según complejidad) y activa el skill apropiado
+
+## 📁 RUTAS DE ENTORNO
+- **Skills**: `{{SKILLS_DIR}}` → Cada skill tiene `SKILL.md` con instrucciones completas
+- **Rules**: `{{RULES_DIR}}` → Guardrails de comportamiento (CÓMO trabajar)
+- **Workflows**: `{{WORKFLOWS_DIR}}` → SOPs y procedimientos (flujos paso a paso)
+- **Memory**: `.agents/memory/` → Contexto persistente entre sesiones
+- **Config**: `.agents/config/` → Configuración del framework (tools, models, levels)
+
+## ⚡ QUICK START TRIGGERS (Menú Rápido)
+Usa estos comandos para activar un rol. Para el catálogo completo de 31 skills, consulta `AGENTS.md`.
 
 | Trigger | Rol / Skill | Objetivo |
 |:--- |:--- |:--- |
@@ -17,4 +30,6 @@ Use estos comandos para activar su rol. Para detalles, consulte `AGENTS.md`.
 | `/fix` | **Debugger** | Análisis de bugs. |
 | `/arch` | **Architect** | Diseño de sistemas. |
 
-!! SYSTEM NOTE: Read AGENTS.md to understand how to execute these roles. !!
+> **IMPORTANTE**: Para activar un skill, lee su `SKILL.md` completo en `{{SKILLS_DIR}}/[nombre]/SKILL.md`.
+
+!! SYSTEM NOTE: You MUST read AGENTS.md at startup to understand the full framework capabilities. !!

package/AGENTS.md

@@ -1,6 +1,6 @@
 # 🤖 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.3 (Total Awareness Standard)**
+> Framework: **LMAgent v3.3.0 (Total Awareness Standard)**
 
 ---
 
@@ -147,12 +147,14 @@ Clasifica tu tarea actual para decidir tu nivel de autonomía:
 
 ---
 
-## 🏗️ 5. Skills Catalog (31 Skills Disponibles)
+## 🏗️ 5. Skills Catalog
 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.
+> **Nota**: Esta sección se actualiza automáticamente con `lmagent install` al detectar skills nuevos.
 
+<!-- SKILLS_CATALOG_START -->
 ### 🎯 Management & Architecture
 | Trigger | Skill | Directorio |
 |:---|:---|:---|
@@ -199,6 +201,7 @@ Ubicación Universal: `.agents/skills/[nombre_skill]/SKILL.md`
 | `/sdd` | **spec-driven-dev** | `.agents/skills/spec-driven-dev/` |
 | `/swe` | **swe-agent** | `.agents/skills/swe-agent/` |
 | `/test-s` | **testing-strategist** | `.agents/skills/testing-strategist/` |
+<!-- SKILLS_CATALOG_END -->
 
 ---
 
@@ -216,48 +219,67 @@ Ubicación Universal: `.agents/skills/[nombre_skill]/SKILL.md`
 ## 🌐 7. Mapa de Agentes Soportados (37 Agentes)
 La lista completa de dónde busca instrucciones CADA agente soportado por LMAgent.
 
+### 🔄 Auto-Invocación
+
+Cuando un agente abre un proyecto con LMAgent instalado, el flujo es:
+
+1. **El agente lee su `configFile`** (ej: `CLAUDE.md`, `GEMINI.md`) o su **`bridgeFile`** en `rulesDir`
+2. **Ese archivo le dice que lea `AGENTS.md`** → El catálogo completo de capacidades
+3. **`AGENTS.md` lo dirige a `00-master.md`** → Las reglas operativas y tabla de skills
+4. **El agente carga el `SKILL.md` apropiado** según la tarea del usuario
+5. **Si existe `04-active-context.md`** → Recupera contexto de la sesión anterior
+
+> **Resultado**: El agente conoce TODO el framework automáticamente, sin que el usuario tenga que invocarlo manualmente.
+
+### 📊 Tabla de Configuración por Agente
+
 | Agente | Rules Directory | Skills Directory | Entry Point (configFile) |
 | :--- | :--- | :--- | :--- |
-| **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` |
+| **Cursor** | `.cursor/rules/` | `.cursor/rules/skills/` | `AGENTS.md` (nativo) + bridge `.cursor/rules/00-lmagent.mdc` |
+| **Windsurf** | `.windsurf/rules/` | `.windsurf/skills/` | `.windsurf/rules/lmagent.md` (bridge) |
+| **Cline** | `.clinerules/` | `.cline/skills/` | `.clinerules/00-lmagent.md` (bridge) |
+| **Roo Code** | `.roo/rules/` | `.roo/skills/` | `AGENTS.md` (nativo) + bridge `.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` |
+| **Trae** | `.trae/rules/` | `.trae/skills/` | `.trae/rules/lmagent.md` (bridge) |
+| **Trae CN** | `.trae-cn/rules/` | `.trae-cn/skills/` | `.trae-cn/rules/lmagent.md` (bridge) |
 | **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` |
+| **Zed** | `.rules/` | `.rules/skills/` | `AGENTS.md` (nativo) + bridge `.rules/lmagent.md` |
+| **Amp / Kimi / Replit** | `.agents/rules/` | `.agents/skills/` | `AGENTS.md` (nativo) |
 | **Antigravity** | `.agent/rules/` | `.agent/skills/` | `GEMINI.md` |
-| **Augment** | `.augment/rules/` | `.augment/skills/` | `.augment/rules/00-lmagent.md` |
+| **Augment** | `.augment/rules/` | `.augment/skills/` | `.augment/rules/00-lmagent.md` (bridge) |
 | **Gemini CLI** | `.gemini/rules/` | `.gemini/skills/` | `GEMINI.md` |
 | **OpenClaw / Envoid** | `rules/` | `skills/` | `openclaw.json` |
-| **CodeBuddy** | `.codebuddy/rules/` | `.codebuddy/skills/` | `.codebuddy/rules/00-lmagent.md` |
+| **CodeBuddy** | `.codebuddy/rules/` | `.codebuddy/skills/` | `.codebuddy/rules/00-lmagent.md` (bridge) |
 | **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` |
+| **Command Code** | `.commandcode/rules/` | `.commandcode/skills/` | `.commandcode/rules/00-lmagent.md` (bridge) |
+| **Continue** | `.continue/rules/` | `.continue/skills/` | `.continue/continuerules` |
+| **Crush** | `.crush/rules/` | `.crush/skills/` | `.crush/rules/00-lmagent.md` (bridge) |
+| **Droid** | `.factory/rules/` | `.factory/skills/` | `.factory/rules/00-lmagent.md` (bridge) |
+| **Goose** | `.goose/` | `.goose/skills/` | `.goosehints` (en raíz del proyecto) |
 | **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` |
+| **iFlow CLI** | `.iflow/rules/` | `.iflow/skills/` | `.iflow/rules/00-lmagent.md` (bridge) |
+| **Kilo Code** | `.kilocode/rules/` | `.kilocode/skills/` | `.kilocode/rules/00-lmagent.md` (bridge) |
+| **Kiro CLI** | `.kiro/rules/` | `.kiro/skills/` | `.kiro/rules/00-lmagent.md` (bridge) |
+| **Kode** | `.kode/rules/` | `.kode/skills/` | `.kode/rules/00-lmagent.md` (bridge) |
+| **MCPJam** | `.mcpjam/rules/` | `.mcpjam/skills/` | `.mcpjam/rules/00-lmagent.md` (bridge) |
+| **Mistral Vibe** | `.vibe/rules/` | `.vibe/skills/` | `.vibe/rules/00-lmagent.md` (bridge) |
+| **Mux** | `.mux/rules/` | `.mux/skills/` | `.mux/rules/00-lmagent.md` (bridge) |
+| **OpenCode** | `.opencode/rules/` | `.opencode/skills/` | `.opencode/rules/00-lmagent.md` (bridge) |
 | **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.
+| **Pi** | `.pi/rules/` | `.pi/skills/` | `.pi/rules/00-lmagent.md` (bridge) |
+| **Qoder** | `.qoder/rules/` | `.qoder/skills/` | `.qoder/rules/00-lmagent.md` (bridge) |
+| **Qwen Code** | `.qwen/rules/` | `.qwen/skills/` | `.qwen/rules/00-lmagent.md` (bridge) |
+| **Zencoder** | `.zencoder/rules/` | `.zencoder/skills/` | `.zencoder/rules/00-lmagent.md` (bridge) |
+| **Neovate** | `.neovate/rules/` | `.neovate/skills/` | `.neovate/rules/00-lmagent.md` (bridge) |
+| **Pochi** | `.pochi/rules/` | `.pochi/skills/` | `.pochi/rules/00-lmagent.md` (bridge) |
+| **AdaL** | `.adal/rules/` | `.adal/skills/` | `.adal/rules/00-lmagent.md` (bridge) |
+
+> **Tipos de Entry Point**:
+> - **`(nativo)`**: El agente lee `AGENTS.md` automáticamente del raíz del proyecto sin configuración extra (Cursor, Zed, Roo Code, Codex)
+> - **`configFile`** directo: El agente lee este archivo específico al iniciar (ej: `CLAUDE.md`, `GEMINI.md`). Solo se despliega si el agente está detectado.
+> - **`bridge`**: Archivo intermedio en el `rulesDir` que apunta a `AGENTS.md`. Se genera durante la instalación.
+>
+> ⚠️ **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.
 
 ---
 
@@ -291,4 +313,4 @@ 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*
+*LMAgent V3.3.0 — 37 Agents · 31 Skills · 13 Workflows · 11 Rules · 6 Docs · 5 Memory Files*

package/CLAUDE.md

@@ -1,19 +1,34 @@
-# 🤖 LMAgent Framework v3.1.3
-
-> [!IMPORTANT]
-> **REDIRECT NOTICE**: La configuración de este framework se ha centralizado.
-
-# 🚀 INSTRUCCIONES DE ACTIVACIÓN
-
-Tu "Cerebro" y "Manual de Operaciones" ahora viven en un único archivo maestro.
-
-**👉 [LEER AGENTS.md](./AGENTS.md) 👈**
-
-**No intentes hacer nada sin leer `AGENTS.md` primero.**
-Allí encontrarás:
-1.  Tu Identidad y Protocolo.
-2.  Catálogo de Skills (`/dev`, `/orch`, etc.).
-3.  Reglas Operativas y Niveles de Complejidad.
-
----
-*LMAgent Framework - Single Source of Truth*
+
+# 🤖 LMAgent Framework v{{VERSION}}
+> Contexto Activo: Este proyecto utiliza el estándar LMAgent V{{MAJOR}}.
+
+## 🚨 SOURCE OF TRUTH (CEREBRO)
+**TU CONTEXTO Y REGLAS VIVEN AQUÍ 👉 [AGENTS.md](./AGENTS.md)**
+*Lee este archivo INMEDIATAMENTE para obtener tu identidad, skills y reglas operativas.*
+
+## 🔄 ARRANQUE AUTOMÁTICO (Haz esto al iniciar cada sesión)
+1. **Lee [AGENTS.md](./AGENTS.md)** — Tu catálogo completo (31 skills, 11 rules, 13 workflows)
+2. **Lee `.agents/rules/00-master.md`** — Reglas, protocolo de trabajo y triggers
+3. **Si existe `.agents/memory/04-active-context.md`** — Recupera contexto previo
+4. **Clasifica la tarea** (Nivel 0-4) y activa el skill apropiado
+
+## 📁 RUTAS DE ENTORNO
+- **Skills**: `.claude/skills/` o `.agents/skills/`
+- **Rules**: `.claude/rules/` o `.agents/rules/`
+- **Workflows**: `.claude/workflows/` o `.agents/workflows/`
+- **Memory**: `.agents/memory/`
+- **Config**: `.agents/config/`
+
+## ⚡ QUICK START TRIGGERS (Menú Rápido)
+| Trigger | Rol / Skill | Objetivo |
+|:--- |:--- |:--- |
+| `/orch` | **Orchestrator** | Clasificar y delegar. |
+| `/dev` | **Backend** | APIs y Lógica. |
+| `/front` | **Frontend** | UI/UX, React. |
+| `/pm` | **Product** | PRDs y Roadmap. |
+| `/fix` | **Debugger** | Análisis de bugs. |
+| `/arch` | **Architect** | Diseño de sistemas. |
+
+> **IMPORTANTE**: Para activar un skill, lee su `SKILL.md` completo en `skills/[nombre]/SKILL.md`.
+
+!! SYSTEM NOTE: You MUST read AGENTS.md at startup to understand the full framework. !!

package/GEMINI.md

@@ -0,0 +1,34 @@
+
+# 🤖 LMAgent Framework v{{VERSION}}
+> Contexto Activo: Este proyecto utiliza el estándar LMAgent V{{MAJOR}}.
+
+## 🚨 SOURCE OF TRUTH (CEREBRO)
+**TU CONTEXTO Y REGLAS VIVEN AQUÍ 👉 [AGENTS.md](./AGENTS.md)**
+*Lee este archivo INMEDIATAMENTE para obtener tu identidad, skills y reglas operativas.*
+
+## 🔄 ARRANQUE AUTOMÁTICO (Haz esto al iniciar cada sesión)
+1. **Lee [AGENTS.md](./AGENTS.md)** — Tu catálogo completo (31 skills, 11 rules, 13 workflows)
+2. **Lee `.agents/rules/00-master.md`** — Reglas, protocolo de trabajo y triggers
+3. **Si existe `.agents/memory/04-active-context.md`** — Recupera contexto previo
+4. **Clasifica la tarea** (Nivel 0-4) y activa el skill apropiado
+
+## 📁 RUTAS DE ENTORNO
+- **Skills**: `.gemini/skills/` o `.agents/skills/`
+- **Rules**: `.gemini/rules/` o `.agents/rules/`
+- **Workflows**: `.gemini/workflows/` o `.agents/workflows/`
+- **Memory**: `.agents/memory/`
+- **Config**: `.agents/config/`
+
+## ⚡ QUICK START TRIGGERS (Menú Rápido)
+| Trigger | Rol / Skill | Objetivo |
+|:--- |:--- |:--- |
+| `/orch` | **Orchestrator** | Clasificar y delegar. |
+| `/dev` | **Backend** | APIs y Lógica. |
+| `/front` | **Frontend** | UI/UX, React. |
+| `/pm` | **Product** | PRDs y Roadmap. |
+| `/fix` | **Debugger** | Análisis de bugs. |
+| `/arch` | **Architect** | Diseño de sistemas. |
+
+> **IMPORTANTE**: Para activar un skill, lee su `SKILL.md` completo en `skills/[nombre]/SKILL.md`.
+
+!! SYSTEM NOTE: You MUST read AGENTS.md at startup to understand the full framework. !!

package/README.md

@@ -10,7 +10,7 @@
                                                   by QuBit
 ```
 
-![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)
+![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)
 
 > **"Separate the reasoning from the execution."**
 > 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
 That's it. No global install required. LMAgent will:
 1. **Auto-detect** which AI agents you have installed on your system
 2. **Pre-select** the detected agents for installation
-3. **Deploy** skills, rules, and workflows to each agent's directory
+3. **Deploy** skills, rules, and workflows **strictly to your project directory** (Universal Brain: `.agents/`)
 4. **Generate** the entry point file so each agent auto-invokes the framework
 
-> **Requires Node.js ≥ 22**. Works on macOS, Linux, and Windows.
+> **Requires Node.js ≥ 22**. Works on macOS, Linux, and Windows. **V3.3.0 features strict project isolation to prevent global conflicts.**
 
 ---
 
@@ -39,7 +39,7 @@ That's it. No global install required. LMAgent will:
 ```bash
 npx @qubiit/lmagent@latest init
 ```
-Copies `AGENTS.md`, `CLAUDE.md`, and `GEMINI.md` to your project root. These are the entry points that agents read automatically when they start.
+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.
 
 ### Step 2 — Install the framework
 ```bash
@@ -76,9 +76,9 @@ Your Project/
 │   ├── config/                 # Framework settings
 │   └── docs/                   # Extended documentation
 │
-├── AGENTS.md                   # ← PILLAR 1: Capability catalog (read by all agents)
-├── CLAUDE.md                   # ← PILLAR 2: Entry point for Claude Code / Antigravity
-├── GEMINI.md                   # ← PILLAR 3: Entry point for Gemini CLI / Antigravity
+├── AGENTS.md                   # ← UNIVERSAL ENTRY POINT (read by all agents)
+├── CLAUDE.md                   # ← Only if Claude Code is detected
+├── GEMINI.md                   # ← Only if Gemini CLI / Antigravity is detected
 │
 ├── .cursor/rules/              # ← Cursor-specific rules & skills
 ├── .windsurf/rules/            # ← Windsurf-specific rules & skills
@@ -92,18 +92,19 @@ Each agent reads a specific file when it starts. LMAgent generates that file aut
 
 | Agent | Entry Point Generated |
 |:---|:---|
-| Cursor | `.cursorrules` |
+| Cursor | `AGENTS.md` (native) + `.cursor/rules/00-lmagent.mdc` |
 | Claude Code | `CLAUDE.md` |
 | Gemini CLI / Antigravity | `GEMINI.md` |
 | Windsurf | `.windsurf/rules/lmagent.md` |
 | Cline | `.clinerules/00-lmagent.md` |
-| Roo Code | `.roo/rules/00-lmagent.md` |
+| Roo Code | `AGENTS.md` (native) + `.roo/rules/00-lmagent.md` |
 | VSCode Copilot | `.github/copilot-instructions.md` |
+| Zed | `AGENTS.md` (native) + `.rules/lmagent.md` |
 | Goose | `.goosehints` |
-| Continue | `.continuerules` |
+| Continue | `.continue/continuerules` |
 | Junie | `.junie/guidelines.md` |
 | OpenHands | `.openhands/microagents/repo.md` |
-| Codex CLI | `AGENTS.md` |
+| Codex CLI | `AGENTS.md` (native) |
 | All others | `00-lmagent.md` in their `rulesDir` |
 
 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:
 
 | Agent | Config Path | Entry Point |
 |:---|:---|:---|
-| **Cursor** | `.cursor/` | `.cursorrules` |
+| **Cursor** | `.cursor/` | `AGENTS.md` (native) + `.cursor/rules/00-lmagent.mdc` |
 | **Windsurf** | `.windsurf/` | `.windsurf/rules/lmagent.md` |
 | **Cline** | `.clinerules/` | `.clinerules/00-lmagent.md` |
 | **Roo Code** | `.roo/` | `.roo/rules/00-lmagent.md` |
@@ -175,8 +176,8 @@ Activate any skill by typing its trigger in the chat:
 | **Trae** | `.trae/` | `.trae/rules/lmagent.md` |
 | **Trae CN** | `.trae-cn/` | `.trae-cn/rules/lmagent.md` |
 | **Claude Code** | `.claude/` | `CLAUDE.md` |
-| **Zed** | `.rules/` | `.rules/lmagent.md` |
-| **Amp / Kimi / Replit** | `.agents/` | `.agents/rules/00-lmagent.md` |
+| **Zed** | `.rules/` | `AGENTS.md` (native) + `.rules/lmagent.md` |
+| **Amp / Kimi / Replit** | `.agents/` | `AGENTS.md` (native) |
 | **Antigravity** | `.agent/` | `GEMINI.md` |
 | **Augment** | `.augment/` | `.augment/rules/00-lmagent.md` |
 | **Gemini CLI** | `.gemini/` | `GEMINI.md` |
@@ -184,7 +185,7 @@ Activate any skill by typing its trigger in the chat:
 | **CodeBuddy** | `.codebuddy/` | `.codebuddy/rules/00-lmagent.md` |
 | **Codex CLI** | `.codex/` | `AGENTS.md` |
 | **Command Code** | `.commandcode/` | `.commandcode/rules/00-lmagent.md` |
-| **Continue** | `.continue/` | `.continuerules` |
+| **Continue** | `.continue/` | `.continue/continuerules` |
 | **Crush** | `.crush/` | `.crush/rules/00-lmagent.md` |
 | **Droid** | `.factory/` | `.factory/rules/00-lmagent.md` |
 | **Goose** | `.goose/` | `.goosehints` |
@@ -213,7 +214,7 @@ Activate any skill by typing its trigger in the chat:
 ```bash
 # Core
 npx @qubiit/lmagent@latest              # Interactive install (auto-detects agents)
-npx @qubiit/lmagent@latest init         # Initialize project (copies AGENTS.md, CLAUDE.md, GEMINI.md)
+npx @qubiit/lmagent@latest init         # Initialize project (copies AGENTS.md)
 npx @qubiit/lmagent@latest install      # Install/update framework in current project
 npx @qubiit/lmagent@latest update       # Alias for install
 npx @qubiit/lmagent@latest uninstall    # Remove all LMAgent files from project