mcp-efficiency-engine 0.1.0

package/.github/prompts/caveman-debug.prompt.md

@@ -0,0 +1,13 @@
+# caveman-debug.prompt.md
+
+Objetivo: resolver debugging con salida corta y accionable.
+
+Formato obligatorio:
+- archivo:linea -> problema -> fix
+
+Checklist:
+1. Sintoma reproducible.
+2. Causa raiz probable.
+3. Cambio minimo para corregir.
+4. Validacion posterior al fix.
+5. Riesgo residual.

package/.github/prompts/caveman-help.prompt.md

@@ -0,0 +1,11 @@
+# caveman-help.prompt.md
+
+Mostrar comandos caveman del repo y cuando usar cada uno.
+
+Incluir:
+- nombre del comando
+- objetivo
+- ejemplo minimo
+
+Regla:
+- priorizar ejemplos cortos y ejecutables.

package/.github/prompts/caveman-review.prompt.md

@@ -0,0 +1,15 @@
+# caveman-review.prompt.md
+
+Hacer code review en formato caveman.
+
+Orden:
+1. Findings criticos
+2. Findings medios
+3. Riesgos de regresion
+
+Formato por finding:
+`archivo:linea -> problema -> fix`
+
+Reglas:
+- priorizar bugs reales sobre estilo
+- declarar gaps de test

package/.github/prompts/caveman-stats.prompt.md

@@ -0,0 +1,11 @@
+# caveman-stats.prompt.md
+
+Objetivo: mostrar estado rapido de eficiencia.
+
+Incluir:
+- tokens analizados
+- tokens ahorrados/suprimidos
+- alerts/warnings
+- estimacion de ahorro
+
+Si no hay datos, declarar gap y siguiente accion para obtenerlos.

package/.github/prompts/caveman.prompt.md

@@ -0,0 +1,11 @@
+# caveman.prompt.md
+
+Activar respuesta Caveman en este repo.
+
+Si no se especifica nivel, usar `full`.
+Niveles: `lite`, `full`, `ultra`.
+
+Estilo base:
+- directo
+- sin relleno
+- con validacion y riesgo/gap

package/.github/prompts/community.post.prompt.md

@@ -0,0 +1,14 @@
+# community.post.prompt.md
+
+Objetivo: generar contenido de comunidad basado en conocimiento real del repo.
+
+Flujo:
+1. Recuperar contexto en Graphify.
+2. Extraer 3-5 ideas verificables.
+3. Redactar pieza clara para audiencia objetivo.
+4. Cerrar con call-to-action.
+
+Reglas:
+- no inventar hechos
+- tono claro y util
+- version corta primero, extendida opcional

package/.github/prompts/dba.query-review.prompt.md

@@ -0,0 +1,15 @@
+# dba.query-review.prompt.md
+
+Objetivo: revisar consultas SQL y riesgos de rendimiento/seguridad.
+
+Flujo:
+1. Identificar tablas, joins y filtros.
+2. Detectar riesgos: full scan, cardinalidad, locks, anti-patterns.
+3. Proponer version mejorada.
+4. Incluir estrategia de validacion.
+
+Salida:
+- query actual
+- hallazgos
+- query propuesta
+- plan de prueba

package/.github/prompts/dev.fix-bug.prompt.md

@@ -0,0 +1,13 @@
+# dev.fix-bug.prompt.md
+
+Objetivo: corregir bug con cambio minimo y validacion real.
+
+Flujo:
+1. Explorar simbolos/flujo con CodeGraph.
+2. Determinar causa raiz.
+3. Aplicar fix minimo.
+4. Ejecutar validacion (tests/lint/comando relevante).
+5. Reportar riesgo residual.
+
+Formato de salida:
+Diagnostico -> accion -> validacion -> riesgo/gap

package/.github/prompts/frontend.code.prompt.md

@@ -0,0 +1,13 @@
+# frontend.code.prompt.md
+
+Objetivo: implementar o corregir codigo frontend con cambio minimo, preservando UX existente y validacion real.
+
+Flujo:
+1. Explorar componentes, rutas y estado afectados con CodeGraph.
+2. Determinar causa raiz o alcance de la feature solicitada.
+3. Aplicar cambio minimo en UI/estado/eventos.
+4. Ejecutar validacion relevante (tests/lint/build/comando de frontend).
+5. Reportar riesgo residual y deuda UX pendiente fuera de scope.
+
+Formato de salida:
+Diagnostico -> accion -> validacion -> riesgo/gap

