@qubiit/lmagent 2.5.0

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@qubiit/lmagent",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "2.5.0",
+  "description": "CLI to install LMAgent skills and rules into your IDE",
+  "main": "install.js",
+  "bin": {
+    "lmagent-skills": "install.js",
+    "lmagent": "install.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "start": "node install.js"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "skills",
+    "cursor",
+    "windsurf",
+    "ide"
+  ],
+  "author": "Leandro Martín Alvarez (QuBiit)",
+  "license": "MIT",
+  "dependencies": {
+    "boxen": "^8.0.1",
+    "chalk": "^4.1.2",
+    "commander": "^13.1.0",
+    "figlet": "^1.10.0",
+    "gradient-string": "^3.0.0",
+    "inquirer": "^8.2.6"
+  }
+}

package/pyproject.toml

@@ -0,0 +1,182 @@
+[project]
+name = "lmagent"
+version = "2.3.0"
+description = "Framework for automation and AI agent development"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.12"
+authors = [
+    { name = "QuBiit0", email = "info@leandroalvarez.com.ar" }
+]
+keywords = [
+    "ai",
+    "agents",
+    "automation",
+    "llm",
+    "framework",
+    "mcp"
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+dependencies = [
+    "pydantic>=2.10",
+    "pydantic-settings>=2.4",
+    "pyyaml>=6.0",
+    "structlog>=24.1",
+    "httpx>=0.27",
+    "python-dotenv>=1.0",
+    "fastapi>=0.115",
+    "sqlmodel>=0.0.22",
+    "litellm>=1.45",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "pytest-cov>=5.0",
+    "ruff>=0.5",
+    "mypy>=1.10",
+    "pre-commit>=3.7",
+]
+llm = [
+    "openai>=1.40",
+    "anthropic>=0.30",
+    "google-generativeai>=0.7",
+    "litellm>=1.45",
+    "langchain>=0.2.10",
+    "langgraph>=0.1.5",
+]
+tools = [
+    "aiohttp>=3.10",
+    "asyncpg>=0.29",
+    "redis>=5.0",
+    "pandas>=2.2",
+]
+all = [
+    "lmagent[dev]",
+    "lmagent[llm]",
+    "lmagent[tools]",
+]
+
+[project.urls]
+Homepage = "https://github.com/QuBiit0/lmagent"
+Documentation = "https://github.com/QuBiit0/lmagent#readme"
+Repository = "https://github.com/QuBiit0/lmagent"
+Issues = "https://github.com/QuBiit0/lmagent/issues"
+
+# [build-system]
+# requires = ["hatchling"]
+# build-backend = "hatchling.build"
+
+# [tool.hatch.build.targets.wheel]
+# packages = ["agents"]
+
+# ============================================
+# RUFF (Linter & Formatter)
+# ============================================
+
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+exclude = [
+    ".git",
+    ".venv",
+    "venv",
+    "__pycache__",
+    "node_modules",
+    ".ruff_cache",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",    # pycodestyle errors
+    "W",    # pycodestyle warnings
+    "F",    # pyflakes
+    "I",    # isort
+    "B",    # flake8-bugbear
+    "C4",   # flake8-comprehensions
+    "UP",   # pyupgrade
+    "ARG",  # flake8-unused-arguments
+    "SIM",  # flake8-simplify
+]
+ignore = [
+    "E501",  # line too long (handled by formatter)
+    "B008",  # do not perform function calls in argument defaults
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["agents", "lmagent"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+
+# ============================================
+# MYPY (Type Checking)
+# ============================================
+
+[tool.mypy]
+python_version = "3.12"
+warn_return_any = true
+warn_unused_ignores = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+ignore_missing_imports = true
+exclude = [
+    "tests",
+    "venv",
+    ".venv",
+]
+
+# ============================================
+# PYTEST
+# ============================================
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+asyncio_mode = "auto"
+testpaths = ["tests"]
+python_files = ["test_*.py", "*_test.py"]
+python_functions = ["test_*"]
+addopts = [
+    "-v",
+    "--tb=short",
+    "--strict-markers",
+]
+markers = [
+    "slow: marks tests as slow",
+    "integration: marks tests as integration tests",
+]
+filterwarnings = [
+    "ignore::DeprecationWarning",
+]
+
+[tool.coverage.run]
+source = ["agents"]
+branch = true
+omit = [
+    "*/tests/*",
+    "*/__pycache__/*",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+]
+fail_under = 80

package/rules/_bootstrap.md

@@ -0,0 +1,138 @@
+# 🚀 LMAgent Bootstrap — Instrucciones Iniciales
+
+> **Tipo**: `rule` | **Versión**: 2.5.0 | **Prioridad**: MÁXIMA
+> Esta regla se aplica **SIEMPRE** como primer paso antes de cualquier tarea.
+
+---
+
+## 📌 Startup Check (Auto-Start)
+
+**¿Existe `PROJECT_KICKOFF.md` en la raíz del proyecto?**
+- **SÍ** → Activa el skill `product-manager` (`/pm`) y ejecuta el workflow `spec-driven`.
+- **NO** → Continuar con el flujo normal.
+
+---
+
+## 🧠 Framework
+
+Estás trabajando con **LMAgent v2.5.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 `rules/workflow.md`)
+3. **Activa el skill apropiado** — Según la tabla de abajo
+
+---
+
+## 🤖 Activación de Skills por IDE
+
+**La forma de activar skills depende del IDE:**
+
+| IDE | Mecanismo | Ejemplo |
+|-----|-----------|---------|
+| **Cursor** | `/slash-commands` nativos del IDE | Escribir `/dev` en el chat |
+| **Antigravity** | Automático por contexto | El agente lee `SKILL.md` al detectar tarea relevante |
+| **Claude Code** | Lectura de `SKILL.md` | El agente accede al directorio `skills/` |
+| **Otros IDEs** | Según configuración del IDE | Ver documentación del IDE |
+
+> **En Antigravity**: Los triggers como `/dev` o `/pm` **no son comandos ejecutables**. Son convenciones para que el agente identifique qué skill activar. El agente debe:
+> 1. Detectar la naturaleza de la tarea (ej: "crear endpoint" → backend)
+> 2. Leer el `SKILL.md` completo del skill relevante
+> 3. Adoptar el rol, principios y patrones descritos
+> 4. Seguir la "Definition of Done" del skill
+
+---
+
+## 🎯 Skills Disponibles (31)
+
+Activa el skill apropiado según la tarea. Cada skill tiene `SKILL.md` con instrucciones detalladas, y opcionalmente `scripts/`, `references/` y `assets/`.
+
+### Meta-Skill
+| Skill | Triggers | Descripción |
+|-------|----------|-------------|
+| **orchestrator** | `/orch`, `/start` | Meta-agent: clasifica tareas y enruta al skill correcto |
+
+### Engineering
+| Skill | Triggers | Descripción |
+|-------|----------|-------------|
+| **backend-engineer** | `/dev`, `/backend`, `/api`, `/fix` | APIs, lógica de negocio, bases de datos |
+| **frontend-engineer** | `/front`, `/ui`, `/react` | React, Next.js, interfaces web |
+| **mobile-engineer** | `/mobile`, `/rn`, `/ios`, `/android` | React Native, Expo, apps móviles |
+| **data-engineer** | `/data`, `/db`, `/sql`, `/etl` | PostgreSQL, ETL, migraciones |
+| **devops-engineer** | `/devops`, `/infra`, `/deploy`, `/docker` | CI/CD, Docker, Kubernetes |
+| **performance-engineer** | `/perf`, `/slow`, `/optimize`, `/load` | Profiling, caching, optimización |
+| **security-analyst** | `/sec`, `/audit`, `/auth` | OWASP, auditoría, vulnerabilidades |
+| **qa-engineer** | `/qa`, `/test`, `/bug` | Testing, cobertura, E2E |
+| **systematic-debugger** | `/debug`, `/bug`, `/fix`, `/rca` | Debugging metódico en 4 fases, root cause analysis |
+
+### Quality & Testing
+| Skill | Triggers | Descripción |
+|-------|----------|-------------|
+| **code-reviewer** | `/review`, `/cr`, `/code-review` | Reviews sistemáticos multi-pass, anti-patrones |
+| **testing-strategist** | `/tdd`, `/testing`, `/test-strategy` | TDD/BDD, testing pyramid, estrategia de tests |
+| **git-workflow** | `/git`, `/branch`, `/release` | Branching, conventional commits, release management |
+| **api-designer** | `/api`, `/endpoint`, `/rest`, `/graphql` | Diseño REST/GraphQL, OpenAPI, DX |
+
+### AI & Automation
+| Skill | Triggers | Descripción |
+|-------|----------|-------------|
+| **ai-agent-engineer** | `/agent`, `/tool` | Agentes IA, tool-use, multi-agent |
+| **mcp-builder** | `/mcp`, `/mcp-server`, `/tool-builder` | MCP Servers, Tools, Resources, Prompts |
+| **automation-engineer** | `/auto`, `/n8n`, `/webhook` | n8n workflows, automatizaciones |
+| **prompt-engineer** | `/prompt`, `/cot`, `/llm` | Optimización de prompts |
+
+### Platform & Tools
+| Skill | Triggers | Descripción |
+|-------|----------|-------------|
+| **supabase-expert** | `/supa`, `/supabase`, `/rls`, `/edge-function` | RLS, Auth, Edge Functions, Realtime, Storage |
+| **browser-agent** | `/browser`, `/scrape`, `/crawl`, `/automate` | Playwright/Puppeteer, scraping, flujos web automáticos |
+| **document-generator** | `/pdf`, `/doc`, `/excel`, `/pptx` | Generación de PDF, DOCX, XLSX, PPTX programáticos |
+| **seo-auditor** | `/seo`, `/audit`, `/lighthouse`, `/a11y` | SEO técnico, Core Web Vitals, WCAG, schema markup |
+
+### Management & Process
+| Skill | Triggers | Descripción |
+|-------|----------|-------------|
+| **product-manager** | `/pm`, `/product`, `/prd` | PRD, user stories, roadmap |
+| **architect** | `/arch`, `/design`, `/system` | Diseño de sistemas, C4, ADRs |
+| **tech-lead** | `/tl`, `/adr`, `/debt` | Decisiones técnicas, tech debt |
+| **scrum-master** | `/sm`, `/agile`, `/coach` | Ceremonias, sprints, retrospectivas |
+| **technical-writer** | `/doc`, `/readme`, `/guide` | Documentación, guías |
+| **ux-ui-designer** | `/ux`, `/ui`, `/design` | Design systems, UX research |
+
+### Methodologies
+| Skill | Triggers | Descripción |
+|-------|----------|-------------|
+| **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 |
+
+---
+
+## ⚠️ Reglas Críticas
+
+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** del proyecto
+7. 🔄 **Commits pequeños y descriptivos**
+8. 📚 **Documentar cambios significativos** (ver `rules/documentation.md`)
+9. 🔒 **Nunca hardcodear secretos** — usar variables de entorno
+10. ❓ **Si hay duda, preguntar**
+
+---
+
+## 📂 Estructura del Framework
+
+```
+rules/          → Guardrails de comportamiento (CÓMO)
+skills/         → Capacidades especializadas (QUÉ)
+  └── {skill}/
+      ├── SKILL.md        → Instrucciones del skill
+      ├── scripts/        → Scripts ejecutables
+      ├── references/     → Guías y patrones
+      └── assets/         → Templates, SQL, YAML
+workflows/      → Procedimientos operativos (SOPs)
+config/         → Configuración del framework
+templates/      → Plantillas de proyecto
+```