@qubiit/lmagent 2.7.1 → 3.0.0

package/CLAUDE.md

@@ -1,159 +1,19 @@
-# LMAgent Framework v2.7.0 - Claude Code Instructions
+# 🤖 LMAgent Framework v3.0.0
 
 > [!IMPORTANT]
-> **ANTES DE HACER CUALQUIER COSA**: Este proyecto usa el framework **LMAgent v2.7.0**.
-> **DEBES** leer `AGENTS.md` y `rules/_bootstrap.md` antes de implementar cualquier cambio.
+> **REDIRECT NOTICE**: La configuración de este framework se ha centralizado.
 
-## Framework
+# 🚀 INSTRUCCIONES DE ACTIVACIÓN
 
-Estás trabajando con **LMAgent v2.7.0**, un framework para desarrollo de automatizaciones y agentes de IA. Organiza las capacidades del agente en tres pilares: **Skills**, **Rules** y **Workflows**.
+Tu "Cerebro" y "Manual de Operaciones" ahora viven en un único archivo maestro.
 
-## ⚡ Inicio Rápido
+**� [LEER AGENTS.md](./AGENTS.md) 👈**
 
-1. Lee `rules/_bootstrap.md` — **Entry point del framework** (startup check, 31 skills con triggers, reglas críticas)
-2. Lee `AGENTS.md` — Catálogo completo de skills, rules y workflows
-3. Lee las rules aplicables en `rules/`
+**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.
 