package/.github/prompts/legacy.impact-analysis.prompt.md

@@ -0,0 +1,14 @@
+# legacy.impact-analysis.prompt.md
+
+Objetivo: analizar impacto de cambios en codigo legacy/multi-repo.
+
+Flujo:
+1. Identificar simbolo o area a cambiar.
+2. Mapear dependencias y flujos afectados con GitNexus.
+3. Clasificar riesgo (alto/medio/bajo).
+4. Proponer mitigaciones y pruebas.
+
+Salida:
+- blast radius
+- riesgos
+- plan seguro de cambio

package/.github/prompts/project.kickoff-analysis.prompt.md

@@ -0,0 +1,51 @@
+# project.kickoff-analysis.prompt.md
+
+Objetivo: analizar un proyecto {projects/} desde cero, seleccionar el agente y motor correctos segun la necesidad real, y dejar un arranque operativo con evidencias, gaps y siguientes pasos.
+
+Entrada minima:
+- objetivo del analisis
+- path o nombre del proyecto/boost
+- tipo de fuente esperado (code | technical-docs | corporate-docs | snapshot) si ya se conoce
+- restriccion de salida o artefacto esperado
+
+Flujo:
+1. Hacer onboarding profundo en la primera pasada y recuperar el maximo contexto verificable relevante del proyecto.
+2. Detectar dominio, intencion y necesidad dominante antes de elegir boost, agente y motor.
+3. Seleccionar un unico motor principal segun contrato del repo:
+	- backend/frontend -> CodeGraph
+	- legacy/multi-repo -> GitNexus
+	- dba/ux-ui/rag-local -> Graphify
+	- rag-azure -> Azure RAG Builder
+	- snapshot/export -> Repomix
+4. Aplicar Always-On completo:
+	- token-saver: always_on
+	- caveman: always_on
+	- memory: always_on
+	- learning: always_on
+	- HITL: auto si hay riesgo alto
+5. Analizar el proyecto usando los boosts acorde a las necesidades reales, no por afinidad previa ni por explorar de mas.
+6. Identificar:
+	- que funciona ya
+	- que falta para operar
+	- que boost/agente cubre cada gap
+	- riesgos, bloqueos y dependencias
+7. Si aplica a un proyecto bajo `projects/`, guardar los artefactos del analisis en `projects/<nombre-proyecto>/analysis_mcpee/`.
+
+Salida esperada:
+Diagnostico -> accion -> validacion -> riesgo/gap
+
+Checklist de salida:
+- agente recomendado
+- motor recomendado
+- boosts implicados y por que
+- evidencias concretas usadas
+- gaps sin grounding suficiente
+- plan corto de siguientes pasos
+- artefactos a generar o actualizar
+
+Reglas:
+- No usar varios motores sin necesidad.
+- No hacer discovery abierto si ya hay una hipotesis operativa suficiente.
+- Priorizar cambios minimos, rutas verificables y evidencia precisa.
+- Si el proyecto define agentes, skills o prompts locales, tratarlos como contrato operativo.
+- Si falta contexto critico, pedir solo el dato minimo imprescindible.

package/.github/prompts/rag.knowledge-answer.prompt.md

@@ -0,0 +1,13 @@
+# rag.knowledge-answer.prompt.md
+
+Objetivo: responder preguntas tecnicas con rag-local y Graphify.
+
+Flujo:
+1. Recuperar solo nodos/chunks relevantes.
+2. Sintetizar respuesta enfocada a la pregunta.
+3. Mostrar evidencia o declarar gap.
+
+Reglas:
+- no inventar informacion
+- no abrir contexto completo si no hace falta
+- priorizar precision sobre longitud

package/.github/prompts/token-saver-review.prompt.md

@@ -0,0 +1,14 @@
+# token-saver-review.prompt.md
+
+Objetivo: auditar uso de contexto y reducir coste sin perder grounding.
+
+Checklist:
+1. Detectar retrieval excesivo.
+2. Detectar salidas largas ignoradas.
+3. Proponer recortes por prioridad.
+4. Mantener fuentes criticas cuando la tarea lo exige.
+
+Salida:
+- desperdicio detectado
+- accion de ahorro recomendada
+- riesgo por recorte

package/.github/prompts/ux-ui.review.prompt.md

