Imported from wonderslife/pdd-skills (pdd-main/SKILL.md). Install upstream with npx skills add wonderslife/pdd-skills --skill pdd-main. Copyright stays with the author (MIT).

PDD-MAIN - PRD-Driven Development Main Entry

Core Concept: PDD (PRD-Driven Development) is a development methodology that combines domain expert capabilities. By integrating system-architect, software-architect, software-engineer, and expert-xxx skills, it achieves comprehensive intelligence from requirement analysis to final delivery.

Input: PRD document directory path

Output: Completed feature code and verification report

Version History

1. Methodology Architecture

1.1 PDD Skill System

┌─────────────────────────────────────────────────────────────────┐
│                      PDD-MAIN (Main Entry)                      │
│  ┌─────────────┬─────────────┬─────────────┬─────────────┐      │
│  │  Process    │  State      │  Context    │  Result     │      │
│  │ Orchestration│ Management │  Transfer   │ Aggregation │      │
│  └─────────────┴─────────────┴─────────────┴─────────────┘      │
└─────────────────────────────────────────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        │                     │                     │
        ▼                     ▼                     ▼
┌───────────────┐     ┌───────────────┐     ┌───────────────┐
│   PDD Process │     │  Architect    │     │   Engineer    │
│     Layer     │     │    Layer      │     │    Layer      │
├───────────────┤     ├───────────────┤     ├───────────────┤
│ pdd-ba        │     │system-architect│    │software-eng   │
│ pdd-extract   │◄───►│               │◄───►│               │
│ pdd-generate  │     │software-arch  │     │ expert-xxx    │
│ pdd-implement │     │               │     │               │
│ pdd-review    │     │               │     │               │
│ pdd-verify    │     │               │     │               │
└───────────────┘     └───────────────┘     └───────────────┘

1.2 Skill Classification and Responsibilities

2. Complete Process

2.1 Six-Phase Process

Phase 1: Business Analysis and Feature Extraction
  PRD Document → 5W1H Analysis → Use Case Diagram → Flowchart → State Diagram → Feature Matrix

Phase 2: Development Specification Generation
  Feature Matrix → Architecture Consultation → Interface Design → Data Model → Dev Spec + Acceptance Criteria

Phase 3: Feature Loop
  For each feature: Implementation → Review → Fix → Acceptance

Phase 4: Architecture Review Integration
  On-demand system-architect / software-architect invocation

Phase 5: Expert Skills Integration
  On-demand expert-xxx invocation

Phase 6: Delivery and Retrospective
  Development Report → Document Archival → Lessons Learned

2.2 Detailed Process Steps

Step 1: Parse Input and Discover PRD Documents

Two Input Modes Supported:

Mode A: Module Number Auto-Discovery

• User inputs module number (e.g., ZCCZ-2, ZCCZ-1)
• Automatically scans docs/business-analysis/ directory
• Matches directory names (e.g., ZCCZ-2-Asset-Transfer)
• Automatically aggregates all design documents in that directory

Mode B: Manual Document Specification

• User directly specifies one or more design document paths
• Supports single file: docs/xxx/ZCCZ-2/PRD-Asset-Transfer.md
• Supports multiple files: separated by comma or newline
• Supports directory path: automatically discovers all .md documents in directory

Standard PRD Document Structure:

docs/business-analysis/{business-domain}/
├── PRD-{module-name}.md              # Requirements document
├── UseCase-{module-name}.md          # Use case diagram
├── BusinessFlow-{module-name}.md     # Flowchart
├── StateDiagram-{module-name}.md     # State diagram
├── SequenceDiagram-{module-name}.md  # Sequence diagram (optional)
└── FormDesign/                       # Form design documents (optional)

Auto-Discovery Process:

User Input: "ZCCZ-2"
    ↓
Scan docs/business-analysis/*/ZCCZ-2*/
    ↓
Match: docs/business-analysis/asset-disposition/ZCCZ-2-Asset-Transfer/
    ↓
Aggregate Documents:
  - PRD-Asset-Transfer.md
  - UseCase-Asset-Transfer.md
  - BusinessFlow-Asset-Transfer.md
  - StateDiagram-Asset-Transfer.md
  - SequenceDiagram-Asset-Transfer-Process.md
    ↓
