Transforma um repositório Git ou diretório local em um resumo de texto pronto para prompts, para fornecer código a LLMs.
promptdriven/pdd
Um sistema de desenvolvimento nativo de prompts em que arquivos .prompt são a fonte, e código em Python, TypeScript, Go e outras linguagens é gerado a partir deles.
- Estrelas
- 913
- Forks
- 82
- Issues abertas
- 493
- Último commit
- anteontem
O que é?
O PDD (Prompt-Driven Development) trata os arquivos `.prompt` como a fonte do projeto escrita por pessoas; o código nas linguagens tradicionais é gerado a partir deles. Os desenvolvedores descrevem a intenção, as restrições, os exemplos e os testes nos prompts e, em seguida, geram código de implementação que continua sendo código real e passível de revisão, mas deixa de ser a principal fonte da verdade.
A CLI, instalada como `pdd-cli`, oferece um ciclo `pdd sync` que executa a inserção de dependências, a geração, os exemplos, o tratamento de falhas, a verificação, os testes e as correções de cada módulo. Comandos agênticos como `pdd change`, `pdd bug` e `pdd fix` recebem URLs de issues do GitHub e executam fluxos de trabalho com várias etapas usando Claude Code, Gemini/Antigravity, Codex ou OpenCode. O comando `pdd connect` abre uma interface web local na porta 9876.
No modo local, o PDD usa LiteLLM para acessar modelos, com um catálogo de modelos em CSV e um assistente de configuração que detecta chaves de API e ferramentas de CLI agênticas. O modo cloud é o padrão e usa o login do GitHub.
Recursos principais
- 01Gera código em Python, TypeScript, Go e outras linguagens a partir de arquivos-fonte `.prompt`.
- 02Executa um ciclo `pdd sync` que abrange a inserção de dependências, a geração, os exemplos, o tratamento de falhas, a verificação e os testes.
- 03Implementa issues do GitHub por meio dos comandos `pdd change`, `pdd bug` e `pdd fix`.
- 04Oferece uma interface web local iniciada com `pdd connect`.
- 05Oferece suporte a várias CLIs agênticas e provedores de LLM por meio do LiteLLM no modo local.
Casos de uso
- Manter uma base de código em que os prompts descrevem o comportamento e o código é gerado novamente quando a intenção muda.
- Transformar solicitações de funcionalidades ou relatórios de bugs do GitHub em alterações testadas usando os comandos agênticos.
- Gerar o mesmo módulo em várias linguagens de destino a partir de uma única fonte de prompt.
Início rápido
- 1
Instale o uv (execute o script oficial de instalação indicado no README)
- 2
Instale o PDD com o uv
uv tool install pdd-cli - 3
Execute o assistente de configuração para detectar ferramentas e chaves de API
pdd setup - 4
Inicie a interface web
pdd connect
Antes de usar
- Requer Python 3.12 ou superior.
- Para executar a maioria dos fluxos de trabalho, é necessária uma chave de API de LLM ou uma CLI agêntica com sessão iniciada, como Claude Code, Codex ou Gemini CLI.
- Os fluxos de trabalho de CLI baseados em issues também exigem o GitHub CLI (gh).
Em coleções
Tópicos
Perguntas frequentes
- O que é pdd?
- Um sistema de desenvolvimento nativo de prompts em que arquivos .prompt são a fonte, e código em Python, TypeScript, Go e outras linguagens é gerado a partir deles. O PDD (Prompt-Driven Development) trata os arquivos `.prompt` como a fonte do projeto escrita por pessoas; o código nas linguagens tradicionais é gerado a partir deles. Os desenvolvedores descrevem a intenção, as restrições, os exemplos e os testes nos prompts e, em seguida, geram código de implementação que continua sendo código real e passível de revisão, mas deixa de ser a principal fonte da verdade.
- pdd é gratuito? Qual é a licença?
- pdd é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- pdd ainda é mantido?
- Manutenção ativa. O último commit de pdd foi em 23 de out. de 2026.
- Para que posso usar pdd?
- Manter uma base de código em que os prompts descrevem o comportamento e o código é gerado novamente quando a intenção muda. Transformar solicitações de funcionalidades ou relatórios de bugs do GitHub em alterações testadas usando os comandos agênticos. Gerar o mesmo módulo em várias linguagens de destino a partir de uma única fonte de prompt.
- Como instalar pdd?
- Instale o uv (execute o script oficial de instalação indicado no README) Instale o PDD com o uv: uv tool install pdd-cli Execute o assistente de configuração para detectar ferramentas e chaves de API: pdd setup Inicie a interface web: pdd connect
- Onde consigo pdd?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/promptdriven/pdd
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Um toolkit open source que oferece a agentes de programação com IA processos estruturados baseados em especificações, templates e resultados documentados para desenvolver funcionalidades, corrigir bugs ou avaliar ideias.
CLI que configura Claude Code e Codex em um único comando, com prompts bilíngues, workflows, presets de provedores de API e configuração de MCP.
Transforma qualquer repositório do GitHub em um diagrama interativo de arquitetura ou em um vídeo explicativo narrado de um minuto, com um servidor MCP para agentes de IA.
Framework de agentes para OpenCode que adiciona fluxos de programação com IA baseados em planos e aprovação, usando os padrões de código da sua equipe.
Um otimizador de prompts com IA que aprimora prompts, testa e compara os resultados e os salva como recursos reutilizáveis, disponível como app web, desktop, extensão do Chrome e Docker.