@@ -0,0 +1,14 @@
+# ux-ui.review.prompt.md
+
+Objetivo: revisar y gobernar UX/UI con foco en consistencia, accesibilidad y design intent.
+
+Flujo:
+1. Recuperar contexto de guias/patrones de UX/UI.
+2. Detectar hallazgos por severidad (critico, alto, medio, bajo).
+3. Proponer acciones concretas con impacto esperado.
+4. Cerrar con validacion y riesgos/gaps pendientes.
+
+Reglas:
+- no inventar criterios ni fuentes
+- priorizar findings verificables
+- evitar recomendaciones vagas

package/.github/pull_request_template.md

@@ -0,0 +1,71 @@
+<!-- 
+  MCP Efficiency Engine — Pull Request Template
+  Llena todas las secciones antes de enviar el PR.
+-->
+
+## Descripción
+
+<!-- Explica qué cambios hace este PR y por qué. -->
+
+## Tipo de cambio
+
+- [ ] 🐛 Bugfix (corrección sin breaking changes)
+- [ ] ✨ Feature (nueva funcionalidad)
+- [ ] 📚 Docs (documentación)
+- [ ] ♻️ Refactor (mejora sin cambios funcionales)
+- [ ] ⚙️ Chore (actualizaciones tooling/config)
+
+## Checklist de cambios
+
+### Código y specs
+
+- [ ] Los cambios cumplen con `specs/*.spec.md` aplicables
+- [ ] Todos los tests pasan: `py -3 .\scripts\intake\run-routing-evals.py`
+- [ ] Se ejecutó `validate-context.ps1` sin errores
+- [ ] Se ejecutó `compileall` en scripts sin errores
+- [ ] Cambios sin breaking changes o están documentados
+
+### Seguridad y políticas
+
+- [ ] Sin secretos, tokens ni credenciales reales
+- [ ] Alineado con `policies/security-policy.md` si aplica
+- [ ] Sin cambios en RBAC o permisos sin justificación
+
+### Documentación
+
+- [ ] README o docs actualizados si hay cambios públicos
+- [ ] Cambios en `specs/` incluyen sección `## Validación mínima`
+- [ ] Scripts nuevos incluyen docstring y ayuda
+
+### Validaciones de specs
+
+Si aplica a tu cambio, ejecuta:
+
+```bash
+# Routing y arquitectura
+py -3 .\scripts\intake\run-routing-evals.py
+
+# Seguridad
+py -3 .\scripts\intake\validate-security.py
+
+# Database (si aplica)
+py -3 .\scripts\intake\validate-database-routing.py
+
+# RAG local (si aplica)
+py -3 .\scripts\intake\validate-rag-routing.py
+
+# Contexto general
+pwsh -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup\validate-context.ps1
+```
+
+## Enlaces y referencias
+
+<!-- Links a issues, specs, arquitectura o decisiones relevantes. -->
+
+## Cambios destacados
+
+<!-- Puntos clave que deben revisar: comportamiento, breaking changes, rendimiento, etc. -->
+
+---
+
+**Nota:** Este PR se cierra automáticamente si no pasa los evals. Asegúrate de ejecutar todas las validaciones localmente antes de enviar.

package/.github/skills/ahorro-tokens/SKILL.md

@@ -0,0 +1,36 @@
+# Skill: ahorro-tokens
+
+## Objetivo
+
+Aplicar ahorro de tokens sin perder calidad, evidencia ni trazabilidad.
+
+## Cuándo usar
+
+- Cuando una tarea se vuelve larga por discovery abierto.
+- Cuando hay demasiadas lecturas de contexto irrelevante.
+- Cuando hay que bajar coste sin bajar calidad de salida.
+- Cuando se pide plan/ejecucion y se mezclan en una sola interaccion.
+
+## Reglas operativas
+
+1. Scope quirurgico: acotar archivos/simbolos antes de explorar.
+2. Sesiones cortas: 1 problema concreto = 1 sesion.
+3. CLI primero: usar herramientas deterministas antes de generar boilerplate.
+4. Separar fases: plan (alto valor) y ejecucion (cambio atomico).
+5. Salida compacta: diagnostico -> accion -> validacion -> riesgo/gap.
+
+## Mapeo en este repo
+
+Fuente canonica:
+- `autodocs/site/guides/00-Ahorro_Tokens.md`
+
+Soporte always-on:
+- `.github/skills/token-saver/SKILL.md`
+- `.github/skills/caveman-mode/SKILL.md`
+- `.github/instructions/always-on-optimization.instructions.md`
+
+## Validacion minima
+
+1. `pwsh -ExecutionPolicy Bypass -File .\scripts\setup\validate-context.ps1`
+2. `py -3 .\scripts\intake\run-routing-evals.py`
+3. Revisar `observability/evals/routing-eval-report.json` (cases_failed = 0)