Confirm Document Completeness

Step 2: Confirm Module Information

Extract module number and name from PRD document:

• Module Number: ZCCZ-1, ZCCZ-2, ...
• Module Name: Equity Transfer, Asset Transfer, ...

Step 3: Identify Technology Stack

Analyze project technology stack, determine which skills to invoke:

• RuoYi framework project → software-engineer + expert-ruoyi
• Workflow project → expert-activiti
• Database intensive → expert-mysql
• Architecture design phase → system-architect / software-architect

Step 4: Invoke Business Analysis

Invoke pdd-ba skill:

• Input: PRD document path
• Output: Business analysis report
• Uses 5W1H, MECE, CRUD methodologies

Step 5: Invoke Feature Extraction

Invoke pdd-extract-features skill:

• Input: PRD document path + Business analysis report
• Output: feature-matrix.md

Step 6: Manual Review of Feature Matrix

Wait for user to review feature matrix:

• Confirm feature completeness
• Confirm complexity assessment
• Confirm test strategy
• Confirm AI role assignment

Step 7: Invoke Specification Generation

Invoke pdd-generate-spec skill:

• Input: Feature matrix
• Output: spec.md, checklist.md

Architecture Consultation (On-Demand):

• Invoke system-architect: Technology selection, system architecture
• Invoke software-architect: Module division, interface design

Step 8: Manual Review of Specification

Wait for user to review development specification:

• Confirm interface design
• Confirm data model
• Confirm business logic
• Confirm test cases

Step 8.1: Generate Code Directory Structure

Automatically generate code directory that conforms to standards based on module number and functionality.

⚠️ Important Principles:

• New business features should create independent Maven modules, do not put in asset-system
• asset-system is the system management module, only contains system-related code (users, roles, menus, etc.)
• Business module naming convention: asset-{business-domain} (e.g., asset-disposition, asset-equity)

Module Number to Code Path Mapping:

Backend Module Directory Structure:

asset-{business-domain}/                    # Independent Maven module
├── pom.xml
└── src/
    ├── main/
    │   ├── java/
    │   │   └── com/example/{module}/
    │   │       ├── controller/        # Controllers
    │   │       ├── domain/            # Entity classes
    │   │       │   └── vo/            # VO objects
    │   │       ├── mapper/            # Mapper interfaces
    │   │       ├── service/           # Service interfaces
    │   │       │   └── impl/          # Service implementations
    │   │       ├── constant/          # Constant classes
    │   │       └── util/              # Utility classes
    │   └── resources/
    │       └── mapper/
    │           └── {module}/          # Mapper XML
    └── test/
        └── java/
            └── com/example/{module}/     # Test classes

Frontend Directory Structure:

asset-ui/src/
├── api/
│   └── {module}/              # API interfaces
│       └── {feature}.js
└── views/
    └── {module}/              # View pages (camelCase)
        ├── index.vue          # List page
        ├── form.vue           # Form page
        └── detail.vue         # Detail page

Example: ZCCZ-1 Equity Transfer

Backend:
  asset-equity/                          # Create independent module
  ├── pom.xml
  └── src/main/java/com/example/equity/transfer/
      ├── controller/
      │   └── EquityTransferApplyController.java
      ├── domain/
      │   ├── EquityTransferApply.java
      │   └── vo/
      ├── mapper/
      ├── service/
      │   └── impl/
      └── constant/
  └── src/main/resources/mapper/equity/transfer/

Frontend:
  asset-ui/src/api/equity/transfer.js
  asset-ui/src/views/equity-transfer/
  ├── index.vue
  ├── form.vue
  └── detail.vue

Existing Module Reuse Rules:

Error Examples (To Avoid):

❌ Wrong: Put business code in asset-system
asset-system/src/main/java/com/example/equity/  # Wrong!

✅ Correct: Create independent business module
asset-equity/src/main/java/com/example/equity/  # Correct!

Step 9: Loop Through Feature Implementation

For each feature (by priority P0 → P1 → P2):

a. Invoke Feature Implementation

• Invoke pdd-implement-feature skill
• Input: Development specification, Acceptance criteria
• Output: Code files

