promptschema
O Zod para prompts de IA — validados por esquema, versionados, multi-provedor e multi-linguagem.
promptschema é o que o Zod é para os tipos de TypeScript, aplicado aos prompts de LLM. Em vez de strings brutas espalhadas pelo seu codebase, os prompts viram contratos versionados e validados por esquema, com inputs tipados, diffs legíveis e um registry compartilhado em JSON-Schema consumido por TypeScript e Python. Qualquer modelo — OpenAI, Anthropic, Gemini, Ollama ou seu próprio adaptador — se conecta à mesma interface. Quando um prompt muda, semver te diz se é breaking, e os consumidores podem fixar versões como fixam dependências.
~12 kB
tamanho do bundle em TypeScript
2
linguagens de runtime (TS + Python)
0
vendor lock-in — escolha seu provedor
MIT
licença, de ponta a ponta
Por que existe
As peças que fazem valer a pena adotar.
Esquemas de input tipados
Defina o que um prompt requer — query do usuário, contexto recuperado, formato de saída — como esquema Zod (TS) ou Pydantic (Python). Erros de tipo aparecem no call site, não na saída do LLM em produção.
Versionamento semântico + diff automático
Cada prompt tem um semver. Mudanças breaking sobem major. Mudanças menores sobem minor. O registry vem com uma visão de diff para os reviewers verem exatamente o que mudou entre versões.
Registry multi-linguagem
Um registry JSON-Schema compartilhado entre paths de TypeScript e Python. Um serviço backend em Python e um agente frontend em TypeScript podem consumir o mesmo prompt versionado.
Multi-provedor por design
OpenAI, Anthropic, Gemini, Ollama ou seu próprio adaptador — se plugam à mesma interface. Trocar de provedor é uma mudança de config, não uma reescrita de cada call site.
Runtime sem dependências
~12 kB de bundle em TypeScript. Sem dependência de runtime do Zod se você já usa; sem framework requerido. Encaixa em qualquer stack.
MIT + sem vendor lock-in
Forke, estenda, contribua upstream. Nada da sua biblioteca de prompts fica presa ao Dailybot ou a um vendor de LLM.
Instalação
Comece em segundos.
Escolha o canal que combina com seu stack. Cada caminho te deixa no mesmo estado funcional.
npm i @dailybot/promptschemaNa prática
O que as equipes realmente fazem com ele.
01
Prompts como dependências versionadas
Fixe sua chamada LLM de produção em `[email protected]`. Quando um teammate envia `1.3.0`, você atualiza explicitamente. Sem mais mudanças silenciosas de comportamento por uma edição de string bruta que ninguém notou.
02
Prompts testáveis entre linguagens
Backend em Python, agente em TypeScript. Um esquema de prompt, um registry JSON-Schema compartilhado, contrato idêntico dos dois lados. Teste uma vez, envie duas.
03
Bibliotecas de prompts agnósticas de provedor
Desenhe seus prompts ao redor do que precisam dizer, não do que OpenAI ou Anthropic aceitam. O adaptador cuida da tradução.
04
Reviews de prompts que fazem sentido
Reviewers veem um diff semântico entre `v1.2` e `v1.3`, não uma parede de string atualizada. É a diferença entre revisar código e revisar um romance.
Numa olhada
A lista curta.
Schemas Zod (TS) e Pydantic (Python)
Versionamento semântico com diff automático
Registry JSON-Schema compartilhado entre linguagens
Bundle de ~12 kB, sem lock-in de fornecedor
FAQ
As perguntas que mais ouvimos.
Como isso difere de LangChain ou LlamaIndex?
Aqueles são frameworks. promptschema é uma biblioteca de contratos — é a camada *abaixo* do seu framework. Use dentro de LangChain, LlamaIndex ou seu próprio stack. Não toma partido.
Preciso de TypeScript e Python?
Não. Use um, ambos ou nenhum (JSON-Schema é o formato de intercâmbio). Se sua equipe é de uma única linguagem, promptschema ainda te dá versionamento, validação e diffs — a parte cross-language é opcional.
E modelos fechados como os da Anthropic?
Totalmente suportados via a interface de adaptador. O contrato é o mesmo independente do provedor. Trocar de Anthropic para OpenAI é uma mudança de config.
O que é
promptschema é uma biblioteca pequena e focada que trata prompts de LLM como artefatos de código de primeira classe: inputs tipados, versionamento semântico, registry compartilhado e adaptadores agnósticos de provedor. É a camada faltante entre “prompts de string brutas espalhadas pelo codebase” e “prompts que se comportam como o resto do seu stack”.
Por que open source
Porque um contrato de prompt só funciona se todos puderem ver, criticar e estender. promptschema é MIT, se desenvolve no aberto e foi desenhado para encaixar em qualquer stack — TypeScript, Python ou ambos. Forke, adapte, contribua.
Como se encaixa no ecossistema
As próprias superfícies de agente do Dailybot (skills, integrações, automações internas) dependem de contratos de prompt estáveis. promptschema é como escrevemos esses contratos. Abrir a biblioteca significa que qualquer um construindo software com muitos agentes pode tomar emprestada a mesma disciplina.
Pronto para experimentar?
Open source, MIT, e em produção no Dailybot todo dia. Forke, conecte, contribua.
Outros open source do Dailybot
Dailybot CLI
O cliente de linha de comando para toda a API do Dailybot.
Dailybot Agent Skill
O adaptador oficial entre seu agente de programação de IA e a API pública do Dailybot.
Deep Work Plan
A metodologia de plano com portões que qualquer agente de programação de IA pode executar.
Site do Deep Work Plan
O site open source de marketing e documentação da metodologia Deep Work Plan.