matprompt

name	matprompt
description	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 handoffs. Usar cuando se invoque full team, se pida MATPROMT, o se necesiten prompts orientadores por agente.

MATPROMT — 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

1. 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).

2. 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.

3. 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.

4. 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 @file en Workspace: solo docs/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.

5. Output canónico

   • Bundle completo: sección nueva en docs/team/MATPROMT-FULL-RUN-PROMPTS.md o archivo docs/team/matprompt/MATPROMT-RUN-YYYY-MM-DD-runN.md (según convención del run).
   • Delta: mismo doc, subsección «RUN … — DELTA (fecha)».

---

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.