Claude PDD CLI - Project-Driven Development Platform


Claude PDD - Flexible Project-Driven Development Platform with PDD/PMD/TDD methodology support

Transform your development workflow with the revolutionary Project-Driven Development approach! This platform supports multiple methodologies (PDD/PMD/TDD) with intelligent CCPM integration, dynamic online/offline installation, and flexible development workflows tailored to your project needs.

🌟 Features

$3

- 39 Project Management Commands - Full PRD to deployment workflow
- Epic & Task Management - Break down features into manageable tasks
- GitHub Issues Integration - Seamless sync with GitHub project boards
- "No Vibe Coding" - Every line of code traces to a specification
- Parallel Development - Team coordination and conflict prevention

$3

- 5 TDD Commands - Complete Red-Green-Refactor cycle automation
- Spec-to-Test Generation - Convert requirements into comprehensive test suites
- Multi-Framework Support - Node.js, Java, Python, Go, Rust
- Test Coverage Tracking - Integrated with GitHub Issue updates
- Quality Gates - Automated validation at each TDD phase

$3

- Online Mode - Automatically fetches latest CCPM from GitHub
- Offline Mode - Falls back to built-in templates when needed
- Intelligent Fallback - Seamless online-to-offline switching
- Zero Maintenance - Always get the latest CCPM features
- Cross-Platform - Windows PowerShell + Unix Bash support

$3

- 8 Specialized Agents - TDD, test generation, parallel coordination
- 4 Complete Workflows - Spec-driven TDD and Issue-to-test flows
- Context Management - Persistent project context across sessions
- Automated Reporting - Progress tracking and team visibility

🚀 Quick Start

$3

``bash
npm install -g claude-pdd-cli
`

$3

`bash

Full system (CCPM + TDD) - Recommended

cpdd init

Quick setup with defaults

cpdd init --quick

Specific modes

cpdd init --mode=pm # Project management only
cpdd init --mode=tdd # TDD tools only

Control installation method

cpdd init --online # Force online mode (fetch latest CCPM from GitHub)
cpdd init --offline # Force offline mode (use built-in templates)

With GitHub integration

cpdd init --github=owner/repo

Combined options

cpdd init --mode=pm --online --github=owner/repo
`

$3

`bash
cpdd status
`

📖 Documentation

$3

👉 查看完整使用指南 (COMPLETE-USAGE-GUIDE.md)

包含：
- 🎯 39个项目管理命令详解 - PRD、Epic、Issue完整生命周期
- 🧪 5个TDD命令工作流 - Red-Green-Refactor完整循环
- 🌳 Git Worktree并行开发 - 多代理协同工作模式
- 📊 最佳实践和故障排除 - 团队协作优化指南

$3

After initialization, all functionality is accessed through Claude Code commands:

$3

#### 1. Start with Requirements
`bash

In Claude Code:

/pm:prd-new user-authentication

→ Interactive PRD creation

→ Comprehensive requirements gathering

`

#### 2. Create Epic & Tasks
`bash
/pm:prd-parse user-authentication

→ Breaks PRD into Epic with tasks

→ Creates GitHub Issues automatically

/pm:epic-sync

→ Syncs to GitHub project board

→ Sets up milestones and labels

`

#### 3. TDD Development
`bash
/pm:issue-start 123

→ Loads specific task requirements

→ Sets up development context

/tdd:spec-to-test

→ Converts requirements to test cases

→ Creates comprehensive test suite

/tdd:cycle

→ Complete Red-Green-Refactor cycle

→ Updates GitHub Issue with progress

`

#### 4. Quality & Completion
`bash
/pm:issue-close 123

→ Validates completion criteria

→ Updates Epic progress

/pm:next

→ Recommends next task

→ Handles dependencies automatically

`

🌐 Intelligent Installation System

The CLI uses a revolutionary dynamic installation approach:

$3

1. Network Detection - Automatically checks internet connectivity
2. GitHub Fetch - Downloads latest CCPM from automazeio/ccpm repository
3. Smart Execution - Runs CCPM's install script with cross-platform support
4. TDD Enhancement - Overlays custom TDD functionality on top of CCPM
5. Automatic Fallback - Switches to offline mode if network fails

$3

`bash

Automatic mode (recommended)

cpdd init

→ Detects network → Fetches latest CCPM → Adds TDD enhancements

Force specific behavior