package/.github/skills/azure-rag-enterprise/SKILL.md

@@ -0,0 +1,24 @@
+# Azure RAG Enterprise Skill
+
+## Purpose
+
+Answer corporate-document questions with grounding and mandatory evidence.
+
+## When To Use
+
+- source_type is `corporate-docs`
+- domain is `azure-rag`
+- user asks for policy, SLA, contract, or official document truth
+
+## Workflow
+
+1. Retrieve only relevant chunks/sources.
+2. Prioritize official and latest sources.
+3. Produce concise answer with citations/evidence references.
+4. Declare gaps when evidence is missing.
+
+## Guardrails
+
+- Never fabricate citations.
+- Keep Token Saver and Caveman enabled.
+- Prefer evidence-first profile.

package/.github/skills/backend-coding/SKILL.md

@@ -0,0 +1,24 @@
+# Backend Coding Skill
+
+## Purpose
+
+Implement and validate code changes in single-repo backend tasks.
+
+## When To Use
+
+- bug-fix
+- refactor
+- feature changes in backend code domain
+
+## Workflow
+
+1. Explore affected symbols/flow.
+2. Apply minimal safe edits.
+3. Run relevant validation (tests/lint/build).
+4. Report diagnostics, validation and residual risks.
+
+## Guardrails
+
+- Preserve public API unless requested.
+- Avoid unrelated formatting changes.
+- Keep Token Saver and Caveman enabled.

package/.github/skills/cavecrew/SKILL.md

@@ -0,0 +1,17 @@
+# Cavecrew Skill — Local
+
+## Propósito
+
+Delegar trabajo a subagentes con salida comprimida para ahorrar contexto.
+
+## Trigger
+
+- "use cavecrew"
+- "delegate to subagent"
+- "spawn investigator/builder/reviewer"
+
+## Ruteo
+
+- investigator: localizar código/contexto
+- builder: cambios pequeños (1-2 archivos)
+- reviewer: revisión de diff

package/.github/skills/caveman/SKILL.md

@@ -0,0 +1,25 @@
+# Caveman Skill — Local
+
+## Estado
+
+Disponible como capacidad local del repositorio.
+
+## Trigger
+
+- `/caveman`
+- "caveman mode"
+- "usa caveman"
+- "menos tokens"
+
+## Comportamiento
+
+- Aplica formato conciso tipo `Diagnóstico -> Acción -> Validación -> Riesgo/GAP`.
+- Mantiene precisión técnica.
+- Mantiene términos de código y errores exactos.
+
+## Niveles
+
+- `lite`
+- `full` (default)
+- `ultra`
+- `evidence-first` cuando se requiere grounding.

package/.github/skills/caveman-commit/SKILL.md

@@ -0,0 +1,15 @@
+# Caveman Commit Skill — Local
+
+## Propósito
+
+Generar mensajes de commit concisos en formato Conventional Commits.
+
+## Trigger
+
+- `/caveman-commit`
+- "mensaje commit caveman"
+
+## Reglas
+
+- Subject <= 50 chars.
+- Incluir body solo si el porqué no es obvio.

package/.github/skills/caveman-compress/SKILL.md

@@ -0,0 +1,14 @@
+# Caveman Compress Skill — Local
+
+## Propósito
+
+Comprimir archivos de memoria/documentación manteniendo sustancia técnica.
+
+## Trigger
+
+- `/caveman-compress <file>`
+- "compress memory file"
+
+## Regla
+
+Crear backup `<file>.original.md` antes de sobrescribir.

package/.github/skills/caveman-help/SKILL.md

@@ -0,0 +1,19 @@
+# Caveman Help Skill — Local
+
+## Propósito
+
+Mostrar comandos caveman disponibles y su uso en este repositorio.
+
+## Trigger
+
+- `/caveman-help`
+- "caveman help"
+
+## Salida esperada
+
+- Lista corta de comandos:
+  - `/caveman [lite|full|ultra]`
+  - `/caveman-review`
+  - `/caveman-commit`
+  - `/caveman-stats`
+  - `/caveman-compress <file>`

