@qubiit/lmagent 2.7.1 → 3.0.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 (152) hide show
  1. package/{config → .agents/config}/models.yaml +1 -1
  2. package/{config → .agents/config}/settings.yaml +1 -1
  3. package/{docs → .agents/docs}/getting-started.md +1 -1
  4. package/{docs → .agents/docs}/how-to-start.md +1 -1
  5. package/{rules/_bootstrap.md → .agents/rules/00-master.md} +16 -15
  6. package/{rules/workflow.md → .agents/rules/01-workflow.md} +5 -22
  7. package/{rules/stack.md → .agents/rules/02-tech-stack.md} +1 -1
  8. package/{rules/code-style.md → .agents/rules/03-code-style.md} +12 -1
  9. package/{rules/security.md → .agents/rules/04-security.md} +10 -8
  10. package/{rules/testing.md → .agents/rules/05-testing.md} +6 -4
  11. package/{rules/api-design.md → .agents/rules/06-api-design.md} +1 -1
  12. package/{rules/documentation.md → .agents/rules/07-documentation.md} +8 -8
  13. package/{rules/agents-ia.md → .agents/rules/08-agents-ai.md} +11 -7
  14. package/{rules/automations-n8n.md → .agents/rules/09-automations.md} +1 -1
  15. package/.agents/rules/10-git-flow.md +122 -0
  16. package/{scripts → .agents/scripts}/create_skill.js +3 -3
  17. package/{scripts → .agents/scripts}/validate_skills.js +6 -5
  18. package/{skills → .agents/skills}/ai-agent-engineer/SKILL.md +394 -394
  19. package/{skills → .agents/skills}/api-designer/SKILL.md +1 -1
  20. package/{skills → .agents/skills}/architect/SKILL.md +285 -285
  21. package/{skills → .agents/skills}/automation-engineer/SKILL.md +352 -352
  22. package/{skills → .agents/skills}/backend-engineer/SKILL.md +261 -261
  23. package/{skills → .agents/skills}/bmad-methodology/SKILL.md +202 -202
  24. package/{skills → .agents/skills}/browser-agent/SKILL.md +1 -1
  25. package/{skills → .agents/skills}/code-reviewer/SKILL.md +1 -1
  26. package/{skills → .agents/skills}/data-engineer/SKILL.md +474 -474
  27. package/{skills → .agents/skills}/devops-engineer/SKILL.md +547 -547
  28. package/{skills → .agents/skills}/document-generator/SKILL.md +1 -1
  29. package/{skills → .agents/skills}/frontend-engineer/SKILL.md +532 -532
  30. package/{skills → .agents/skills}/git-workflow/SKILL.md +1 -1
  31. package/{skills → .agents/skills}/mcp-builder/SKILL.md +1 -1
  32. package/{skills → .agents/skills}/mobile-engineer/SKILL.md +502 -502
  33. package/{skills → .agents/skills}/orchestrator/SKILL.md +246 -246
  34. package/{skills → .agents/skills}/performance-engineer/SKILL.md +549 -549
  35. package/{skills → .agents/skills}/product-manager/SKILL.md +488 -488
  36. package/{skills → .agents/skills}/prompt-engineer/SKILL.md +433 -433
  37. package/{skills → .agents/skills}/qa-engineer/SKILL.md +441 -441
  38. package/{skills → .agents/skills}/scrum-master/SKILL.md +225 -225
  39. package/{skills → .agents/skills}/security-analyst/SKILL.md +390 -390
  40. package/{skills → .agents/skills}/seo-auditor/SKILL.md +1 -1
  41. package/{skills → .agents/skills}/spec-driven-dev/SKILL.md +342 -342
  42. package/{skills → .agents/skills}/supabase-expert/SKILL.md +1 -1
  43. package/{skills → .agents/skills}/swe-agent/SKILL.md +311 -311
  44. package/{skills → .agents/skills}/systematic-debugger/SKILL.md +1 -1
  45. package/{skills → .agents/skills}/tech-lead/SKILL.md +409 -409
  46. package/{skills → .agents/skills}/technical-writer/SKILL.md +631 -631
  47. package/{skills → .agents/skills}/testing-strategist/SKILL.md +1 -1
  48. package/{skills → .agents/skills}/ux-ui-designer/SKILL.md +419 -419
  49. package/{templates → .agents/templates}/SKILL_TEMPLATE.md +2 -2
  50. package/{templates → .agents/templates}/backend-node/package.json +1 -1
  51. package/{templates → .agents/templates}/spec.yaml +1 -1
  52. package/{workflows → .agents/workflows}/bugfix-backend.md +1 -1
  53. package/{workflows → .agents/workflows}/new-agent-ia.md +1 -1
  54. package/{workflows → .agents/workflows}/new-automation.md +1 -1
  55. package/{workflows → .agents/workflows}/new-feature.md +1 -1
  56. package/{workflows → .agents/workflows}/spec-driven.md +1 -1
  57. package/AGENTS.md +177 -196
  58. package/CLAUDE.md +12 -152
  59. package/CONTRIBUTING.md +9 -9
  60. package/README.md +29 -2
  61. package/install.js +228 -106
  62. package/package.json +41 -10
  63. package/docs/assets/logo.png +0 -0
  64. /package/{config → .agents/config}/commands.yaml +0 -0
  65. /package/{config → .agents/config}/levels.yaml +0 -0
  66. /package/{config → .agents/config}/tools-extended.yaml +0 -0
  67. /package/{config → .agents/config}/tools.yaml +0 -0
  68. /package/{docs → .agents/docs}/commands.md +0 -0
  69. /package/{docs → .agents/docs}/customization-guide.md +0 -0
  70. /package/{docs → .agents/docs}/navigation-index.md +0 -0
  71. /package/{docs → .agents/docs}/usage-guide.md +0 -0
  72. /package/{skills → .agents/skills}/ai-agent-engineer/references/agent-patterns.md +0 -0
  73. /package/{skills → .agents/skills}/api-designer/references/api-standards.md +0 -0
  74. /package/{skills → .agents/skills}/architect/references/c4-model.md +0 -0
  75. /package/{skills → .agents/skills}/automation-engineer/references/n8n-patterns.md +0 -0
  76. /package/{skills → .agents/skills}/backend-engineer/assets/fastapi-project-structure.yaml +0 -0
  77. /package/{skills → .agents/skills}/backend-engineer/references/debugging-guide.md +0 -0
  78. /package/{skills → .agents/skills}/backend-engineer/references/design-patterns.md +0 -0
  79. /package/{skills → .agents/skills}/backend-engineer/scripts/scaffold_backend.py +0 -0
  80. /package/{skills → .agents/skills}/bmad-methodology/references/scale-adaptive-levels.md +0 -0
  81. /package/{skills → .agents/skills}/browser-agent/scripts/playwright_setup.ts +0 -0
  82. /package/{skills → .agents/skills}/code-reviewer/references/code-review-checklist.md +0 -0
  83. /package/{skills → .agents/skills}/data-engineer/assets/pg-monitoring-queries.sql +0 -0
  84. /package/{skills → .agents/skills}/data-engineer/references/index-strategy.md +0 -0
  85. /package/{skills → .agents/skills}/data-engineer/scripts/backup_postgres.py +0 -0
  86. /package/{skills → .agents/skills}/devops-engineer/references/ci-cd-patterns.md +0 -0
  87. /package/{skills → .agents/skills}/devops-engineer/scripts/docker_healthcheck.py +0 -0
  88. /package/{skills → .agents/skills}/document-generator/references/pdf-generation.md +0 -0
  89. /package/{skills → .agents/skills}/frontend-engineer/references/accessibility-guide.md +0 -0
  90. /package/{skills → .agents/skills}/frontend-engineer/scripts/audit_bundle.py +0 -0
  91. /package/{skills → .agents/skills}/git-workflow/references/git-flow.md +0 -0
  92. /package/{skills → .agents/skills}/mcp-builder/references/mcp-server-guide.md +0 -0
  93. /package/{skills → .agents/skills}/mobile-engineer/references/platform-guidelines.md +0 -0
  94. /package/{skills → .agents/skills}/orchestrator/references/methodology-routing.md +0 -0
  95. /package/{skills → .agents/skills}/orchestrator/references/persona-mapping.md +0 -0
  96. /package/{skills → .agents/skills}/orchestrator/references/routing-logic.md +0 -0
  97. /package/{skills → .agents/skills}/performance-engineer/references/caching-patterns.md +0 -0
  98. /package/{skills → .agents/skills}/performance-engineer/scripts/profile_endpoint.py +0 -0
  99. /package/{skills → .agents/skills}/product-manager/references/prioritization-frameworks.md +0 -0
  100. /package/{skills → .agents/skills}/prompt-engineer/references/prompt-patterns.md +0 -0
  101. /package/{skills → .agents/skills}/qa-engineer/references/testing-strategy.md +0 -0
  102. /package/{skills → .agents/skills}/qa-engineer/scripts/run_coverage.py +0 -0
  103. /package/{skills → .agents/skills}/scrum-master/references/sprint-ceremonies.md +0 -0
  104. /package/{skills → .agents/skills}/security-analyst/references/owasp-top10.md +0 -0
  105. /package/{skills → .agents/skills}/security-analyst/scripts/audit_security.py +0 -0
  106. /package/{skills → .agents/skills}/seo-auditor/references/seo-checklist.md +0 -0
  107. /package/{skills → .agents/skills}/spec-driven-dev/references/phase-gates.md +0 -0
  108. /package/{skills → .agents/skills}/supabase-expert/references/supabase-patterns.md +0 -0
  109. /package/{skills → .agents/skills}/swe-agent/references/trajectory-format.md +0 -0
  110. /package/{skills → .agents/skills}/systematic-debugger/references/debugging-guide.md +0 -0
  111. /package/{skills → .agents/skills}/tech-lead/references/code-review-checklist.md +0 -0
  112. /package/{skills → .agents/skills}/technical-writer/references/doc-templates.md +0 -0
  113. /package/{skills → .agents/skills}/testing-strategist/references/testing-pyramid.md +0 -0
  114. /package/{skills → .agents/skills}/ux-ui-designer/references/design-system-foundation.md +0 -0
  115. /package/{templates → .agents/templates}/PROJECT_KICKOFF.md +0 -0
  116. /package/{templates → .agents/templates}/USAGE.md +0 -0
  117. /package/{templates → .agents/templates}/agent-python/README.md +0 -0
  118. /package/{templates → .agents/templates}/agent-python/agent.py +0 -0
  119. /package/{templates → .agents/templates}/agent-python/config.yaml +0 -0
  120. /package/{templates → .agents/templates}/agent-python/prompts/system.md +0 -0
  121. /package/{templates → .agents/templates}/agent-python/requirements.txt +0 -0
  122. /package/{templates → .agents/templates}/automation-n8n/README.md +0 -0
  123. /package/{templates → .agents/templates}/automation-n8n/webhook-handler.json +0 -0
  124. /package/{templates → .agents/templates}/backend-node/Dockerfile +0 -0
  125. /package/{templates → .agents/templates}/backend-node/README.md +0 -0
  126. /package/{templates → .agents/templates}/backend-node/src/index.ts +0 -0
  127. /package/{templates → .agents/templates}/backend-node/src/routes.ts +0 -0
  128. /package/{templates → .agents/templates}/backend-node/tsconfig.json +0 -0
  129. /package/{templates → .agents/templates}/backend-python/Dockerfile +0 -0
  130. /package/{templates → .agents/templates}/backend-python/README.md +0 -0
  131. /package/{templates → .agents/templates}/backend-python/app/core/config.py +0 -0
  132. /package/{templates → .agents/templates}/backend-python/app/core/database.py +0 -0
  133. /package/{templates → .agents/templates}/backend-python/app/main.py +0 -0
  134. /package/{templates → .agents/templates}/backend-python/app/routers/__init__.py +0 -0
  135. /package/{templates → .agents/templates}/backend-python/app/routers/health.py +0 -0
  136. /package/{templates → .agents/templates}/backend-python/requirements-dev.txt +0 -0
  137. /package/{templates → .agents/templates}/backend-python/requirements.txt +0 -0
  138. /package/{templates → .agents/templates}/backend-python/tests/test_health.py +0 -0
  139. /package/{templates → .agents/templates}/checkpoint.yaml +0 -0
  140. /package/{templates → .agents/templates}/database/README.md +0 -0
  141. /package/{templates → .agents/templates}/frontend-react/README.md +0 -0
  142. /package/{templates → .agents/templates}/plan.yaml +0 -0
  143. /package/{templates → .agents/templates}/session.yaml +0 -0
  144. /package/{templates → .agents/templates}/tasks.yaml +0 -0
  145. /package/{workflows → .agents/workflows}/documentation.md +0 -0
  146. /package/{workflows → .agents/workflows}/generate-prd.md +0 -0
  147. /package/{workflows → .agents/workflows}/ideation.md +0 -0
  148. /package/{workflows → .agents/workflows}/optimize-performance.md +0 -0
  149. /package/{workflows → .agents/workflows}/resolve-github-issue.md +0 -0
  150. /package/{workflows → .agents/workflows}/security-review.md +0 -0
  151. /package/{workflows → .agents/workflows}/testing-strategy.md +0 -0
  152. /package/{workflows → .agents/workflows}/third-party-integration.md +0 -0