cpdd init --online # Always try GitHub (fail if no network)
cpdd init --offline # Use built-in templates (faster, no network needed)
`

$3

- CCPM Commands - Complete project management system (39 commands)
- GitHub Integration - Issue sync, project boards, automation
- AI Agents - Project coordination and workflow management
- Templates - PRD, Epic, and task management templates

$3

If online installation fails, the system automatically provides:
- Core TDD workflow commands
- Basic project structure
- Essential development patterns
- Framework-specific configurations

🎯 Installation Modes

$3

`bash
cpdd init --mode=pdd
`
Includes: All CCPM commands, TDD tools, GitHub integration, complete workflows

Perfect for: Teams wanting complete project management + development workflow

$3

`bash
cpdd init --mode=pm
`
Includes: Project management, Epic/Issue handling, GitHub sync, context management

Perfect for: Project managers, teams focused on requirement management

$3

`bash
cpdd init --mode=tdd
`
Includes: TDD cycle commands, test generation, basic testing workflows

Perfect for: Developers wanting pure TDD workflow without project management

🛠️ Supported Frameworks

| Framework | Test Framework | Package Manager | Status |
|-----------|----------------|-----------------|---------|
| Node.js/TypeScript | Jest, Vitest, Mocha | npm, yarn, pnpm | ✅ Full Support |
| Java | JUnit 5, TestNG | Maven, Gradle | ✅ Full Support |
| Python | pytest, unittest | pip, poetry | ✅ Full Support |
| Go | go test | go modules | ✅ Full Support |
| Rust | cargo test | cargo | ✅ Full Support |
| C# | xUnit, NUnit | dotnet | 🚧 Coming Soon |
| PHP | PHPUnit | composer | 🚧 Coming Soon |

📁 What Gets Installed

The CLI creates a .claude/ directory with:

`
.claude/
├── CLAUDE.md # Unified rules and command reference
├── config.json # System configuration
├── agents/ # AI agents (6 total)
│ ├── tdd-agent.md # TDD workflow coordinator
│ ├── test-generator.md # Test case generator
│ ├── parallel-worker.md # Team coordination
│ └── ...
├── commands/ # All available commands
│ ├── pm/ # Project management (39 commands)
│ ├── tdd/ # TDD workflow (5 commands)
│ ├── testing/ # Test execution
│ └── context/ # Context management
├── workflows/ # Complete workflows (2 total)
│ ├── spec-driven-tdd.md
│ └── issue-to-test.md
├── rules/ # Development rules and patterns
├── epics/ # Epic templates and storage
└── prds/ # PRD templates and storage
`

🔄 Example Workflows

$3

`bash

In Claude Code:

/pm:issue-start 456 # Load bug report
/tdd:spec-to-test # Create reproduction tests
/tdd:red # Ensure tests fail (confirming bug)
/tdd:green # Fix the bug
/tdd:refactor # Improve code quality
/pm:issue-close 456 # Mark as resolved
`

$3

`bash

Complete spec-driven development:

/pm:prd-new feature-name # Create requirements
/pm:prd-parse feature-name # Break into tasks
/pm:epic-sync # Sync to GitHub
/pm:issue-start 789 # Start first task
/tdd:cycle # Implement with TDD
/pm:next # Move to next task
`

📊 Benefits

$3

- 100% Requirement Traceability - Every test and code line links back to specifications
- Reduced Context Switching - Persistent context across development sessions
- Parallel Development - Multiple developers work without conflicts
- Quality Assurance - Automated validation at every step

$3

- Real-time Visibility - GitHub Issues show actual development progress
- Specification-Driven - No implementation without requirements
- Team Coordination - Built-in conflict resolution and task assignment
- Audit Trail - Complete history from requirement to deployment

$3

- Transparency - Clear progress tracking in familiar GitHub interface
- Quality Metrics - Test coverage and completion rates visible
- Predictability - Consistent development velocity and timelines
- Risk Reduction - Early detection of scope creep and blockers

🔧 Configuration

$3

`bash
cpdd init --github=owner/repo
`

Then configure your GitHub token in Claude Code settings for full automation.

$3

The system auto-detects your framework and configures appropriate:
- Test patterns and file locations
- Build and test commands
- Coverage reporting
- CI/CD integration points

$3

Edit .claude/config.json to customize:
- Test coverage thresholds
- GitHub label prefixes
- Workflow preferences
- Team coordination settings

📚 Command Reference

$3

- cpdd init - Install/configure system
- cpdd status - Check installation status
- cpdd update - Update to latest version

$3

#### Project Management (39 commands)
- /pm:prd-* - PRD management (5 commands)
- /pm:epic-* - Epic handling (12 commands)
- /pm:issue-* - Issue management (8 commands)
- /pm:* - Workflow and coordination (14 commands)

#### TDD Development (5 commands)
- /tdd:cycle - Complete TDD cycle
- /tdd:red - Red phase (failing tests)
- /tdd:green - Green phase (implementation)
- /tdd:refactor - Refactor phase (quality)
- /tdd:spec-to-test - Requirements to tests

See .claude/CLAUDE.md for complete reference.

🤝 Contributing

We welcome contributions! This project combines:
- CCPM - Originally from automazeio/ccpm
- TDD Tools - Custom-built for Claude Code integration

$3

`bash
git clone https://github.com/MuziGeek/claude-pdd-cli.git
cd claude-pdd-cli
npm install
npm run build
npm link
`

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

- CCPM System - Thanks to automazeio for the amazing CCPM foundation
- Claude Code Team - For creating the platform that makes this integration possible
- TDD Community - For decades of wisdom on test-driven development practices

---

Ready to revolutionize your development workflow?

`bash
npm install -g claude-pdd-cli
cpdd init
``

Transform requirements into tested, production-ready code with full traceability and team coordination. 🚀