promptschema
El Zod para prompts de IA — validados por esquema, versionados, multi-proveedor y multi-lenguaje.
promptschema es lo que Zod es para los tipos de TypeScript, aplicado a los prompts de LLM. En lugar de strings crudos esparcidos por tu codebase, los prompts se convierten en contratos versionados y validados por esquema, con inputs tipados, diffs legibles y un registry compartido en JSON-Schema que consumen tanto TypeScript como Python. Cualquier modelo — OpenAI, Anthropic, Gemini, Ollama o tu propio adaptador — se conecta a la misma interfaz. Cuando un prompt cambia, semver te dice si es breaking, y los consumidores pueden fijar versiones como fijan dependencias.
~12 kB
tamaño de bundle en TypeScript
2
lenguajes de runtime (TS + Python)
0
vendor lock-in — elige tu proveedor
MIT
licencia, de punta a punta
Por qué existe
Las piezas que hacen que valga la pena adoptarlo.
Esquemas de input tipados
Define qué requiere un prompt — query del usuario, contexto recuperado, formato de salida — como esquema Zod (TS) o Pydantic (Python). Los errores de tipo aparecen en el call site, no en el output del LLM en producción.
Versionado semántico + diff automático
Cada prompt tiene un semver. Cambios breaking suben major. Cambios menores suben minor. El registry incluye una vista de diff para que los reviewers vean exactamente qué cambió entre versiones.
Registry multi-lenguaje
Un registry JSON-Schema compartido entre paths de TypeScript y Python. Un servicio backend en Python y un agente frontend en TypeScript pueden consumir el mismo prompt versionado.
Multi-proveedor por diseño
OpenAI, Anthropic, Gemini, Ollama o tu propio adaptador — enchufan a la misma interfaz. Cambiar proveedor es un cambio de config, no una reescritura de cada call site.
Runtime sin dependencias
~12 kB de bundle en TypeScript. Sin dependencia runtime de Zod si ya lo usas; sin framework requerido. Encaja en cualquier stack.
MIT + sin vendor lock-in
Forkéalo, extiéndelo, contribuye upstream. Nada de tu biblioteca de prompts queda atado a Dailybot o a un vendor de LLM.
Instalación
Empieza en segundos.
Elige el canal que encaje con tu stack. Cada camino te deja en el mismo estado funcional.
npm i @dailybot/promptschemaEn la práctica
Lo que los equipos realmente hacen con él.
01
Prompts como dependencias versionadas
Fija tu llamada LLM de producción a `[email protected]`. Cuando un teammate envía `1.3.0`, actualizas explícitamente. Sin más cambios silenciosos de comportamiento por una edición de string cruda que nadie notó.
02
Prompts testeables entre lenguajes
Backend escrito en Python, agente en TypeScript. Un esquema de prompt, un registry JSON-Schema compartido, contrato idéntico en ambos lados. Testea una vez, envía dos.
03
Bibliotecas de prompts agnósticas de proveedor
Diseña tus prompts alrededor de lo que necesitan decir, no de lo que OpenAI o Anthropic aceptan. El adaptador maneja la traducción.
04
Reviews de prompts que tienen sentido
Los reviewers ven un diff semántico entre `v1.2` y `v1.3`, no un muro de string actualizado. Es la diferencia entre revisar código y revisar una novela.
De un vistazo
La lista corta.
Esquemas Zod (TS) y Pydantic (Python)
Versionado semántico con diff automático
Registry JSON-Schema compartido entre lenguajes
Bundle de ~12 kB, sin lock-in de proveedor
FAQ
Las preguntas que más escuchamos.
¿En qué se diferencia de LangChain o LlamaIndex?
Esos son frameworks. promptschema es una librería de contratos — es la capa *debajo* de tu framework. Úsala dentro de LangChain, LlamaIndex o tu propio stack. No toma partido.
¿Necesito TypeScript y Python?
No. Usa uno, ambos o ninguno (JSON-Schema es el formato de intercambio). Si tu equipo es de un solo lenguaje, promptschema igual te da versionado, validación y diffs — la parte cross-language es opcional.
¿Qué pasa con modelos cerrados como los de Anthropic?
Totalmente soportados vía la interfaz de adaptador. El contrato es el mismo sin importar el proveedor. Cambiar de Anthropic a OpenAI es un cambio de config.
Qué es
promptschema es una librería pequeña y enfocada que trata los prompts de LLM como artefactos de código de primera clase: inputs tipados, versionado semántico, registry compartido y adaptadores agnósticos de proveedor. Es la capa faltante entre “prompts de string crudos esparcidos por el codebase” y “prompts que se comportan como el resto de tu stack”.
Por qué open source
Porque un contrato de prompt solo funciona si todos pueden verlo, criticarlo y extenderlo. promptschema es MIT, se desarrolla en abierto y está diseñado para encajar en cualquier stack — TypeScript, Python o ambos. Forkéalo, adáptalo, contribuye.
Cómo encaja en el ecosistema
Las propias superficies de agente de Dailybot (skills, integraciones, automatizaciones internas) dependen de contratos de prompt estables. promptschema es cómo escribimos esos contratos. Hacer open source la librería significa que cualquiera que construya software con muchos agentes puede tomar prestada la misma disciplina.
¿Listo para probarlo?
Open source, MIT, y en producción en Dailybot cada día. Forkéalo, cablealo, contribuye.
Otros open source de Dailybot
Dailybot CLI
El cliente de línea de comandos para toda la API de Dailybot.
Dailybot Agent Skill
El adaptador oficial entre tu agente de codificación de IA y la API pública de Dailybot.
Deep Work Plan
La metodología de plan con puertas que cualquier agente de codificación de IA puede ejecutar.
Sitio de Deep Work Plan
El sitio open source de marketing y documentación de la metodología Deep Work Plan.