pdd

Transform rough ideas into design plans with requirements and research artifacts.

3.1k|286|Updated Sep 7, 2025
One-click install
npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill pdd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdd
Source: https://github.com/mikeyobrien/ralph-orchestrator/tree/main/.claude/skills/pdd
Command: npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill pdd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams transform vague ideas into detailed, implementable design plans through iterative clarification, research, and documented planning artifacts.

Core Features & Use Cases

  • Iterative requirements clarification with user confirmation at every transition.
  • On-demand research, design documentation, and Mermaid diagrams to capture architectures, data flows, and component relationships.
  • Real-time append-only logging of questions, answers, and findings to project files as the work progresses.
  • Planning-only workflow: produces planning artifacts and guidance without performing any execution or code changes.

Quick Start

Provide a rough idea to scaffold a formal design process. The system will create a new skill project directory containing rough-idea.md, requirements.md, and a research/ folder, then guide you through structured phases until a design plan is produced. For example: "Design a feature to improve onboarding." You will be prompted to confirm steps and provide details.

Frequently Asked Questions about pdd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn rough feature ideas into detailed design plans and requirements documentation?

To turn rough ideas into design plans, provide a brief concept to scaffold a formal design process. The system iteratively clarifies requirements and generates artifacts like rough-idea.md, requirements.md, and research notes.

What is prompt-driven design planning and how does it work for product specifications?

Prompt-driven design planning uses AI-assisted workflows to transform vague concepts into structured product specifications. It enforces planning-only discipline, capturing architectures and data flows through iterative clarification and Mermaid diagrams.

Can I execute code or build features directly while generating a project design plan?

You cannot execute code or build features directly while generating a project design plan. The workflow enforces a strict planning-only discipline, producing documentation and design artifacts without performing any code execution.

How do I document research notes and requirements during AI-assisted project planning?

To document research notes and requirements during project planning, the system uses real-time append-only logging. It automatically saves questions, answers, and findings into a structured project directory as work progresses.

What's the best way to visualize data flows and component relationships for a new feature design?

The best way to visualize data flows and component relationships for feature design is using Mermaid diagrams. The planning workflow generates these diagrams alongside requirements documentation to capture system architectures clearly.