Introducción

PromptTree es la infraestructura definitiva para el ciclo de vida de tus prompts.

A medida que los modelos de lenguaje (LLMs) se vuelven más complejos, el "Prompt Engineering" ha pasado de ser un simple campo de texto a requerir prácticas serias de ingeniería de software. Necesitas control de versiones, entornos de prueba y flujos de colaboración.

En lugar de guardar tus prompts en hojas de cálculo o documentos de texto dispersos, PromptTree te ofrece un entorno estructurado basado en los principios de Git. Cada cambio se registra (commit), cada versión se congela inmutablemente, y cualquier miembro de tu equipo puede contribuir de forma segura.

Primeros Pasos

  1. Crea una cuenta: Únete a PromptTree de forma gratuita.
  2. Crea un Repositorio: Haz clic en el botón de "Nuevo Repositorio" en la barra de navegación. Dale un nombre único (slug) y una descripción.
  3. Visibilidad: Decide si tu repositorio será Público (abierto a la comunidad) o Privado (solo para ti).
  4. Inicializa: Tu repositorio se creará con un archivo `prompt.md` vacío, listo para ser editado.

El Ciclo de Vida (Workflow)

Trabajar en PromptTree es similar a trabajar con código fuente:

  • Edición Markdown: Escribe tus instrucciones del sistema utilizando sintaxis Markdown. Esto te permite estructurar secciones, reglas y ejemplos de manera legible.
  • Variables (Inputs): Utiliza corchetes dobles {{ variable }} para definir variables dinámicas dentro de tu prompt.
  • Playground: Antes de guardar, usa el Playground integrado para rellenar tus variables y probar el prompt en tiempo real con integración segura de **OpenAI**, **Google Gemini** y **Anthropic Claude** (procesado del lado del servidor para evitar bloqueos de seguridad de CORS).
  • Commits: Cuando estés satisfecho, realiza un "Commit" con un mensaje descriptivo. Esto generará un hash único (SHA-256) congelando esa versión exacta.

Colaboración

La Inteligencia Artificial se construye en comunidad.

  • Tokens: Dale una moneda de oro 🪙 a los repositorios que encuentres útiles o inspiradores. Es la forma principal de reconocer calidad en la plataforma. Ver sección Sistema de Tokens más abajo.
  • Issues: Abre hilos de discusión para sugerir mejoras, reportar alucinaciones del modelo o debatir técnicas de inyección.
  • Pull Requests: Propone cambios al prompt de otro repositorio. El dueño puede revisar tu propuesta y fusionarla.
  • Bifurcaciones (Forks): ¿Encontraste un buen prompt público de otro creador pero quieres adaptarlo a tu caso de uso? Haz clic en el botón Bifurcar / Fork en la cabecera del repositorio para crear una copia exacta e independiente bajo tu perfil. Esto te permitirá editar el prompt, registrar tus propios commits y mantener un enlace de origen al repositorio padre (visualizado como "bifurcado de").

Sistema de Tokens

🪙 Un Token es la unidad de reconocimiento de PromptTree. Es la forma en que la comunidad vota por los prompts que considera más útiles, mejor escritos o más innovadores.

¿Cómo funciona?

  • Un token por usuario por repositorio. Cada cuenta solo puede dar un token a cada repositorio. No es posible acumular votos de la misma persona.
  • Reversible. Puedes retirar tu token en cualquier momento volviendo al repositorio y haciendo clic en el botón de la moneda dorada. El contador bajará automáticamente.
  • Solo para visitantes. El dueño de un repositorio no puede darse tokens a sí mismo. El botón de token es invisible cuando estás viendo tu propio repositorio.

¿Cómo dar un Token?

  1. Entra al repositorio que quieres reconocer.
  2. En la cabecera del repositorio, busca el botón de moneda dorada 🪙 con el número de tokens actuales.
  3. Haz clic en él. El botón se iluminará en amarillo y el contador subirá en 1.
  4. Para retirar tu token, haz clic nuevamente. El botón volverá a su estado original.

¿Para qué sirven los Tokens?

  • Ranking de calidad. Los repositorios con más tokens aparecerán destacados en la sección de Explorar, facilitando que la comunidad descubra los mejores prompts.
  • Reputación del autor. El total de tokens recibidos en todos tus repositorios contribuye a tu reputación como Prompt Engineer dentro de la plataforma.
  • Signal de calidad. Un prompt con muchos tokens es una señal de que otros ingenieros lo han probado y consideran que funciona bien.

Playground / IA

La plataforma cuenta con un Playground Interactivo integrado que te permite probar la efectividad de tus prompts en tiempo real utilizando modelos de Inteligencia Artificial líderes.

Modelos Soportados

