manu-alvarez/PromptCombo

> Consola offline para componer, ordenar y copiar prompts maestros con roles, agentes, subagentes, flujos, skills y plantillas.
PromptCombo es una aplicación web sin framework que convierte un catálogo modular de instrucciones en un prompt maestro determinista. El proyecto mantiene una arquitectura de código fuente separada por responsabilidades y genera un único dist/index.html autocontenido para uso offline.
## Alcance y límites
PromptCombo es un compositor determinista de prompts. No es un runtime de agentes ni una capa de ejecución.
Genera un documento de instrucciones; no llama a modelos ni ejecuta herramientas.
No aplica permisos, credenciales, aislamiento ni aprobaciones.
No conecta servidores MCP ni mantiene sesiones de modelo.
Los módulos agent y subagent son contratos textuales; no crean procesos.
Las 30 skills son procedimientos textuales; no son paquetes Agent Skills ejecutables.
El prompt compilado incluye límites de ejecución y autorización, pero su cumplimiento depende del runtime y de la revisión humana.
La aplicación verifica su propio código, sus datos y su build; no puede verificar el comportamiento de un modelo externo. Consulta Contratos y límites y la decisión de alcance.
## Qué incluye
| Grupo | Módulos |
| Prompts de inicio | 4 |
| Roles / asistentes | 7 |
| Flujos por fases | 3 |
| Agentes | 1 |
| Subagentes | 3 |
| Skills con procedimiento completo | 30 |
| Plantillas de archivos | 5 |
| Scaffoldings | 3 |
| Total | 56 |
Cada skill documenta ocho campos: propósito, cuándo usarla, entradas, procedimiento, restricciones, salida, criterios de aceptación y ejemplo. Su contenido es textual y no instala dependencias ni habilita herramientas.
## Funcionalidad
Catálogo con acordeones, búsqueda normalizada y fichas de detalle.
Constructor ordenable con Drag & Drop y controles accesibles de subida/bajada.
Variables dinámicas con sustitución determinista en el prompt compilado.
Contrato global de ejecución: límites de herramientas, autorización de acciones sensibles, datos no confiables y evidencia verificable.
Recetas de sesión: PWA desde cero, Auditoría exprés y Blueprint de producto.
Prevención de duplicados, eliminación con deshacer y reinicio reversible.
Copia con Clipboard API y fallback para contextos restringidos.
Descarga del prompt maestro como Markdown.
Persistencia local opcional de la composición con localStorage; el botón de guardado permite desactivarla y borrar los datos.
Estado en memoria cuando el navegador bloquea el almacenamiento: la aplicación sigue funcionando sin persistir.
Sin cookies, telemetría ni peticiones de red.
Accesibilidad: HTML semántico, skip link, foco visible, diálogo modal nativo, atajos / y Escape, aria-live, prefers-reduced-motion y forced-colors.
## Arquitectura
text
Datos (src/data)
Core (src/core) ── estado, índice, compilador, formato, DOM
UI (src/ui) ── catálogo, workbench, detalle, sesión, toasts, eventos
Entrada (src/main.js)
Build (esbuild) ── CSS + JS inline ──► dist/index.html
Datos: módulos inmutables y catálogo canónico.
Core: lógica independiente de la presentación; el compilador es una función pura.
UI: renderizado derivado del estado y eventos de usuario.