b. Invoke Software Engineer

• Invoke software-engineer skill
• Responsibility: Execute code implementation based on specification

c. Expert Consultation (On-Demand)

• RuoYi issues → expert-ruoyi
• Database issues → expert-mysql
• Code quality issues → expert-code-quality

d. Invoke Code Review

• Invoke pdd-code-reviewer skill
• Input: Code files, Development specification, Acceptance criteria
• Output: Review report

e. Architecture Review (On-Demand)

• Found architecture issues → software-architect
• Found system issues → system-architect

f. Handle Review Results

• No Critical issues → Continue to acceptance
• Has Critical issues → Fix and re-review

g. Invoke Feature Verification

• Invoke pdd-verify-feature skill
• Input: Code files, Development specification, Acceptance criteria
• Output: Acceptance report

h. Handle Acceptance Results

• Passed → Mark feature as complete
• Conditionally passed → Fix issues and re-verify
• Not passed → Re-develop

Step 10: Output Development Report

Generate final development report

3. Skill Integration

3.1 system-architect Integration

Trigger Conditions:

• New project initialization
• Technology stack selection
• System architecture design
• Major architecture changes

Service Content:

• Project structure design
• Technology stack recommendation
• Code standard definition
• Architecture Decision Records (ADR)

3.2 software-architect Integration

Trigger Conditions:

• Module division decisions
• Interface design review
• Data architecture design
• Architecture drift detected

Service Content:

• Module boundary definition
• Interface specification design
• Design pattern recommendation
• Architecture recommendations

3.3 software-engineer Integration

Trigger Conditions:

• Code implementation phase
• Unit test writing
• Code refactoring
• Defect fixing

Service Content:

• Implement code based on specification
• Follow project coding standards
• Error handling best practices
• Layered architecture implementation

3.4 expert-xxx Integration

4. AI Collaboration Mode

Automatically select AI role based on feature complexity:

Complexity and Skill Invocation Strategy

P0 (Core Business):
  pdd-main + pdd-ba + pdd-generate-spec
    ↓ Architecture consultation
  system-architect + software-architect
    ↓
  pdd-implement-feature + software-engineer
    ↓ + expert-ruoyi + expert-mysql
  pdd-code-reviewer + software-architect
    ↓
  pdd-verify-feature

P1 (Important Features):
  pdd-main + pdd-extract + pdd-generate-spec
    ↓ On-demand consultation
  software-architect (if needed)
    ↓
  pdd-implement-feature + software-engineer
    ↓ + expert-xxx (on-demand)
  pdd-code-reviewer
    ↓
  pdd-verify-feature

P2 (Auxiliary Features):
  pdd-main + pdd-generate-spec
    ↓
  pdd-implement-feature + software-engineer (lead)
    ↓
  pdd-code-reviewer (simplified)
    ↓
  pdd-verify-feature

5. Sub-Skill List

6. Flowcharts

6.1 Main Process Flow

┌─────────────────────────────────────────────────────────────────┐
│                      PDD-MAIN Main Process                      │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  PRD Document ──→ pdd-ba ──→ Business Analysis Report          │
│                │                                                │
│                ↓                                                │
│  pdd-extract-features ──→ Feature Matrix                       │
│                │                                                │
│                ↓                                                │
│           [Manual Review]                                       │
│                │                                                │
│                ↓                                                │
│  pdd-generate-spec ──→ Dev Spec + Acceptance Criteria          │
│                │                                                │
│                ├────── (on-demand) ──→ system-architect        │
│                │                                                │
│                ├────── (on-demand) ──→ software-architect      │
│                │                                                │
│                ↓                                                │
│           [Manual Review]                                       │
│                │                                                │
│                ↓                                                │
│  ┌──────────────────────────────────────┐                       │
│  │        Feature Loop Processing        │                       │
│  │  ┌────────────────────────────────┐  │                       │
│  │  │ pdd-implement-feature          │  │                       │
│  │  │         ↓                      │  │                       │
│  │  │ software-engineer              │  │                       │
│  │  │         ↓ (on-demand)          │  │                       │
│  │  │   expert-ruoyi / expert-mysql  │  │                       │
│  │  │         ↓                      │  │                       │
│  │  │ pdd-code-reviewer              │  │                       │
│  │  │         ↓ (on-demand)          │  │                       │
│  │  │   software-architect           │  │                       │
│  │  │         ↓                      │  │                       │
│  │  │ [Critical issues?] ─→ Fix ─┐   │  │                       │
│  │  │         ↓ (none)           │   │  │                       │
│  │  │ pdd-verify-feature          │   │  │                       │
│  │  │         ↓                   │   │  │                       │
│  │  │ [Passed?] ─→ Next feature   │   │  │                       │
│  │  │         ↓ (not passed)      │   │  │                       │
│  │  │      Re-develop ←───────────┘   │  │                       │
│  │  └────────────────────────────────┘  │                       │
│  └──────────────────────────────────────┘                       │
│                │                                                │
│                ↓                                                │
│           Development Report                                    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