@@ -3,7 +3,7 @@ name: "[Nombre del Skill]"
3
3
  description: "[Descripción breve: qué hace este skill en una oración]"
4
4
  role: "[Rol profesional que desempeña]"
5
5
  type: agent_persona # agent_persona | methodology
6
- version: 2.3
6
+ version: 3.0.0
7
7
  icon: "🔧"
8
8
  expertise:
9
9
  - "[Área de expertise 1]"
@@ -128,4 +128,4 @@ Antes de considerar una tarea terminada, verifica TODO:
128
128
 
129
129
  ---
130
130
 
131
- *Skill version: 2.3 | LMAgent Framework*
131
+ *Skill version: 3.0.0 | LMAgent Framework*
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lmagent-backend-node",
3
- "version": "1.0.0",
3
+ "version": "3.0.0",
4
4
  "description": "LMAgent Node.js Backend Template",
5
5
  "main": "dist/index.js",
6
6
  "scripts": {
@@ -1,5 +1,5 @@
1
1
  # Spec Template (SPEC DRIVEN Development)
2
- # LMAgent Framework v3.0 - SPEC+LM Methodology
2
+ # LMAgent Framework v3.0.0 - SPEC+LM Methodology
3
3
  #
4
4
  # This template creates a structured specification that serves as the
5
5
  # source of truth for feature development. Use with `/pm` persona.
@@ -2,7 +2,7 @@
2
2
  description: Workflow para analizar y arreglar bugs en servicios backend Python/Node
3
3
  level: 1-2
4
4
  personas: [backend-engineer, qa-engineer]
5
- version: 2.1
5
+ version: 3.0.0
6
6
  type: workflow
7
7
  ---
8
8
 
@@ -2,7 +2,7 @@
2
2
  description: Workflow para crear o mejorar un agente de IA
3
3
  level: 2-3
4
4
  personas: [ai-agent-engineer, backend-engineer]
5
- version: 2.1
5
+ version: 3.0.0
6
6
  type: workflow
7
7
  ---
8
8
 
@@ -2,7 +2,7 @@
2
2
  description: Workflow para crear una nueva automatización que involucra backend + n8n + opcionalmente agentes IA
3
3
  level: 2-3
4
4
  personas: [automation-engineer, backend-engineer, ai-agent-engineer]
5
- version: 2.1
5
+ version: 3.0.0
6
6
  type: workflow
7
7
  ---
8
8
 
@@ -2,7 +2,7 @@
2
2
  description: Workflow para implementar una nueva feature completa
3
3
  level: 2-3
4
4
  personas: [backend-engineer, frontend-engineer, qa-engineer]
5
- version: 2.1
5
+ version: 3.0.0
6
6
  type: workflow
7
7
  ---
8
8
 
@@ -2,7 +2,7 @@
2
2
  description: Workflow completo de desarrollo SPEC DRIVEN (spec→plan→tasks→implement)
3
3
  level: 2-4
4
4
  personas: [pm, arch, dev, qa]
5
- version: 3.0
5
+ version: 3.0.0
6
6
  type: workflow_spec
7
7
  triggers:
8
8
  - /spec
package/AGENTS.md CHANGED
@@ -1,226 +1,207 @@
1
- # 🤖 LMAgent Intelligence Catalog
2
-
3
- > Catálogo completo de capacidades del ecosistema **LMAgent v2.7.0**.
4
- > Última actualización: 2026-02-12
1
+ # 🤖 LMAgent V3.0: The Engineering Constitution
2
+ > **SINGLE SOURCE OF TRUTH**: Este archivo es tu Ley Suprema. Define tu identidad, tus capacidades y tus límites.
3
+ > Framework: **LMAgent v3.0.0 (Total Awareness Standard)**
5
4
 
6
5
  ---
7
6
 
8
- ## 🏗️ 1. Skills (Capacidades Ejecutables)
9
- *Ubicación: Tu directorio de configuración de agente. Consulta la siguiente tabla para encontrar tu ruta:*
10
-
11
- | IDE / Agente | Ruta de Configuración |
12
- | :--- | :--- |
13
- | **Cursor** | `.cursor/` |
14
- | **Windsurf** | `.windsurf/` |
15
- | **VSCode / Copilot** | `.github/` |
16
- | **Zed** | `.rules/` |
17
- | **Antigravity** | `.agent/` |
18
- | **Claude Code** | `.claude/` |
19
- | **Cline / Roo Code** | `.clinerules/` / `.roo/` |
20
- | **Continue** | `.continue/` |
21
- | **Trae** | `.trae/` |
22
- | **Qodo** | `agents/` |
23
- | **Amp / Kimi / Replit** | `.agents/` |
24
- | **Augment** | `.augment/` |
25
- | **Codex** | `.codex/` |
26
- | **Gemini CLI** | `.gemini/` |
27
- | **OpenCode** | `.opencode/` |
28
- | **OpenHands** | `.openhands/` |
29
- | **Goose** | `.goose/` |
30
- | **Mistral Vibe** | `.vibe/` |
31
- | **Envoid (OpenClaw)** | `openclaw.json` |
32
- | **CodeBuddy** | `.codebuddy/` |
33
- | **Command Code** | `.commandcode/` |
34
- | **Crush** | `.crush/` |
35
- | **Droid** | `.factory/` |
36
- | **Junie** | `.junie/` |
37
- | **iFlow** | `.iflow/` |
38
- | **Kilo Code** | `.kilocode/` |
39
- | **Kiro** | `.kiro/` |
40
- | **Kode** | `.kode/` |
41
- | **MCPJam** | `.mcpjam/` |
42
- | **Mux** | `.mux/` |
43
- | **Pi** | `.pi/` |
44
- | **Qoder** | `.qoder/` |
45
- | **Qwen Code** | `.qwen/` |
46
- | **Trae CN** | `.trae-cn/` |
47
- | **Zencoder** | `.zencoder/` |
48
- | **Neovate** | `.neovate/` |
49
- | **Pochi** | `.pochi/` |
50
- | **AdaL** | `.adal/` |
51
-
52
- Skills son unidades especializadas que definen el comportamiento del agente para dominios específicos. Cada skill contiene:
53
-
54
- ```
55
- skills/{skill-name}/
56
- ├── SKILL.md # Instrucciones, system prompt, checklists
57
- ├── scripts/ # Scripts Python ejecutables
58
- ├── references/ # Documentos de referencia (guías, patrones)
59
- └── assets/ # Archivos de datos (YAML, SQL, templates)
60
- ```
61
-
62
- ### 🎯 Meta-Skill
63
-
64
- | Skill | Triggers | Descripción |
65
- |-------|----------|-------------|
66
- | **orchestrator** | `/orch`, `/start` | Meta-agent que clasifica tareas, selecciona el skill apropiado y enruta al workflow correcto |
7
+ ## 🦅 1. Identidad y Propósito (The Elite Persona)
67
8
 
68
- ### 🔧 Engineering
9
+ No eres un simple asistente. Eres un **Ingeniero de Software Senior de Clase Mundial** actuando como una extensión de la voluntad del usuario.
69
10
 
70
- | Skill | Triggers | Descripción | Extras |
71
- |-------|----------|-------------|--------|
72
- | **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. |
73
- | **frontend-engineer** | `/front`, `/ui`, `/react` | React, Next.js, interfaces web, accesibilidad | `scripts/audit_bundle.py`, `references/accessibility-guide.md` |
74
- | **mobile-engineer** | `/mobile`, `/rn`, `/ios`, `/android` | React Native, Expo, iOS/Android | `references/platform-guidelines.md` |
75
- | **data-engineer** | `/data`, `/db`, `/sql`, `/etl` | PostgreSQL, ETL, migraciones, índices | `scripts/backup_postgres.py`, `references/index-strategy.md`, `assets/pg-monitoring-queries.sql` |
76
- | **devops-engineer** | `/devops`, `/infra`, `/deploy`, `/docker` | CI/CD, Docker, Kubernetes, Terraform | `scripts/docker_healthcheck.py`, `references/ci-cd-patterns.md` |
77
- | **performance-engineer** | `/perf`, `/slow`, `/optimize`, `/load` | Profiling, caching, load testing | `scripts/profile_endpoint.py`, `references/caching-patterns.md` |
78
- | **security-analyst** | `/sec`, `/audit`, `/auth` | OWASP, auditoría de código, vulnerabilidades | `scripts/audit_security.py`, `references/owasp-top10.md` |
79
- | **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. |
80
- | **code-reviewer** | `/review`, `/critique` | Análisis estático, logic verification, clean code | `references/code-review-checklist.md` |
81
- | **systematic-debugger** | `/debug`, `/fix` | Debugging metódico, root cause analysis | **Uso:** Análisis profundo manual. **Vs SWE:** Debugger diagnostica; SWE resuelve autónomamente. |
82
- | **api-designer** | `/api-design`, `/openapi` | Diseño de contratos API, REST/GraphQL | `references/api-standards.md` |
83
- | **supabase-expert** | `/supabase`, `/rls` | Backend as a Service, Auth, DB, Edge Functions | `references/supabase-patterns.md` |
84
- | **git-workflow** | `/git`, `/commit` | Gestión de ramas, conventional commits, PRs | `references/git-flow.md` |
85
- | **browser-agent** | `/browser`, `/scrape` | Automatización web, scraping, testing UI | `scripts/playwright_setup.ts` |
86
- | **seo-auditor** | `/seo`, `/audit` | Auditoría técnica SEO, Core Web Vitals, accesibilidad | `references/seo-checklist.md` |
87
-
88
- ### 🤖 AI & Automation
89
-
90
- | Skill | Triggers | Descripción | Extras |
91
- |-------|----------|-------------|--------|
92
- | **ai-agent-engineer** | `/agent`, `/mcp`, `/tool` | Agentes IA, MCP servers, tool-use, RAG | `references/agent-patterns.md` |
93
- | **automation-engineer** | `/auto`, `/n8n`, `/webhook` | n8n workflows, automatizaciones, webhooks | `references/n8n-patterns.md` |
94
- | **prompt-engineer** | `/prompt`, `/cot`, `/llm` | Optimización de prompts, evaluación, few-shot | `references/prompt-patterns.md` |
95
- | **mcp-builder** | `/mcp`, `/server` | Construcción de servidores MCP y herramientas | `references/mcp-server-guide.md` |
96
- | **document-generator** | `/pdf`, `/docx` | Generación de reportes y documentos programáticos | `references/pdf-generation.md` |
97
-
98
- ### 📋 Management & Process
99
-
100
- | Skill | Triggers | Descripción | Extras |
101
- |-------|----------|-------------|--------|
102
- | **product-manager** | `/pm`, `/product`, `/prd` | PRD, user stories, roadmap, priorización | `references/prioritization-frameworks.md` |
103
- | **architect** | `/arch`, `/design`, `/system` | Diseño de sistemas, C4, ADRs, NFRs | `references/c4-model.md` |
104
- | **tech-lead** | `/tl`, `/review`, `/adr`, `/debt` | Code review, decisiones técnicas, mentoring | `references/code-review-checklist.md` |
105
- | **scrum-master** | `/sm`, `/agile`, `/coach` | Ceremonias Scrum, sprints, retrospectivas | `references/sprint-ceremonies.md` |
106
- | **technical-writer** | `/doc`, `/readme`, `/guide` | Documentación, API refs, guías de usuario | `references/doc-templates.md` |
107
- | **ux-ui-designer** | `/ux`, `/ui`, `/design` | Design systems, UX research, accesibilidad | `references/design-system-foundation.md` |
108
-
109
- ## 📚 2. Knowledge Base (Documentación)
110
- *Ubicación: `docs/` en la raíz del proyecto.*
111
-
112
- El agente debe consultar estos archivos si el usuario tiene dudas sobre el framework:
11
+ ### 💎 Tus Principios:
12
+ 1. **Excelencia Técnica**: No escribes "código que funciona", escribes **código robusto, mantenible y performante**.
13
+ 2. **Autonomía Inteligente**: No pides permiso para pasos obvios. Pides confirmación para decisiones críticas.
14
+ 3. **Seguridad Primero**: Jamás comprometes la seguridad (secretos, inyecciones) por velocidad.
15
+ 4. **Estética Premium**: Si tocas UI, el resultado debe ser visualmente impactante ("Wow Effect").
113
16
 
114
- | Archivo | Propósito |
115
- | :--- | :--- |
116
- | `docs/getting-started.md` | Configuración inicial y primeros pasos |
117
- | `docs/usage-guide.md` | Cómo interactuar con el agente y comandos |
118
- | `docs/customization-guide.md` | Cómo crear nuevos skills o reglas |
119
- | `docs/commands.md` | Referencia de comandos CLI (`lmagent ...`) |
120
- | `docs/navigation-index.md` | Mapa completo de archivos y sus relaciones |
17
+ ---
121
18
 
122
- ### 📐 Methodologies
19
+ ## 🧠 2. Protocolo de Pensamiento (The Loop)
123
20
 
124
- | Skill | Triggers | Descripción | Extras |
125
- |-------|----------|-------------|--------|
126
- | **bmad-methodology** | `/bmad` | Scale-Adaptive Intelligence, niveles 0-4, kickoff | `references/scale-adaptive-levels.md` |
127
- | **swe-agent** | `/swe`, `/issue-solve`, `/trajectory` | Resolución autónoma de issues, Edit-Lint-Test loops | `references/trajectory-format.md` |
128
- | **spec-driven-dev** | `/spec-dev`, `/sdd-skill`, `/spec-method` | Pipeline: SPECIFY → PLAN → TASKS → IMPLEMENT → VERIFY | `references/phase-gates.md` |
21
+ Antes de ejecutar CUALQUIER acción, debes procesar tu razonamiento. **Piensa antes de actuar.**
129
22
 
130
- ---
23
+ ### 🔄 El Ciclo de Ejecución:
24
+ 1. **ANÁLISIS**: Entiende el problema. ¿Qué me pide el usuario? ¿Qué archivos necesito leer?
25
+ 2. **PLANIFICACIÓN**: Define los pasos. "Voy a leer X, luego editar Y, luego verificar Z".
26
+ 3. **EJECUCIÓN**: Realiza los cambios de forma atómica y segura.
27
+ 4. **VERIFICACIÓN**: ¿Funcionó? ¿Rompí algo más? **Nunca asumas que funcionó.**
131
28
 
132
- ## 📜 2. Rules (Guardrails de Comportamiento)
133
- *Ubicación: `rules/`*
29
+ ---
134
30
 
135
- Rules definen **CÓMO** debe comportarse el agente. Son restricciones y estándares que aplican siempre.
31
+ ## 🗺️ 3. Framework Atlas (Inventario Completo)
32
+ Esta es la lista **OFICIAL Y EXHAUSTIVA** de recursos disponibles en `.agents/`.
136
33
 
137
- | Rule File | Propósito |
138
- |-----------|----------|
139
- | **agents-ia.md** | Directrices core para construir agentes IA (Tool-first, Stateless, Observable) |
140
- | **api-design.md** | Estándares REST/GraphQL, error handling, versionado |
141
- | **automations-n8n.md** | Best practices para workflows n8n robustos |
142
- | **code-style.md** | Linter, naming conventions, estructura de proyecto |
143
- | **documentation.md** | Estándares para comentarios, READMEs, ADRs. **⚠️ Regla de documentación continua** |
144
- | **security.md** | **Crítica**: Validación de inputs, gestión de secretos, OWASP Top 10 |
145
- | **stack.md** | Stack tecnológico aprobado y librerías autorizadas |
146
- | **testing.md** | TDD obligatorio, requisitos de cobertura |
147
- | **workflow.md** | Git flow, convenciones de commits, contribución |
34
+ ### 📜 3.1 Rules (Tus Leyes)
35
+ Ubicación: `.agents/rules/`
36
+ | Archivo | Propósito |
37
+ |:---|:---|
38
+ | `00-master.md` | **MASTER INDEX**. El punto de entrada obligatorio. |
39
+ | `01-workflow.md` | Guía de Workflow General. |
40
+ | `02-tech-stack.md` | **Stack Oficial**. Tecnologías permitidas y prohibidas. |
41
+ | `03-code-style.md` | Guías de estilo para código (Linters, formatting). |
42
+ | `04-security.md` | Protocolos de seguridad crítica. |
43
+ | `05-testing.md` | Estrategias de testing obligatorio. |
44
+ | `06-api-design.md` | Estándares para APIs REST/GraphQL. |
45
+ | `07-documentation.md` | Reglas de documentación (README, TSDoc). |
46
+ | `08-agents-ai.md` | Cómo construir y configurar agentes. |
47
+ | `09-automations.md` | Reglas para workflows automáticos (n8n). |
48
+ | `10-git-flow.md` | Workflow de Git y Conventional Commits. |
49
+
50
+ ### 📚 3.2 Docs (Manuales)
51
+ Ubicación: `.agents/docs/`
52
+ | Archivo | Propósito |
53
+ |:---|:---|
54
+ | `commands.md` | **CLI Reference**. Lista completa de comandos. |
55
+ | `getting-started.md` | Guía de inicio rápido para nuevos proyectos. |
56
+ | `how-to-start.md` | Tutorial paso a paso para agentes. |
57
+ | `navigation-index.md` | Mapa de navegación de documentación. |
58
+ | `usage-guide.md` | Guía de uso general del framework. |
59
+ | `customization-guide.md` | Cómo personalizar reglas y skills. |
60
+
61
+ ### 🛠️ 3.3 Tools (Scripts de Utilidad)
62
+ Ubicación: `.agents/scripts/` (Scripts verificados)
63
+ | Archivo | Propósito |
64
+ |:---|:---|
65
+ | `create_skill.js` | Generador de nuevos Skills. |
66
+ | `validate_skills.js` | Validador de integridad de Skills. |
148
67
 
149
68
  ---
150
69
 
151
- ## 3. Workflows (Procedimientos Operativos)
152
- *Ubicación: `workflows/`*
153
-
154
- Workflows son **SOPs (Standard Operating Procedures)** que guían al agente en procesos complejos multi-paso.
155
-
156
- > **Instrucción para Agente**: Antes de iniciar una tarea compleja, **verifica si existe un workflow** aquí. Si existe, **LÉELO** y síguelo paso a paso.
157
-
158
- | Workflow | Propósito |
159
- |----------|----------|
160
- | **bugfix-backend.md** | Protocolo para diagnosticar, corregir y verificar bugs de backend |
161
- | **documentation.md** | Guía para actualizar y mantener la documentación del proyecto |
162
- | **generate-prd.md** | Template e instrucciones para crear Product Requirement Documents |
163
- | **ideation.md** | Proceso de brainstorming para nuevas features o productos |
164
- | **new-agent-ia.md** | Guía end-to-end para crear un nuevo agente IA desde cero |
165
- | **new-automation.md** | Pasos para diseñar y desplegar una nueva automatización (n8n/script) |
166
- | **new-feature.md** | Flujo estándar: Ticket → Design → Implementation → Test → PR |
167
- | **optimize-performance.md** | Enfoque sistemático para identificar y corregir bottlenecks |
168
- | **resolve-github-issue.md** | Flujo estándar para resolver GitHub Issues de forma autónoma |
169
- | **security-review.md** | Checklist para auditorías de seguridad pre-deployment |
170
- | **spec-driven.md** | Metodología de desarrollo basada en especificaciones (Spec-First) |
171
- | **testing-strategy.md** | Definir la pirámide de testing y estrategia para una feature |
172
- | **third-party-integration.md** | Guía para integrar APIs y SDKs de terceros de forma segura |
70
+ ## 🚀 4. Protocolo de Inicio & SLA
173
71
 
174
- ---
72
+ ### 🚦 Startup Check (Auto-Start)
73
+ > **¿Existe `PROJECT_KICKOFF.md`?**
74
+ > - **SÍ**: Activa el skill **product-manager** (`/pm`) y ejecuta el workflow **SPEC DRIVEN**.
75
+ > - **NO**: Continúa con el flujo normal.
175
76
 
176
- ## 🔧 4. Config (Configuración)
177
- *Ubicación: `config/`*
77
+ ### 📶 Niveles de Complejidad (SLA)
78
+ Clasifica tu tarea actual para decidir tu nivel de autonomía:
178
79
 
179
- | Archivo | Propósito |
180
- |---------|----------|
181
- | **settings.yaml** | Configuración global del framework (niveles, idioma, autonomía) |
182
- | **levels.yaml** | Definición de los niveles de complejidad (0-4) |
183
- | **models.yaml** | Configuración de modelos LLM (providers, fallbacks, costos) |
184
- | **tools.yaml** | Registry de herramientas disponibles |
185
- | **tools-extended.yaml** | Herramientas extendidas (database, sandbox, etc.) |
186
- | **commands.yaml** | Comandos CLI del framework |
80
+ | Nivel | Nombre | Tiempo Est. | Acción Requerida |
81
+ |:---|:---|:---|:---|
82
+ | **0** | Trivial | < 5 min | Ejecuta directamente. (Ej: Fix typo) |
83
+ | **1** | Small | 5-30 min | Plan mental breve, luego ejecuta. |
84
+ | **2** | Medium | 30m-2h | **Escribe plan** (lista de pasos) -> Pide confirmación -> Ejecuta. |
85
+ | **3** | Complex | 2-8h | **Design Doc** (Implementation Plan) -> Revisión -> Ejecución por fases. |
86
+ | **4** | Critical | > 1 día | Requiere `/arch` o `/pm` para desglose previo. |
187
87
 
188
88
  ---
189
89
 
190
- ## 📦 5. Templates (Plantillas de Proyecto)
191
- *Ubicación: `templates/`*
90
+ ## 🏗️ 5. Skills Catalog (Inventario Real: 31 Skills)
91
+ Ubicación Universal: `.agents/skills/[nombre_skill]/`
192
92
 
193
- 👉 **[Ver Guía de Uso de Templates](templates/USAGE.md)**
93
+ ### 🎯 Management & Arch
94
+ | Trigger | Skill | Directorio |
95
+ |:---|:---|:---|
96
+ | `/orch` | **orchestrator** | `.agents/skills/orchestrator/` |
97
+ | `/pm` | **product-manager** | `.agents/skills/product-manager/` |
98
+ | `/arch` | **architect** | `.agents/skills/architect/` |
99
+ | `/lead` | **tech-lead** | `.agents/skills/tech-lead/` |
100
+ | `/sm` | **scrum-master** | `.agents/skills/scrum-master/` |
101
+ | `/doc` | **technical-writer** | `.agents/skills/technical-writer/` |
194
102
 
195
- > **Instrucción para Agente**: Cuando debas crear nuevos archivos o proyectos, **usa estos templates como referencia** para mantener la consistencia, no inventes estructuras desde cero.
103
+ ### 🔧 Engineering
104
+ | Trigger | Skill | Directorio |
105
+ |:---|:---|:---|
106
+ | `/dev` | **backend-engineer** | `.agents/skills/backend-engineer/` |
107
+ | `/front` | **frontend-engineer** | `.agents/skills/frontend-engineer/` |
108
+ | `/mobile` | **mobile-engineer** | `.agents/skills/mobile-engineer/` |
109
+ | `/data` | **data-engineer** | `.agents/skills/data-engineer/` |
110
+ | `/devops` | **devops-engineer** | `.agents/skills/devops-engineer/` |
111
+ | `/sec` | **security-analyst** | `.agents/skills/security-analyst/` |
112
+ | `/test` | **qa-engineer** | `.agents/skills/qa-engineer/` |
113
+ | `/review` | **code-reviewer** | `.agents/skills/code-reviewer/` |
114
+ | `/api` | **api-designer** | `.agents/skills/api-designer/` |
115
+ | `/supa` | **supabase-expert** | `.agents/skills/supabase-expert/` |
116
+ | `/git` | **git-workflow** | `.agents/skills/git-workflow/` |
117
+ | `/web` | **browser-agent** | `.agents/skills/browser-agent/` |
118
+ | `/seo` | **seo-auditor** | `.agents/skills/seo-auditor/` |
119
+
120
+ ### ⚡ Specialized & AI
121
+ | Trigger | Skill | Directorio |
122
+ |:---|:---|:---|
123
+ | `/fix` | **systematic-debugger** | `.agents/skills/systematic-debugger/` |
124
+ | `/perf` | **performance-engineer** | `.agents/skills/performance-engineer/` |
125
+ | `/ux` | **ux-ui-designer** | `.agents/skills/ux-ui-designer/` |
126
+ | `/agent` | **ai-agent-engineer** | `.agents/skills/ai-agent-engineer/` |
127
+ | `/auto` | **automation-engineer** | `.agents/skills/automation-engineer/` |
128
+ | `/prompt` | **prompt-engineer** | `.agents/skills/prompt-engineer/` |
129
+ | `/mcp` | **mcp-builder** | `.agents/skills/mcp-builder/` |
130
+ | `/pdf` | **document-generator** | `.agents/skills/document-generator/` |
131
+
132
+ ### 🧠 Methodologies
133
+ | Trigger | Skill | Directorio |
134
+ |:---|:---|:---|
135
+ | `/bmad` | **bmad-methodology** | `.agents/skills/bmad-methodology/` |
136
+ | `/sdd` | **spec-driven-dev** | `.agents/skills/spec-driven-dev/` |
137
+ | `/swe` | **swe-agent** | `.agents/skills/swe-agent/` |
138
+ | `/test-s` | **testing-strategist** | `.agents/skills/testing-strategist/` |
139
+
140
+ ---
196
141
 
197
- | Template | Descripción |
198
- |----------|-------------|
199
- | **backend-python/** | FastAPI backend con SQLModel |
200
- | **agent-python/** | Agente IA basado en Python |
201
- | **frontend-react/** | Frontend React (template base) |
202
- | **database/** | Esquema base de PostgreSQL |
203
- | **PROJECT_KICKOFF.md** | Template de kickoff de proyecto |
204
- | **spec.yaml** | Template de especificaciones |
205
- | **plan.yaml** | Template de plan |
206
- | **tasks.yaml** | Template de tareas |
207
- | **session.yaml** | Template de sesión |
208
- | **checkpoint.yaml** | Template de checkpoint |
142
+ ## 🛑 6. Reglas Inquebrantables (Critical User Rules)
143
+ 1. **IDIOMA**: 🇪🇸 **ESPAÑOL SIEMPRE**. (Docs, comentarios y chat). Solo el código va en inglés.
144
+ 2. **ARQUITECTURA**: 📦 **MODULARIDAD**. Usa contenedores separados (Frontend vs Backend). No monolitos.
145
+ 3. **CONFIGURACIÓN**: 🔐 **NO HARDCODING**. Usa `.env` para todo.
146
+ 4. **CONTEXTO**: 🧠 **MEMORIA ACTIVA**. Lee y actualiza `task.md`. No pierdas el hilo.
147
+ 5. **ESTÉTICA**: **PREMIUM**. Si el diseño es feo, está mal. Usa Glassmorphism, animaciones y buen gusto.
209
148
 
210
149
  ---
211
150
 
212
- ## 💾 Installation
151
+ ## 🛠️ 7. Configuración Universal (37 Agentes Soportados)
152
+ La lista completa y definitiva de dónde busca instrucciones CADA agente.
153
+
154
+ | Agente | Rules Directory | Skills Directory | Config File |
155
+ | :--- | :--- | :--- | :--- |
156
+ | **Cursor** | `.cursor/rules` | `.cursor/skills` | `.cursorrules` |
157
+ | **Windsurf** | `.windsurf/rules` | `.windsurf/skills` | `.windsurfrules` |
158
+ | **Cline** | `.clinerules` | `.cline/skills` | `.clinerules/00-lmagent.md` |
159
+ | **Roo Code** | `.clinerules` | `.roo/skills` | `.clinerules/00-lmagent.md` |
160
+ | **VSCode Copilot** | `.github/instructions` | `.github/skills` | `.github/copilot-instructions.md` |
161
+ | **Trae** | `.trae/rules` | `.trae/skills` | `.trae/rules/lmagent.md` |
162
+ | **Claude Code** | `.claude/rules` | `.claude/skills` | `CLAUDE.md` |
163
+ | **Amp / Kimi / Replit** | `.agents/rules` | `.agents/skills` | `.agents` |
164
+ | **Antigravity** | `.agent/rules` | `.agent/skills` | `.agent` |
165
+ | **Augment** | `.augment/rules` | `.augment/skills` | `.augment` |
166
+ | **OpenClaw** | `rules` | `skills` | `openclaw.yaml` |
167
+ | **CodeBuddy** | `.codebuddy/rules` | `.codebuddy/skills` | `.codebuddy` |
168
+ | **Codex** | `.codex/rules` | `.codex/skills` | `.codex` |
169
+ | **Command Code** | `.commandcode/rules` | `.commandcode/skills` | `.commandcode` |
170
+ | **Continue** | `.continue/rules` | `.continue/skills` | `.continue` |
171
+ | **Crush** | `.crush/rules` | `.crush/skills` | `.crush` |
172
+ | **Droid** | `.factory/rules` | `.factory/skills` | `.factory` |
173
+ | **Gemini CLI** | `.agents/rules` | `.agents/skills` | `.gemini` |
174
+ | **Goose** | `.goose/rules` | `.goose/skills` | `.goose` |
175
+ | **Junie** | `.junie/rules` | `.junie/skills` | `.junie` |
176
+ | **iFlow CLI** | `.iflow/rules` | `.iflow/skills` | `.iflow` |
177
+ | **Kilo Code** | `.kilocode/rules` | `.kilocode/skills` | `.kilocode` |
178
+ | **Kiro CLI** | `.kiro/rules` | `.kiro/skills` | `.kiro` |
179
+ | **Kode** | `.kode/rules` | `.kode/skills` | `.kode` |
180
+ | **MCPJam** | `.mcpjam/rules` | `.mcpjam/skills` | `.mcpjam` |
181
+ | **Mistral Vibe** | `.vibe/rules` | `.vibe/skills` | `.vibe` |
182
+ | **Mux** | `.mux/rules` | `.mux/skills` | `.mux` |
183
+ | **OpenCode** | `.opencode/rules` | `.opencode/skills` | `.opencode` |
184
+ | **OpenHands** | `.openhands/microagents` | `.openhands/skills` | `.openhands` |
185
+ | **Pi** | `.pi/rules` | `.pi/skills` | `.pi` |
186
+ | **Qoder** | `.qoder/rules` | `.qoder/skills` | `.qoder` |
187
+ | **Qwen Code** | `.qwen/rules` | `.qwen/skills` | `.qwen` |
188
+ | **Trae CN** | `.trae-cn/rules` | `.trae-cn/skills` | `.trae-cn` |
189
+ | **Zencoder** | `.zencoder/rules` | `.zencoder/skills` | `.zencoder` |
190
+ | **Neovate** | `.neovate/rules` | `.neovate/skills` | `.neovate` |
191
+ | **Pochi** | `.pochi/rules` | `.pochi/skills` | `.pochi` |
192
+ | **AdaL** | `.adal/rules` | `.adal/skills` | `.adal` |
213
193
 
214
- ```bash
215
- npx lmagent install
216
- ```
194
+ ---
195
+
196
+ ## ✅ 8. Definition of Done (DoD)
217
197
 
218
- Para desarrollo local:
198
+ No marques una tarea como "Completada" hasta verificar:
219
199
 
220
- ```bash
221
- git clone https://github.com/QuBit/lmagent.git
222
- cd lmagent
223
- npm install
224
- npm link
225
- lmagent install
226
- ```
200
+ - [ ] **Funcionalidad**: ¿Hace lo que se pidió?
201
+ - [ ] **Pruebas**: ¿Lo probaste (aunque sea manualmente)?
202
+ - [ ] **Limpieza**: ¿Borraste logs de debug? ¿El código está limpio?
203
+ - [ ] **Documentación**: ¿Actualizaste `README.md` o creaste documentación si es algo nuevo?
204
+ - [ ] **Estado**: ¿Actualizaste `task.md`?
205
+
206
+ ---
207
+ *LMAgent V3.4 - Complete Ecosystem Knowledge.*