@qubiit/lmagent 2.5.0

package/.editorconfig

@@ -0,0 +1,18 @@
+# EditorConfig helps maintain consistent coding styles
+# https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.py]
+indent_size = 4

package/AGENTS.md

@@ -0,0 +1,169 @@
+# 🤖 LMAgent Intelligence Catalog
+
+> Catálogo completo de capacidades del ecosistema **LMAgent v2.5.0**.
+> Última actualización: 2026-02-11
+
+---
+
+## 🏗️ 1. Skills (Capacidades Ejecutables)
+*Ubicación: `skills/`*
+
+Skills son unidades especializadas que definen el comportamiento del agente para dominios específicos. Cada skill contiene:
+
+```
+skills/{skill-name}/
+├── SKILL.md           # Instrucciones, system prompt, checklists
+├── scripts/           # Scripts Python ejecutables
+├── references/        # Documentos de referencia (guías, patrones)
+└── assets/            # Archivos de datos (YAML, SQL, templates)
+```
+
+### 🎯 Meta-Skill
+
+| Skill | Triggers | Descripción |
+|-------|----------|-------------|
+| **orchestrator** | `/orch`, `/start` | Meta-agent que clasifica tareas, selecciona el skill apropiado y enruta al workflow correcto |
+
+### 🔧 Engineering
+
+| Skill | Triggers | Descripción | Extras |
+|-------|----------|-------------|--------|
+| **backend-engineer** | `/dev`, `/backend`, `/api`, `/fix` | APIs, lógica de negocio, bases de datos (FastAPI, NestJS) | **Uso:** Implementación código. **Vs API Designer:** Backend codifica; Designer define contrato. |
+| **frontend-engineer** | `/front`, `/ui`, `/react` | React, Next.js, interfaces web, accesibilidad | `scripts/audit_bundle.py`, `references/accessibility-guide.md` |
+| **mobile-engineer** | `/mobile`, `/rn`, `/ios`, `/android` | React Native, Expo, iOS/Android | `references/platform-guidelines.md` |
+| **data-engineer** | `/data`, `/db`, `/sql`, `/etl` | PostgreSQL, ETL, migraciones, índices | `scripts/backup_postgres.py`, `references/index-strategy.md`, `assets/pg-monitoring-queries.sql` |
+| **devops-engineer** | `/devops`, `/infra`, `/deploy`, `/docker` | CI/CD, Docker, Kubernetes, Terraform | `scripts/docker_healthcheck.py`, `references/ci-cd-patterns.md` |
+| **performance-engineer** | `/perf`, `/slow`, `/optimize`, `/load` | Profiling, caching, load testing | `scripts/profile_endpoint.py`, `references/caching-patterns.md` |
+| **security-analyst** | `/sec`, `/audit`, `/auth` | OWASP, auditoría de código, vulnerabilidades | `scripts/audit_security.py`, `references/owasp-top10.md` |
+| **qa-engineer** | `/qa`, `/test`, `/bug` | Testing, cobertura, E2E (Playwright, pytest, jest) | **Uso:** Ejecución de tests. **Vs Strategist:** QA escribe/corre code; Strategist define plan. |
+| **code-reviewer** | `/review`, `/critique` | Análisis estático, logic verification, clean code | `references/code-review-checklist.md` |
+| **systematic-debugger** | `/debug`, `/fix` | Debugging metódico, root cause analysis | **Uso:** Análisis profundo manual. **Vs SWE:** Debugger diagnostica; SWE resuelve autónomamente. |
+| **api-designer** | `/api-design`, `/openapi` | Diseño de contratos API, REST/GraphQL | `references/api-standards.md` |
+| **supabase-expert** | `/supabase`, `/rls` | Backend as a Service, Auth, DB, Edge Functions | `references/supabase-patterns.md` |
+| **git-workflow** | `/git`, `/commit` | Gestión de ramas, conventional commits, PRs | `references/git-flow.md` |
+| **browser-agent** | `/browser`, `/scrape` | Automatización web, scraping, testing UI | `scripts/playwright_setup.ts` |
+| **seo-auditor** | `/seo`, `/audit` | Auditoría técnica SEO, Core Web Vitals, accesibilidad | `references/seo-checklist.md` |
+
+### 🤖 AI & Automation
+
+| Skill | Triggers | Descripción | Extras |
+|-------|----------|-------------|--------|
+| **ai-agent-engineer** | `/agent`, `/mcp`, `/tool` | Agentes IA, MCP servers, tool-use, RAG | `references/agent-patterns.md` |
+| **automation-engineer** | `/auto`, `/n8n`, `/webhook` | n8n workflows, automatizaciones, webhooks | `references/n8n-patterns.md` |
+| **prompt-engineer** | `/prompt`, `/cot`, `/llm` | Optimización de prompts, evaluación, few-shot | `references/prompt-patterns.md` |
+| **mcp-builder** | `/mcp`, `/server` | Construcción de servidores MCP y herramientas | `references/mcp-server-guide.md` |
+| **document-generator** | `/pdf`, `/docx` | Generación de reportes y documentos programáticos | `references/pdf-generation.md` |
+
+### 📋 Management & Process
+
+| Skill | Triggers | Descripción | Extras |
+|-------|----------|-------------|--------|
+| **product-manager** | `/pm`, `/product`, `/prd` | PRD, user stories, roadmap, priorización | `references/prioritization-frameworks.md` |
+| **architect** | `/arch`, `/design`, `/system` | Diseño de sistemas, C4, ADRs, NFRs | `references/c4-model.md` |
+| **tech-lead** | `/tl`, `/review`, `/adr`, `/debt` | Code review, decisiones técnicas, mentoring | `references/code-review-checklist.md` |
+| **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'. |
+
+### 📐 Methodologies
+
+| Skill | Triggers | Descripción | Extras |
+|-------|----------|-------------|--------|
+| **bmad-methodology** | `/bmad` | Scale-Adaptive Intelligence, niveles 0-4, kickoff | `references/scale-adaptive-levels.md` |
+| **swe-agent** | `/swe`, `/issue-solve`, `/trajectory` | Resolución autónoma de issues, Edit-Lint-Test loops | `references/trajectory-format.md` |
+| **spec-driven-dev** | `/spec-dev`, `/sdd-skill`, `/spec-method` | Pipeline: SPECIFY → PLAN → TASKS → IMPLEMENT → VERIFY | `references/phase-gates.md` |
+
+---
+
+## 📜 2. Rules (Guardrails de Comportamiento)
+*Ubicación: `rules/`*
+
+Rules definen **CÓMO** debe comportarse el agente. Son restricciones y estándares que aplican siempre.
+
+| Rule File | Propósito |
+|-----------|----------|
+| **agents-ia.md** | Directrices core 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** | Estándares para comentarios, READMEs, ADRs. **⚠️ Regla de documentación continua** |
+| **security.md** | **Crítica**: 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, convenciones de commits, contribución |
+
+---
+
+## ⚡ 3. Workflows (Procedimientos Operativos)
+*Ubicación: `workflows/`*
+
+Workflows son **SOPs (Standard Operating Procedures)** que guían al agente en procesos complejos multi-paso.
+
+| Workflow | Propósito |
+|----------|----------|
+| **bugfix-backend.md** | Protocolo para diagnosticar, corregir y verificar bugs de backend |
+| **documentation.md** | Guía para actualizar y mantener la documentación del proyecto |
+| **generate-prd.md** | Template e instrucciones para crear Product Requirement Documents |
+| **ideation.md** | Proceso de brainstorming para nuevas features o productos |
+| **new-agent-ia.md** | Guía end-to-end para crear un nuevo agente IA desde cero |
+| **new-automation.md** | Pasos para diseñar y desplegar una nueva automatización (n8n/script) |
+| **new-feature.md** | Flujo estándar: Ticket → Design → Implementation → Test → PR |
+| **optimize-performance.md** | Enfoque sistemático para identificar y corregir bottlenecks |
+| **resolve-github-issue.md** | Flujo estándar para resolver GitHub Issues de forma autónoma |
+| **security-review.md** | Checklist para auditorías de seguridad pre-deployment |
+| **spec-driven.md** | Metodología de desarrollo basada en especificaciones (Spec-First) |
+| **testing-strategy.md** | Definir la pirámide de testing y estrategia para una feature |
+| **third-party-integration.md** | Guía para integrar APIs y SDKs de terceros de forma segura |
+
+---
+
+## 🔧 4. Config (Configuración)
+*Ubicación: `config/`*
+
+| Archivo | Propósito |
+|---------|----------|
+| **settings.yaml** | Configuración global del framework (niveles, idioma, autonomía) |
+| **levels.yaml** | Definición de los niveles de complejidad (0-4) |
+| **models.yaml** | Configuración de modelos LLM (providers, fallbacks, costos) |
+| **tools.yaml** | Registry de herramientas disponibles |
+| **tools-extended.yaml** | Herramientas extendidas (database, sandbox, etc.) |
+| **commands.yaml** | Comandos CLI del framework |
+
+---
+
+## 📦 5. Templates (Plantillas de Proyecto)
+*Ubicación: `templates/`*
+
+👉 **[Ver Guía de Uso de Templates](templates/USAGE.md)**
+
+| Template | Descripción |
+|----------|-------------|
+| **backend-python/** | FastAPI backend con SQLModel |
+| **agent-python/** | Agente IA basado en Python |
+| **frontend-react/** | Frontend React (template base) |
+| **database/** | Esquema base de PostgreSQL |
+| **PROJECT_KICKOFF.md** | Template de kickoff de proyecto |
+| **spec.yaml** | Template de especificaciones |
+| **plan.yaml** | Template de plan |
+| **tasks.yaml** | Template de tareas |
+| **session.yaml** | Template de sesión |
+| **checkpoint.yaml** | Template de checkpoint |
+
+---
+
+## 💾 Installation
+
+```bash
+npx lmagent install
+```
+
+Para desarrollo local:
+
+```bash
+git clone https://github.com/QuBit/lmagent.git
+cd lmagent
+npm install
+npm link
+lmagent install
+```

package/CLAUDE.md

@@ -0,0 +1,122 @@
+# LMAgent Framework v2.5.0 - Claude Code Instructions
+
+> [!IMPORTANT]
+> **ANTES DE HACER CUALQUIER COSA**: Este proyecto usa el framework **LMAgent v2.5.0**.
+> **DEBES** leer `AGENTS.md` y `rules/_bootstrap.md` antes de implementar cualquier cambio.
+
+## Framework
+
+Estás trabajando con **LMAgent v2.5.0**, 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
+
+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/`
+
+## 🚀 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
+```

package/CONTRIBUTING.md

@@ -0,0 +1,90 @@
+# Contributing directly to LMAgent
+
+¡Gracias por tu interés en contribuir a LMAgent! 🚀
+
+Este documento define el proceso para contribuir código, documentación o reportar issues.
+
+## Código de Conducta
+
+Este proyecto se rige por un Código de Conducta estándar. Al participar, se espera que mantengas un ambiente respetuoso y colaborativo.
+
+## ¿Cómo Contribuir?
+
+### 1. Reportar Bugs
+- Abre un Issue en GitHub.
+- Usa el template de **Bug Report**.
+- Incluye pasos para reproducir, logs y screenshots.
+
+### 2. Sugerir Features
+- Abre un Issue en GitHub con la etiqueta `enhancement`.
+- Explica el "por qué" y el caso de uso.
+- Si es posible, describe la solución técnica propuesta.
+
+### 3. Pull Requests (PRs)
+
+#### Proceso
+1. Haz un Fork del repositorio.
+2. Crea una rama para tu feature: `git checkout -b feature/mi-nueva-feature`
+3. Implementa tus cambios siguiendo las reglas del proyecto.
+4. Asegúrate de pasar todos los tests: `pytest`
+5. Haz commit con mensajes descriptivos: `feat: agrega soporte para anthropic`
+6. Push a tu rama: `git push origin feature/mi-nueva-feature`
+7. Abre un Pull Request hacia `main`.
+
+#### Checklist para PRs
+- [ ] ¿Actualizaste la documentación?
+- [ ] ¿Agregaste tests para tu código?
+- [ ] ¿Pasaste el linter (`ruff check .`)?
+- [ ] ¿Cumple con las reglas en `rules/`?
+
+## Estilo de Código
+
+Respetamos estrictamente:
+- **Python**: PEP 8, Type Hints (mypy strict), Ruff para linting/formatting.
+- **Commit Messages**: Conventional Commits (`feat:`, `fix:`, `docs:`, etc).
+- **Documentación**: Markdown claro y conciso.
+
+## 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.
+
+## Desarrollo Local
+
+### Prerrequisitos
+- Node.js >= 18
+- Python >= 3.10 (para ejecutar scripts de skills)
+
+### Setup del CLI (Node.js)
+
+```bash
+# 1. Instalar dependencias
+npm install
+
+# 2. Linkear globalmente para desarrollo
+npm link
+
+# 3. Probar cambios
+lmagent doctor
+```
+
+### Desarrollo de Skills (Python)
+
+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
+```
+
+### Linting & Formatting
+
+- **JavaScript**: Eslint/Prettier (vía `npm test` si configurado)
+- **Python**: `ruff check .` (para scripts en `skills/`)
+
+¡Gracias por ayudar a hacer LMAgent mejor!

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Leandro Martín Alvarez (QuBiit)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,195 @@
+# 🧠 LMAgent: The Universal AI Agent Runtime
+
+```text
+██╗     ███╗   ███╗ █████╗  ██████╗ ███████╗███╗   ██╗████████╗
+██║     ████╗ ████║██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝
+██║     ██╔████╔██║███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║   
+██║     ██║╚██╔╝██║██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║   
+███████╗██║ ╚═╝ ██║██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   
+╚══════╝╚═╝     ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   
+                                                  by QuBit
+```
+
+![Version](https://img.shields.io/badge/Version-2.5.0-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)
+
+> **"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).
+
+---
+
+## 🚀 Quick Start Guide
+
+Get your agent infrastructure up and running in less than 2 minutes.
+
+### Option A: Direct Execution (No Install)
+The fastest way to enhance your current project.
+
+```bash
+# Initialize project (copies CLAUDE.md, AGENTS.md, config, etc.)
+npx lmagent init
+
+# Install skills, rules & workflows into your IDE
+npx lmagent install
+
+# Verify everything is correctly configured
+npx lmagent doctor
+```
+
+### Option B: Local Development Setup
+If you want to contribute or fork the project:
+
+1.  **Clone the Repository**
+    ```bash
+    git clone https://github.com/QuBit/lmagent.git
+    cd lmagent
+    ```
+
+2.  **Install Dependencies**
+    ```bash
+    npm install
+    ```
+
+3.  **Link Globally**
+    ```bash
+    npm link
+    lmagent install
+    ```
+
+---
+
+## 🏛️ The 3-Pillar Architecture
+
+LMAgent organizes AI capabilities into three distinct pillars, enforcing a clear separation of concerns.
+
+```mermaid
+graph TD
+    A["🤖 AI Agent"] --> B("🛠️ Skills")
+    A --> C("📜 Rules")
+    A --> D("⚡ Workflows")
+    
+    B --> B1["{ide}/skills/"]
+    B --> B2["Executable Tools & Scripts"]
+    
+    C --> C1["{ide}/rules/"]
+    C --> C2["Behavioral Guardrails & Context"]
+    
+    D --> D1["{ide}/workflows/"]
+    D --> D2["Standard Operating Procedures (SOPs)"]
+```
+
+### 1. 🛠️ Skills (Capabilities)
+*Executable units that allow the Agent to interact with the world.*  
+**Location:** `{ide}/skills/` or `~/.agents/skills/`
+
+| Skill Name | Description | Tools Included |
+| :--- | :--- | :--- |
+| **ai-agent-engineer** | Expert in building LLM-based systems & MCP servers. | `create-agent`, `scaffold-mcp` |
+| **architect** | System design, scalable patterns, cloud infrastructure. | `design-system`, `review-architecture` |
+| **automation-engineer** | n8n workflows, Zapier integration, scripting. | `deploy-n8n`, `check-webhook` |
+| **backend-engineer** | API design, Database schema, Authentication. | `scaffold-api`, `optimize-query` |
+| **data-engineer** | ETL pipelines, SQL optimization, Data warehousing. | `analyze-schema`, `run-migration` |
+| **devops-engineer** | CI/CD, Docker, Kubernetes, Terraform. | `docker-build`, `k8s-deploy` |
+| **frontend-engineer** | React, Next.js, Tailwind, State Management. | `scaffold-component`, `check-accessibility` |
+| **mobile-engineer** | React Native, Expo, iOS/Android build pipelines. | `build-ios`, `debug-android` |
+| **orchestrator** | High-level task planning and agent coordination. | `plan-task`, `delegate-subtask` |
+| **performance-engineer** | Profiling, load testing, optimization. | `run-lighthouse`, `profile-memory` |
+| **product-manager** | PRD generation, user stories, roadmap planning. | `generate-user-story`, `prioritize-backlog` |
+| **prompt-engineer** | Optimizing system prompts and LLM interactions. | `optimize-prompt`, `eval-prompt` |
+| **qa-engineer** | E2E testing (Playwright), Unit tests, QA strategy. | `run-playwright`, `generate-test-plan` |
+| **scrum-master** | Agile ceremonies, sprint planning, retrospective. | `start-sprint`, `generate-retro` |
+| **security-analyst** | Vulnerability scanning, code auditing, OWASP. | `scan-vulnerabilities`, `audit-code` |
+| **tech-lead** | Code review, technical decision making, mentoring. | `review-pr`, `enforce-standards` |
+| **technical-writer** | Documentation, API refs, user guides. | `generate-docs`, `update-readme` |
+| **ux-ui-designer** | Design systems, user flow, prototyping. | `analyze-ux`, `generate-palette` |
+| **bmad-methodology** | Scale-Adaptive Intelligence, project kickoff, complexity classification. | `classify-level`, `kickoff-project` |
+| **swe-agent** | Autonomous issue resolution, trajectory logging, Edit-Lint-Test loops. | `resolve-issue`, `trajectory-log` |
+| **spec-driven-dev** | Spec-first development pipeline: SPECIFY → PLAN → TASKS → IMPLEMENT → VERIFY. | `create-spec`, `validate-spec` |
+
+
+### 2. 📜 Rules (Context & Guardrails)
+*Constraints and guidelines that shape Agent behavior.*  
+**Location:** `{ide}/rules/` or `~/.agents/rules/`
+
+| Rule File | Description |
+| :--- | :--- |
+| **_bootstrap.md** | ⭐ **Entry point**: Startup check, skill activation, critical rules for ALL IDEs. |
+| **agents-ia.md** | Core guidelines for building AI Agents (Tool-first, Stateless, Observable). |
+| **api-design.md** | REST/GraphQL standards, error handling, versioning best practices. |
+| **automations-n8n.md** | Best practices for building robust n8n workflows. |
+| **code-style.md** | Linter configuration, naming conventions, project structure. |
+| **documentation.md** | Standards for code comments, READMEs, and architectural decision records (ADRs). |
+| **security.md** | **Critical**: Input validation, secret management, OWASP Top 10 prevention. |
+| **stack.md** | Approved technology stack and library choices for the project. |
+| **testing.md** | Mandatory Test-Driven Development (TDD) workflows and coverage requirements. |
+| **workflow.md** | General git flow and contribution guidelines. |
+
+
+### 3. ⚡ Workflows (SOPs)
+*Step-by-step guides for complex tasks.*  
+**Location:** `{ide}/workflows/` or `~/.agents/workflows/`
+
+| Workflow Name | Purpose |
+| :--- | :--- |
+| **bugfix-backend.md** | Protocol for diagnosing, fixing, and verifying server-side bugs. |
+| **documentation.md** | Guide for updating and maintaining project documentation. |
+| **generate-prd.md** | Template and instructions for creating Product Requirement Documents. |
+| **ideation.md** | Brainstorming process for new features or products. |
+| **new-agent-ia.md** | End-to-end guide for creating a new AI Agent from scratch. |
+| **new-automation.md** | Steps to design and deploy a new automation (n8n/script). |
+| **new-feature.md** | Standard flow: Ticket -> Design -> Implementation -> Test -> PR. |
+| **optimize-performance.md** | Systematic approach to identifying and fixing bottlenecks. |
+| **resolve-github-issue.md** | Standard flow for addressing GitHub Issues. |
+| **security-review.md** | Checklist for pre-deployment security audits. |
+| **spec-driven.md** | Development methodology based on detailed specifications (Spec-First). |
+| **testing-strategy.md** | Defining the testing pyramid and strategy for a feature. |
+| **third-party-integration.md** | Guide for securely integrating external APIs and SDKs. |
+
+---
+
+## 💎 Features & IDE Support
+
+### 🌍 Centralized "Brain" (`~/.agents`)
+LMAgent creates a **Single Source of Truth** in your home directory.
+*   **Update Once, Reflect Everywhere**: Modify a rule in `~/.agents/rules/code-style.md`, and *every project* using Symlinks updates instantly.
+*   **Zero-Copy Efficiency**: No more valid/duplicate `.md` files cluttering every repo.
+
+### 🧩 Multi-IDE Support
+
+| IDE / Agent | Support Level | Config Path |
+| :--- | :--- | :--- |
+| **Cursor** | ✅ Full | `.cursor/` |
+| **Windsurf** | ✅ Full | `.windsurf/` |
+| **VSCode / Copilot** | ✅ Full | `.github/` |
+| **Zed** | ✅ Full | `.rules/` |
+| **Continue** | ✅ Full | `.continue/` |
+| **Trae** | ✅ Full | `.trae/` |
+| **Antigravity** | ✅ Full | `.antigravity/` |
+| **Cline / Roo Code** | ✅ Full | `.clinerules/` |
+| **Claude Code** | ✅ Full | `.claude/` |
+| **Qodo** | ✅ Full | `agents/` |
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions to expand the **Universal Agent Brain**.
+Check out `CONTRIBUTING.md` to add new Skills, Rules, or IDE support.
+
+### 🛠️ Creating New Skills
+Need a custom agent? Use the interactive generator:
+
+```bash
+# Verify structure of existing skills
+python validate_skills.py
+
+# Create a new skill interactively
+python create_skill.py
+```
+This will generate the standard directory structure and `SKILL.md` template for you.
+
+
+---
+
+<p align="center">
+  Built with ❤️ by <b>QuBit</b>
+</p>