Skip to main content
PDD (Prompt-Driven Development) inverts the traditional development model: instead of writing code directly, you write prompt files that describe what you want, then let AI generate and maintain the code for you. Prompts are versioned, composable, and regenerable — your code becomes a disposable artifact.

Install PDD

Get up and running in under 5 minutes with uv or pip

Quickstart

Run your first prompt-to-code workflow with the Hello example

Core Concepts

Understand the PDD philosophy and the mold paradigm

Command Reference

Every command, flag, and option documented

What PDD does

PDD provides a complete workflow from a natural-language prompt to production-ready, tested code:
1

Write a prompt file

Describe what you want in a .prompt file using natural language. Prompts are modular and composable — one prompt per module.
2

Run pdd sync

The sync command runs the full cycle automatically: resolves dependencies, generates code, creates runnable examples, verifies correctness, generates tests, fixes bugs, and back-propagates learnings to your prompt.
3

Iterate with prompts, not code

When requirements change, update the prompt and regenerate. PDD’s fingerprint-based change detection only regenerates what needs updating.
4

Implement GitHub issues automatically

Use pdd change <issue-url> or pdd bug <issue-url> to let PDD implement or fix GitHub issues end-to-end using an agentic multi-step workflow.

Choose your workflow

Web Interface

Launch pdd connect for a visual browser-based UI — the easiest way to get started

Issue-Driven CLI

Point PDD at a GitHub issue and let it implement the feature or fix automatically

Prompt Workflow

Write prompt files and use pdd sync for full manual control over the generation cycle

Build docs developers (and LLMs) love