Laboral Forge · Promptpal

Constructor visual de prompts para LLMs — sin backend, sin costos, 100% en tu browser.

Armá prompts profesionales con frameworks probados, modificadores rápidos, calidad heurística y biblioteca de plantillas. La IA es opcional y siempre BYOK.

App en vivo: https://martinmunozhr.github.io/promptpal/ · Manual de uso: MANUAL.md

Fork de facubelini/prompt-forge, adaptado a la identidad de Laboral Forge y extendido con el flujo Relay Gemini→Claude.

---

Features

Core (sin IA, sin costo)

• 8 frameworks de prompting con campos dinámicos: RTF, CRISPE, RISEN, CO-STAR, Chain of Thought, Relay Gemini→Claude, Custom (campos libres) e Imagen
• Relay Gemini→Claude — flujo de coding/arquitectura en 2 pasos: Gemini investiga y diseña (1M context + grounding), Claude Code ejecuta. Ver MANUAL.md §4
• Preview en vivo — panel lateral con el prompt ensamblado en tiempo real
• Plantillas pre-armadas por caso de uso, incluyendo una categoría Relay (arquitectura, refactor, debug, migración)
• Modificadores rápidos como chips clicables, con un grupo para coding: citá docs, formato ADR, diagrama Mermaid, plan por fases, tests primero, archivo por archivo
• Quality score (0–100) heurístico con checklist visual: rol definido, tarea clara, contexto presente, formato especificado, restricciones
• Historial y favoritos en localStorage con búsqueda por texto y filtro de favoritos
• Exportar: copiar al portapapeles, descargar como .md o .json, generar link compartible (prompt encodeado en query string)

Opciones IA — BYOK (Bring Your Own Key)

• Panel colapsable "Asistente IA" donde pegás tu API key de Anthropic
• Acciones: Mejorar prompt · Qué le falta · Generar ejemplos few-shot
• La key vive solo en tu localStorage — nunca toca un servidor intermediario

UX

• Dark mode por defecto, toggle a light

• Layout responsive con sidebars colapsables

• Atajos de teclado:

  Atajo	Acción
  ⌘K / Ctrl+K	Buscador de plantillas
  ⌘↵ / Ctrl+Enter	Copiar prompt
  ⌘S / Ctrl+S	Guardar en historial

---

Correr local

npm install
npm run dev

Abre en http://localhost:5173/promptpal/

Build de producción

npm run build
# Los archivos quedan en /dist

---

Deploy en GitHub Pages

El repo incluye un workflow de GitHub Actions (.github/workflows/deploy.yml) que buildea y deploya automáticamente a GitHub Pages en cada push a main.

Para activarlo:

1. Ve a Settings → Pages
2. En Source, seleccioná GitHub Actions
3. El próximo push a main dispara el deploy automáticamente

La base de Vite está configurada en vite.config.ts como /prompt-forge/ para que los assets funcionen correctamente bajo la ruta de GitHub Pages.

---

BYOK — Tu API key nunca sale del browser

Cuando configurás una API key de Anthropic en el panel "Asistente IA":

• Se guarda únicamente en localStorage de tu browser
• Las llamadas van directamente a api.anthropic.com desde tu browser usando el header anthropic-dangerous-direct-browser-access: true
• No existe ningún servidor intermediario — este proyecto es 100% frontend estático
• Podés borrar la key en cualquier momento con el botón "Borrar key"
• Siempre revisá el usage en tu dashboard de Anthropic

---

Decisiones de diseño

• Sin backend: toda la lógica corre en el cliente. Reduce complejidad y costos a cero.
• localStorage para persistencia: simple, sin dependencias, funciona offline.
• Quality score heurístico: no usa IA — evalúa presencia de secciones clave mediante keywords y longitud.
• Modelo por defecto: claude-sonnet-4-5 (buen balance costo/calidad para tareas de prompting).
• Base de Vite: /prompt-forge/ hardcodeada para GitHub Pages. Si deployás en otro dominio, cambiala en vite.config.ts.

---

Stack

• Vite + React + TypeScript
• Tailwind CSS v3
• lucide-react (iconos)
• clsx (utilidad de clases)
• Sin backend · Sin base de datos · Sin auth

---

Generado con Claude Code