6.2 Skill Collaboration Diagram

┌─────────────────────────────────────────────────────────────────┐
│                    Skill Collaboration Process                  │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌─────────────┐                                               │
│  │ PDD Process │  Discovers issues requiring professional support│
│  │   Skills    │                                               │
│  └──────┬──────┘                                               │
│         │                                                        │
│         ├──────────────────────────────┐                        │
│         │                              │                        │
│         ▼                              ▼                        │
│  ┌──────────────┐            ┌──────────────┐                │
│  │system-arch   │            │software-arch │                │
│  │(System Arch) │            │(Software Arch)│               │
│  └──────┬──────┘            └──────┬───────┘                │
│         │                           │                         │
│         ├───────────────────────────┼─────────────────────────┤ │
│         │                           │                         │ │
│         ▼                           ▼                         │ │
│  ┌──────────────┐            ┌──────────────┐                │ │
│  │software-eng  │            │ expert-xxx   │                │ │
│  │(Code Impl)   │            │(Domain Expert)│               │ │
│  └──────┬──────┘            └──────┬───────┘                │ │
│         │                           │                         │ │
│         └───────────────────────────┼─────────────────────────┘ │
│                                     │                           │
│                           ┌──────────┴──────────┐              │
│                           ▼                       ▼              │
│                    Return to PDD Process      Result Feedback   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

7. AI Role Collaboration Matrix

                    ┌─────────────────────────────────────────┐
                    │           PDD AI Collaboration Matrix    │
                    └─────────────────────────────────────────┘

    Skill/Role      │ Scheduler│ Analyzer │ Designer │Implementer│ Reviewer │ Expert
    ────────────────┼─────────┼─────────┼─────────┼─────────┼─────────┼────────
    pdd-main        │    ●    │         │         │         │         │
    pdd-ba          │         │    ●    │         │         │         │
    pdd-extract     │         │    ●    │         │         │         │
    pdd-generate    │         │         │    ●    │         │         │
    pdd-implement   │         │         │         │    ●    │         │
    pdd-reviewer    │         │         │         │         │    ●    │
    pdd-verify      │         │         │         │         │    ●    │
    ────────────────┼─────────┼─────────┼─────────┼─────────┼─────────┼────────
    system-arch     │         │         │    ●    │         │    ○    │
    software-arch   │         │         │    ●    │    ○    │    ○    │
    software-eng    │         │         │         │    ●    │         │
    ────────────────┼─────────┼─────────┼─────────┼─────────┼─────────┼────────
    expert-ruoyi    │         │         │    ○    │    ○    │    ○    │    ●
    expert-activiti │         │         │    ○    │    ○    │         │    ●
    expert-mysql    │         │         │    ○    │    ○    │    ○    │    ●
    expert-code     │         │         │    ○    │    ○    │    ●    │    ●

    Legend: ● Primary Responsibility  ○ Auxiliary Participation  │ Space Not Involved

8. Guardrails

• Must perform business analysis before extracting features
• Must wait for manual review of feature matrix
• Must wait for manual review of development specification
• Must perform code review after code implementation
• Each feature must pass acceptance before being marked complete
• Must synchronously update specification documents after code changes
• Issues must be recorded in lessons learned repository
• Architecture decisions must consult architect skills
• Technical issues must consult expert skills
• Expert recommendations must be integrated into code implementation