package/.github/skills/caveman-mode/SKILL.md

@@ -0,0 +1,43 @@
+# Caveman Mode Skill — Always On
+
+## Estado
+
+Siempre activo por defecto.
+
+## Propósito
+
+Reducir verbosidad y acelerar interacción.
+
+## Formato base
+
+```txt
+Diagnóstico:
+Acción:
+Validación:
+Riesgo/GAP:
+```
+
+## Niveles
+
+### Lite
+
+- Frases breves.
+- Bullets claros.
+- Útil para arquitectura, RAG y formación ligera.
+
+### Full
+
+- Máxima concisión.
+- Útil para debugging, CLI y coding loops.
+
+### Evidence-first
+
+- Conciso, pero conserva fuentes/citas.
+- Útil para Azure RAG Builder.
+
+## Reglas
+
+- No eliminar fuentes necesarias.
+- No eliminar pasos críticos.
+- Si el usuario pide detalle, ampliar sin perder estructura.
+- Si el usuario pide formación, usar Lite/Didactic, no Full.

package/.github/skills/caveman-review/SKILL.md

@@ -0,0 +1,16 @@
+# Caveman Review Skill — Local
+
+## Propósito
+
+Revisión de código ultracompacta y accionable.
+
+## Trigger
+
+- `/caveman-review`
+- "review en caveman"
+
+## Formato
+
+Una línea por finding:
+
+`archivo:linea -> problema -> fix`

package/.github/skills/caveman-stats/SKILL.md

@@ -0,0 +1,13 @@
+# Caveman Stats Skill — Local
+
+## Propósito
+
+Mostrar consumo de tokens y ahorro estimado para la sesión.
+
+## Trigger
+
+- `/caveman-stats`
+
+## Nota
+
+Cuando no hay telemetría disponible, reportar gap explícito.

package/.github/skills/community-content/SKILL.md

@@ -0,0 +1,22 @@
+# Community Content Skill
+
+## Purpose
+
+Create educational/community-facing content grounded in repo knowledge.
+
+## When To Use
+
+- blog/social post drafts
+- learning summaries
+- release highlights with technical grounding
+
+## Workflow
+
+1. Extract 3-5 validated insights.
+2. Tailor narrative to audience level.
+3. Produce concise draft and optional extended version.
+
+## Guardrails
+
+- Avoid unverifiable claims.
+- Prefer clarity and practical takeaways.

package/.github/skills/database-analysis/SKILL.md

@@ -0,0 +1,23 @@
+# Database Analysis Skill
+
+## Purpose
+
+Review SQL/schema/procedure questions with performance and safety focus.
+
+## When To Use
+
+- SQL query reviews
+- schema impact analysis
+- procedure tuning and risk checks
+
+## Workflow
+
+1. Identify joins, filters and cardinality risks.
+2. Flag anti-patterns and indexing gaps.
+3. Propose improved query/schema actions.
+4. Provide validation plan and rollback note.
+
+## Guardrails
+
+- Prioritize correctness over micro-optimization.
+- Explicitly call out assumptions and missing stats.

package/.github/skills/dev-coding/SKILL.md

@@ -0,0 +1,24 @@
+# Dev Coding Skill
+
+## Purpose
+
+Implement and validate code changes in single-repo development tasks.
+
+## When To Use
+
+- bug-fix
+- refactor
+- feature changes in code domain
+
+## Workflow
+
+1. Explore affected symbols/flow.
+2. Apply minimal safe edits.
+3. Run relevant validation (tests/lint/build).
+4. Report diagnostics, validation and residual risks.
+
+## Guardrails
+
+- Preserve public API unless requested.
+- Avoid unrelated formatting changes.
+- Keep Token Saver and Caveman enabled.

package/.github/skills/frontend-coding/SKILL.md

@@ -0,0 +1,24 @@
+# Frontend Coding Skill
+
+## Purpose
+
+Implement and validate code changes in single-repo frontend tasks.
+
+## When To Use
+
+- bug-fix in frontend code
+- UI feature implementation
+- refactor in components, routes, or client-side state
+
+## Workflow
+
+1. Explore affected components/routes/state.
+2. Apply minimal safe edits.
+3. Run relevant validation (tests/lint/build).
+4. Report diagnostics, validation and residual risks.
+
+## Guardrails
+
+- Preserve existing UX contract unless user asks for redesign.
+- Avoid unrelated formatting changes.
+- Keep Token Saver and Caveman enabled.