-## 🧠 CRITICAL: Agent Capabilities & Skill Loading
-
-**You have access to a rich set of capabilities (Skills) installed in this project.**
-However, they may be in hidden directories depending on your environment.
-
-### 1. 🔍 Locate Skills
-Check these paths (in order) to find installed skills:
-
-1. `.agent/skills/` (Antigravity standard)
-2. `.cursor/skills/` (Cursor)
-3. `.windsurf/skills/` (Windsurf)
-4. `.github/skills/` (VSCode/Copilot)
-5. `.claude/skills/` (Claude Code)
-6. `.clinerules/skills/` or `.roo/skills/` (Cline / Roo Code)
-7. `.continue/skills/` (Continue)
-8. `.trae/skills/` (Trae)
-9. `.agents/skills/` (Amp, Kimi, Replit)
-10. `.augment/skills/` (Augment)
-11. `.codex/skills/` (Codex)
-12. `.gemini/skills/` (Gemini CLI)
-13. `.opencode/skills/` (OpenCode)
-14. `skills/` (Source repo / custom setup)
-*(And many others: .openhands, .goose, .vibe, .codebuddy, etc. - See AGENTS.md for full list)*
-
-### 2. ⚡ Activate Skills
-**IF** the user request matches a trigger in `AGENTS.md` or implies a specific role:
-1. **FIND** the corresponding `SKILL.md` in one of the paths above.
-2. **READ** the `SKILL.md` file using `view_file` **IMMEDIATELY**.
-3. **ADOPT** the persona and instructions defined in that skill.
-
-> **Example:** User says "Fix this bug".
-> 1. You see `/fix` trigger for `systematic-debugger`.
-> 2. You look for `.agent/skills/systematic-debugger/SKILL.md`.
-> 3. You read it and follow the debugging protocol.
-
-## 🚀 STARTUP CHECK (Auto-Start)
-
-> **¿Existe `PROJECT_KICKOFF.md`?**
-> Si SÍ → Activa el skill **product-manager** (`/pm`) y ejecuta el workflow **SPEC DRIVEN**.
-
-## ⚠️ REGLA CRÍTICA: Documentación Continua
-
-> **SIEMPRE** actualiza la documentación al hacer cambios significativos.
-> Ver: `rules/documentation.md` para detalles completos.
-
-**Al terminar cada tarea:**
-- ¿Creé algo nuevo? → Documentar
-- ¿Cambié un patrón? → Actualizar reglas
-- ¿Resolví un problema complejo? → Agregar notas
-
-## 📂 Documentos Clave
-
-| Documento | Propósito |
-|-----------|----------|
-| `rules/_bootstrap.md` | ⭐ Entry point: startup, skills, reglas críticas |
-| `AGENTS.md` | Catálogo completo de capacidades |
-| `config/settings.yaml` | Configuración del framework |
-| `rules/` | Guardrails de comportamiento (ver abajo) |
-| `skills/` | 31 skills con `SKILL.md` + `scripts/` + `references/` + `assets/` |
-| `workflows/` | 13 procedimientos operativos |
-| `templates/` | Templates de proyecto reutilizables |
-
-## 📜 Rules (Guardrails)
-
-Cada rule define **CÓMO** debe comportarse el agente. Son restricciones y estándares que aplican siempre:
-
-| Rule | Propósito |
-|------|----------|
-| **_bootstrap.md** | ⭐ Entry point: startup, skills, reglas críticas |
-| **agents-ia.md** | Directrices para construir agentes IA (Tool-first, Stateless, Observable) |
-| **api-design.md** | Estándares REST/GraphQL, error handling, versionado |
-| **automations-n8n.md** | Best practices para workflows n8n robustos |
-| **code-style.md** | Linter, naming conventions, estructura de proyecto |
-| **documentation.md** | ⚠️ Documentación continua, READMEs, ADRs |
-| **security.md** | Validación de inputs, gestión de secretos, OWASP Top 10 |
-| **stack.md** | Stack tecnológico aprobado y librerías autorizadas |
-| **testing.md** | TDD obligatorio, requisitos de cobertura |
-| **workflow.md** | Git flow, niveles de complejidad, flujo de trabajo |
-
-## 🎯 Sistema de Niveles
-
-| Nivel | Nombre | Tiempo | Acción |
-|-------|--------|--------|--------|
-| 0 | Trivial | < 5 min | Implementar directamente |
-| 1 | Small | 5-30 min | Planear brevemente |
-| 2 | Medium | 30m-2h | Plan + confirmación |
-| 3 | Complex | 2-8h | Plan extenso + artefactos |
-| 4 | Enterprise | 8h+ | Múltiples aprobaciones |
-
-## 🛠️ Stack Principal
-
-### Backend
-- **Python**: FastAPI, SQLModel, Pydantic, Uvicorn
-- **Node.js**: NestJS, Express, Prisma, TypeScript
-
-### Frontend & Mobile
-- **Web**: React, Next.js
-- **Mobile**: React Native, Expo
-
-### AI & Agents
-- **Frameworks**: LangGraph, LangChain
-- **LLM Providers**: OpenAI (GPT-4o), Anthropic (Claude), Google (Gemini)
-- **Tools**: MCP Servers, Tool-use patterns
-
-### Data & Infrastructure
-- **Base de datos**: PostgreSQL, Redis
-- **Automatización**: n8n
-- **Infraestructura**: Docker, Docker Compose, Dokploy
-- **CI/CD**: GitHub Actions
-
-## 🔄 Flujo de Trabajo
-
-1. **Entender** - Leer AGENTS.md y reglas aplicables
-2. **Clasificar** - Determinar nivel de complejidad (0-4)
-3. **Planear** - Crear plan (Level 2+)
-4. **Activar Skill** - Cargar el skill apropiado según la tarea
-5. **Implementar** - Seguir patrones establecidos
-6. **Validar** - Tests y verificaciones
-7. **Documentar** - ⚠️ **ACTUALIZAR DOCS SI HAY CAMBIOS**
-
-## ✨ Reglas de Oro
-
-1. 📖 Siempre leer AGENTS.md primero
-2. 🧠 Activar el skill apropiado para la tarea
-3. 🎯 Clasificar correctamente el nivel (0-4)
-4. 📝 Planear antes de implementar (Level 2+)
-5. ✅ Tests para todo código nuevo
-6. 📐 Seguir patrones existentes
-7. 🔄 Commits pequeños y descriptivos
-8. 📚 **Documentar cambios significativos** ← Crítico
-9. 🔒 Nunca hardcodear secretos — variables de entorno
-10. ❓ Si hay duda, preguntar
-
-## CLI del Framework
-
-```bash
-lmagent init      # Inicializar proyecto (copia CLAUDE.md, AGENTS.md, config)
-lmagent install   # Instalar skills, rules y workflows en el IDE
-lmagent doctor    # Verificar configuración
-lmagent version   # Mostrar versión
-```
-
-> **Nota**: Si ejecutas sin instalar: `npx @qubiit/lmagent init`
+---
+*LMAgent Framework - Single Source of Truth*

package/CONTRIBUTING.md

@@ -35,7 +35,7 @@ Este proyecto se rige por un Código de Conducta estándar. Al participar, se es
 - [ ] ¿Actualizaste la documentación?
 - [ ] ¿Agregaste tests para tu código?
 - [ ] ¿Pasaste el linter (`ruff check .`)?