9. Usage Examples

9.1 Mode A: Module Number Auto-Discovery

User: I want to develop ZCCZ-2 Asset Transfer module
AI: [Invoking pdd-main skill]
     Scanning docs/business-analysis/ directory...
     Found module: ZCCZ-2-Asset-Transfer
     Path: docs/business-analysis/asset-disposition/ZCCZ-2-Asset-Transfer/

     Aggregated design documents:
     ✓ PRD-Asset-Transfer.md
     ✓ UseCase-Asset-Transfer.md
     ✓ BusinessFlow-Asset-Transfer.md
     ✓ StateDiagram-Asset-Transfer.md
     ✓ SequenceDiagram-Asset-Transfer-Process.md

     Confirm to start business analysis? [Y/n]

9.2 Mode B: Manual Document Specification

User: I want to develop based on these documents
     - docs/business-analysis/asset-disposition/ZCCZ-1/PRD-Equity-Transfer.md
     - docs/business-analysis/asset-disposition/ZCCZ-1/BusinessFlow-Equity-Transfer.md
     - docs/business-analysis/asset-disposition/ZCCZ-1/StateDiagram-Equity-Transfer.md

AI: [Invoking pdd-main skill]
     Received 3 design documents:
     ✓ PRD-Equity-Transfer.md
     ✓ BusinessFlow-Equity-Transfer.md
     ✓ StateDiagram-Equity-Transfer.md

     Starting business analysis...

9.3 Architecture Consultation Usage

User: This module needs to support multi-tenant architecture
AI: [Invoking software-architect skill]
     Consultation issue: Multi-tenant architecture design
     Passed data:
       - Feature requirements: Equity Transfer module
       - Existing architecture: Monolithic application
       - Constraints: Need to be compatible with existing permission system

     [software-architect returns architecture plan]
     Architecture Plan:
       1. Tenant identifier field design (tenant_id)
       2. Data isolation strategy (shared table + tenant field filtering)
       3. Tenant context transfer mechanism
       4. Key transformation points list

     Architecture constraints have been integrated into development specification

9.4 Expert Consultation Usage

User: Encountered permission issue when implementing transfer application list feature
AI: [Invoking expert-ruoyi skill]
     Consultation issue: Transfer application list interface permission check failed
     Passed data:
       - Interface path: /equity/transfer/apply/list
       - Error message: Permission check exception
       - Related code snippet: [code]

     [expert-ruoyi returns solution]
     Solution:
       1. Check @PreAuthorize annotation configuration
       2. Confirm permission identifier in sys_menu table
       3. Verify role menu assignment

     Solution has been integrated into code implementation

10. Requirement Change Handling

When requirements change:

Requirement Change
    ↓
pdd-doc-change analyzes change impact
    ↓
Update related specification documents
    ↓
Notify affected features
    ↓
┌─────────────────────────────────────┐
│ If architecture change involved:    │
│   → system-architect re-review      │
│ If technical solution change:       │
│   → Related expert-xxx re-consult   │
└─────────────────────────────────────┘
    ↓
Re-execute code review and verification

11. PDD Implementation Specification

This Skill follows PDD framework implementation specification, see pdd-framework-design.md Chapter 9.

11.1 Core Specification Summary

11.2 Review and Quality Analysis Collaboration

Code Implementation Complete
    │
    ▼
pdd-code-reviewer (Compliance Review)
    │
    ├── Has Critical issues → Return to fix → Re-review
    │
    └── No Critical issues
            │
            ▼
    expert-code-quality (Quality Depth Analysis)
            │
            ▼
    Generate Quality Improvement Tasks (improvement-tasks.md)
            │
            ▼
    Enter Next Phase

11.3 Checkpoint Resumption

• State File: .pdd-state.json
• Trigger Method: User issues "continue execution" command
• State Content: Current phase, completed features, pending features

12. Reference Documentation

• PDD Framework Design Document
• PDD Skill Relationships Specification
• system-architect SKILL.md
• software-architect SKILL.md
• software-engineer SKILL.md
• expert-ruoyi SKILL.md
• expert-activiti SKILL.md
• expert-mysql SKILL.md
• expert-code-quality SKILL.md