El Playground es flexible y compatible con los modelos más recientes de los principales proveedores. Puedes realizar pruebas utilizando las APIs de los siguientes proveedores configurando tus credenciales de acceso personales:

  • OpenAI: Ejecuta prompts con los modelos de última generación de la serie 5 y razonamiento profundo (como gpt-5.5, gpt-5.5-pro, gpt-5.4 y gpt-instant) así como modelos anteriores (gpt-4o).
  • Google Gemini: Ejecuta prompts con modelos de tercera generación con mejoras masivas en velocidad y multimodalidad (como gemini-3.1-pro, gemini-3.0-pro, gemini-3.5-flash y gemini-omni).
  • Anthropic Claude: Ejecuta prompts con la familia Claude 3 y 3.5 (como claude-3-5-sonnet, claude-3-opus y claude-3-haiku).

* Nota: La plataforma está diseñada para admitir dinámicamente nuevos lanzamientos a medida que los proveedores actualizan sus APIs oficiales y endpoints.

¿Cómo se ejecuta el prompt?

  1. Bóveda Criptográfica local (Vault): Para tu total seguridad, tus API Keys se almacenan de forma **cifrada** en tu propio navegador. Al configurar tus claves en Ajustes > Integración de IA, definirás una **Contraseña de Bóveda (Master Passphrase)**. Esta contraseña cifra tus datos y jamás sale de tu computadora.
  2. Desbloqueo en memoria RAM: Cuando usas el Playground, se te pedirá ingresar tu contraseña para descifrar temporalmente tus claves de API. Éstas permanecerán únicamente en la memoria RAM volátil de la sesión.
  3. Expiración por Inactividad: Si la pestaña permanece inactiva por **15 minutos**, la sesión se cerrará de forma automática y las claves se purgarán de la memoria RAM para evitar que queden expuestas.
  4. Ejecución Segura: Al hacer clic en "Ejecutar", las llaves descifradas en memoria se transmiten de forma segura mediante HTTPS a nuestras pasarelas de proxy seguro, las cuales procesan la llamada de servidor a servidor para eludir bloqueos de CORS del navegador (como los de Anthropic Claude) y entregarte la respuesta en tiempo real.

Seguridad y Privacidad de Nivel Bancario: Tus credenciales y contraseñas de bóveda nunca se almacenan en nuestras bases de datos ni servidores. Nuestras pasarelas únicamente actúan como puente transitorio cifrado y no guardan registros de tus claves ni de las consultas realizadas.

Integración / API

¡API Externa en producción! Ya puedes consumir tus prompts programáticamente de forma segura utilizando la API Serverless (Supabase Edge Functions).

PromptTree funciona como tu CMS de Prompts (Prompt CMS). Puedes descargar el contenido de tus prompts públicos o privados directamente en tu código para integrarlos en pipelines de IA sin tener que redesplegar tu aplicación.

1. Generar un Token (PAT)

Para consultar prompts privados, primero debes generar un Token de Acceso Personal (PAT) en la pestaña de Ajustes > Tokens. Envía este token en la cabecera HTTP de tus peticiones:

Authorization: Bearer ph_pat_tu_token_aqui
Nota de seguridad: Por motivos de seguridad, los tokens se almacenan cifrados en nuestra base de datos utilizando el algoritmo hash SHA-256. Tu token original solo se mostrará una vez al momento de crearlo. Asegúrate de copiarlo y guardarlo en un lugar seguro; si lo pierdes, no podremos recuperarlo y tendrás que revocarlo para generar uno nuevo.

2. URL del Endpoint

Realiza una petición GET a la siguiente URL pasando el parámetro obligatorio repo:

GET https://pdcjjhjmjxohfpfpdfji.supabase.co/functions/v1/get-prompt?repo=nombre-usuario/slug-repositorio&path=prompt.md

3. Formatos de Respuesta

  • JSON (Predeterminado): Devuelve los metadatos estructurados del prompt, el repositorio y el contenido.
  • Raw (Texto Plano): Si añades el parámetro &format=raw a la URL, la API te devolverá únicamente el markdown puro del prompt (muy útil para inyectarlo directamente a tu LLM).

4. Ejemplo con cURL

# Obtener prompt en formato RAW
curl -X GET "https://pdcjjhjmjxohfpfpdfji.supabase.co/functions/v1/get-prompt?repo=jhoen/mi-repositorio&format=raw" \
  -H "Authorization: Bearer ph_pat_tu_token_aqui"

5. Ejemplo con Python

import requests

url = "https://pdcjjhjmjxohfpfpdfji.supabase.co/functions/v1/get-prompt"
params = {
    "repo": "jhoen/mi-repositorio",
    "format": "raw" # Obtener texto plano directo
}
headers = {
    "Authorization": "Bearer ph_pat_tu_token_aqui"
}

response = requests.get(url, params=params, headers=headers)
prompt_text = response.text
print(prompt_text)