pdd-kit

Overview

pdd-kit (Product-Driven Development for coding agents) is an open-source toolkit designed to streamline the process of defining and developing products by providing a shared product model that is coherent, structured, and easily accessible.

The Challenge

The essence of a product often exists in various forms—scattered across documentation, code, tickets, and communication channels. This fragmentation leads to redundancy, misinterpretation, and inconsistent implementations by different coding agents. Product-Driven Development (PDD) addresses this issue by centralizing the product definition, making it easily interpretable for both agents and humans. Instead of having a product described within individual specifications, PDD promotes a unified product model that is:

• Git-tracked for version control
• Reviewable for accountability
• Verifiable against the implemented code

Key Components of the Product Model

The product model in pdd-kit is structured around several core elements, all defined in plain Markdown files within your repository:

• Entities: Objects that the product interacts with (e.g., Order, Customer).
• Interfaces: Methods users and systems utilize to engage with the product (e.g., Web app, API).
• Domains: Categorized areas of the product (e.g., Catalog, Billing).
• Capabilities: Actions users can perform within the product (e.g., Cancel order).
• Journeys: User goals that span multiple capabilities.
• Business Rules: Constraints on actions and behaviors that must always be adhered to.
• Variations: Different modes of operation within the product.

Benefits of Using pdd-kit

For Maintainability and Clarity:

• Developers gain a centralized reference that defines behavior changes alongside code modifications, facilitating smoother reviews and collaboration.
• New contributors can quickly learn what the product does without sifting through extensive codebases.
• Product managers and documentation authors can find accurate product details in one location, supported by pertinent references to underlying code and materials.

For Development Cycles:

• Agents have clear guidelines about what to build, thus minimizing guesswork through explicit scenarios and rules.
• Code is subjected to verification checkpoints against the model to ensure alignment and quality.

Example Use Case: Kanban Board Model

An illustrative application of the pdd-kit is in developing a Kanban Board product, where coding agents implement features based on the structured product model. This model guides the development process by clarifying entities, capabilities, and interfaces involved, ensuring agents work from a unified understanding.

Features

• Agent Skills: Integrates with various coding agents (e.g., Claude Code, GitHub Copilot) for seamless interaction.
• Markdown-Native Documentation: Keeps everything organized in plain text files, easily reviewable via pull requests.
• Linting and Verification: Tools to ensure compliance with the product model and maintain code integrity.
• Blueprints: Allows initiation from established product templates to speed up development.
• Local-First Approach: No cloud dependencies, making it self-contained and easy to deploy locally.

Getting Started

To begin with pdd-kit, run:

npx pdd-toolkit install

Following the installation, users can map existing repositories or ideate new product concepts directly through the toolkit.

Conclusion

pdd-kit facilitates a robust development environment by centering around the product model, ensuring coding agents operate with cohesive, verifiable specifications. This approach enhances overall productivity and comprehension across development teams.