matprompt
MATPROMT — Optimización de prompts y flujos de trabajo para el equipo BMC. Genera instrucciones específicas por rol para full team run, refina prompts ante tareas nuevas durante el run, y mejora hando
SKILL.md.cursor/skills/matprompt/SKILL.md
GitHubMATPROMT — Prompt & workflow optimization (BMC/Panelin)
Marca: MATPROMT (rol MATPROMT en PROJECT-TEAM-FULL-COVERAGE.md §2).
Propósito: Dar al equipo completo instrucciones específicas, accionables y alineadas al objetivo del run, mejorar flujos de trabajo de cada agente y del conjunto, y re-optimizar prompts cuando aparecen tareas nuevas en mitad del run.
When to use
- Usuario u Orquestador dice: «Invoque full team», «Equipo completo», «MATPROMT», «generar prompts por rol».
- Paso 0a del orquestador: emitir bundle de prompts para el run actual.
- Durante el run: scope creep, bloqueo, nueva prioridad de Matias → consultar MATPROMT para regenerar instrucciones sólo para los roles afectados (delta prompts).
- Antes de un sprint grande: preflight de prompts en
docs/team/MATPROMT-FULL-RUN-PROMPTS.md.
Core responsibilities
Preflight (planificación)
- Leer:
docs/team/PROJECT-STATE.md,docs/team/PROMPT-FOR-EQUIPO-COMPLETO.md, agenda del run, objetivos explícitos del usuario. - Leer tabla de roles §2 en
PROJECT-TEAM-FULL-COVERAGE.md(N dinámico). - Aplicar Run Scope Gate:
docs/team/RUN-SCOPE-GATE.md— incorporar en el bundle la cabecera «Run Scope Matrix» (Profundo / Ligero / N/A por rol + justificación) alineada al borrador del Orquestador (paso 0). Para Ligero y N/A, los prompts deben exigir solo cierre breve, no auditorías completas. - Producir por cada rol §2: objetivo, lecturas obligatorias, entregables, criterios de aceptación, anti-patrones, handoff esperado (acotados al modo de la matriz).
- Leer:
Durante el run (re-planificación ligera)
- Si entra una tarea nueva o cambia el orden de prioridad: emitir MATPROMT-DELTA (solo roles tocados) — no reescribir todo el bundle salvo que el Orquestador lo pida.
Calidad del prompt
- Prompts deben ser SMART: específicos, medibles en términos de artefactos, alcanzables en el run, relevantes al dominio BMC, acotados en tiempo.
- Referenciar rutas de repo concretas (
docs/…,server/…,src/…) cuando aplique. - No inventar sheet IDs ni secretos; usar
config/process.env/ placeholders.
Micro-framework (Workspace-style; obligatorio en preflight y en cada bundle)
Inspiración: guías tipo Gemini for Google Workspace — Persona · Task · Context · Format; tareas con verbo explícito; prompts demasiado cortos suelen fallar (en producto, los mejores suelen llevar ~21 palabras con contexto; aquí los bundles son más largos pero el principio es el mismo: no sub-especificar).- Power prompt (opcional): Si el objetivo del usuario u Orquestador es una sola frase ambigua, añadir al inicio del bundle (o del delta) una línea: «Make this a power prompt: [texto del usuario]» — es decir, una reformulación canónica con task + contexto mínimo antes de que los roles ejecuten.
- Desambiguación: Incluir subsección «Preguntas para Matias / Orquestador» cuando falte alcance, prioridad o fuente de verdad — mismo espíritu que What questions do you have for me that would help you provide the best output? Cerrar respuestas antes de pasos caros.
- Restricciones: Por rol, donde aplique, fijar formato (tabla, bullets máx., secciones), tono (formal, técnico, memo), y fuentes obligatorias / grounding (equivalente a
@fileen Workspace: solodocs/team/…,planilla-inventory,MAPPER-PRECISO, etc.). - Una tarea por prompt pesado: Si un rol debe hacer varias cosas grandes, partir en bullets o pasos secuenciales (break it up), no un solo párrafo indigesto.
Output canónico
- Bundle completo: sección nueva en
docs/team/MATPROMT-FULL-RUN-PROMPTS.mdo archivodocs/team/matprompt/MATPROMT-RUN-YYYY-MM-DD-runN.md(según convención del run). - Delta: mismo doc, subsección «RUN … — DELTA (fecha)».
- Bundle completo: sección nueva en
Template por rol (obligatorio en cada bundle)
Para cada rol §2 que participe:
### [Rol] — Prompt orientador
- **Objetivo del rol en este run:**
- **Leer antes de actuar:**
- **Hacer (máx. 5 bullets):**
- **Restricciones (formato / tono / fuentes obligatorias):** (si aplica; si no, «N/A»)
- **Entregables:**
- **No hacer (anti-patrones):**
- **Handoff a:** (otros roles / Matias)
Cabecera del bundle (una vez por run): cuando el objetivo sea ambiguo, incluir Power prompt (reformulación canónica del objetivo) y/o Preguntas para Matias / Orquestador (lista breve) antes de las subsecciones por rol.
Interaction with Orchestrator
- Orquestador invoca MATPROMT en paso 0a (inmediatamente después de leer estado y PROMPT, antes o junto con 0b Parallel/Serial según tabla actualizada del orquestador).
- Si Parallel/Serial propone un orden alternativo, MATPROMT ajusta los prompts para reflejar dependencias (ej. Mapping antes de Contract).
References
| Doc | Uso |
|---|---|
docs/team/MATPROMT-FULL-RUN-PROMPTS.md |
Plantillas + histórico de bundles |
docs/team/PROJECT-TEAM-FULL-COVERAGE.md §2 |
Lista de roles |
docs/team/PROMPT-FOR-EQUIPO-COMPLETO.md |
Agenda y próximos prompts |
.cursor/agents/matprompt-agent.md |
Definición del agente Cursor |
Disclosure
MATPROMT no ejecuta código ni edita planillas; solo mejora instrucciones y flujos. La ejecución la hace cada rol con su skill.