-- [ ] ¿Cumple con las reglas en `rules/`?
+- [ ] ¿Cumple con las reglas en `.agents/rules/`?
 
 ## Estilo de Código
 
@@ -47,12 +47,12 @@ Respetamos estrictamente:
 ## Estructura del Proyecto
 
 - `install.js`: CLI principal (Node.js) — comandos `init`, `install`, `update`, `doctor`.
-- `skills/`: Definiciones de skills/roles (`SKILL.md` + `scripts/`, `references/`, `assets/`).
-- `workflows/`: Definiciones de flujos operativos (.md).
-- `rules/`: Reglas de comportamiento del agente (.md).
-- `config/`: Archivos YAML de configuración.
-- `templates/`: Plantillas de proyecto reutilizables.
-- `docs/`: Documentación extendida.
+- `.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.
 
 ## Desarrollo Local
 
@@ -79,12 +79,12 @@ Si estás creando o modificando scripts Python dentro de `skills/`:
 
 ```bash
 # Instalar dependencias de skills (opcional, recomendado usar venv)
-pip install -r skills/{skill-name}/requirements.txt
+pip install -r .agents/skills/{skill-name}/requirements.txt
 ```
 
 ### Linting & Formatting
 
 - **JavaScript**: Eslint/Prettier (vía `npm test` si configurado)
-- **Python**: `ruff check .` (para scripts en `skills/`)
+- **Python**: `ruff check .` (para scripts en `.agents/skills/`)
 
 ¡Gracias por ayudar a hacer LMAgent mejor!

package/README.md

@@ -10,7 +10,7 @@
                                                   by QuBit
 ```
 
-![Version](https://img.shields.io/badge/version-2.7.1-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)
+![Version](https://img.shields.io/badge/version-3.0.0-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).
@@ -108,7 +108,7 @@ LMAgent includes a powerful CLI to manage your AI context.
 | Command | Usage | Description |
 | :--- | :--- | :--- |
 | **`init`** | `npx lmagent init` | Initializes the project. Copies `AGENTS.md` (catalog) and `CLAUDE.md` to your root. |
-| **`install`** | `npx lmagent install` | **Core Command**. Installs selected Skills, Rules & Workflows into your IDE configuration (Cursor, VSCode, Windsurf, etc.). |
+| **`install`** | `npx lmagent install` | **Core Command**. This command will deploy the **Universal Intelligence** (`.agents/`) folder and the core pillars (`AGENTS.md`, `CLAUDE.md`) to your project root. |
 | **`update`** | `npx lmagent update` | Alias for `install`. Use this to refresh your skills when new versions are released. |
 | **`doctor`** | `npx lmagent doctor` | Verifies your environment, checking for correct file structures using `validate_skills` logic. |
 | **`validate`** | `npx lmagent validate` | Scans all `SKILL.md` files for syntax errors or missing required fields. |
@@ -116,6 +116,33 @@ LMAgent includes a powerful CLI to manage your AI context.
 
 ---
 
+## 📂 Universal Project Structure
+
+When you install **LMAgent** in your project, it creates a pristine environment:
+
+```text
+/
+├── .agents/                    # [UNIVERSAL BRAIN]
+│   ├── rules/                  # Core Behavior (00-master, personality, etc.)
+│   ├── skills/                 # Capabilities (backend-engineer, etc.)
+│   ├── workflows/              # Procedures (SOPs)
+│   ├── templates/              # Project scaffolds
+│   ├── memory/                 # Documentation & Logs
+│   ├── scripts/                # Utility scripts
+│   └── config/                 # Global settings
+│
+├── AGENTS.md                   # [PILLAR 1] Capability Catalog (Root)
+├── CLAUDE.md                   # [PILLAR 2] Context & Instructions (Root)
+│
+└── package.json
+```
+
+### 🧠 The Two Pillars
+1. **AGENTS.md**: The catalog of all capabilities. It tells the agent *what* it can do and *where* to find instructions.
+2. **CLAUDE.md**: The context file. It tells the agent *how* to behave and points to the Master Rule in `.agents/rules/00-master.md`.
+
+---
+
 ## 🏛️ The 3-Pillar Architecture
 
 LMAgent organizes AI capabilities into three distinct pillars, enforcing a clear separation of concerns.