# Deliverable: Platform PRD & Architecture

**Define the technical foundation - bridge design vision with technical reality**

---

## About WDS & the Platform PRD

**WDS (Whiteport Design Studio)** is an AI agent framework module within the BMAD Method that transforms how designers work. Instead of creating documentation that gets lost in translation, your design work becomes **powerful prompts** that guide AI agents and development teams with precision and intent.

**The Platform PRD** ensures your design vision is technically feasible. Saga helps you define the technical foundation before UX design begins, preventing costly rework when beautiful designs meet harsh technical reality.

---

## What Is This Deliverable?

The Platform PRD (Product Requirements Document) defines the technical architecture and infrastructure decisions:
- Data models and database structure
- System architecture and tech stack
- APIs and integrations
- Security and performance requirements
- Technical constraints and decisions

**Created by:** Saga the Analyst
**When:** Phase 4 - After Trigger Map, before UX design (or in parallel)  
**Format:** Structured PRD document + architecture diagrams

---

## Why This Matters

**Without Platform Architecture:**
- ❌ Designers create UX that's technically impossible
- ❌ Developers make inconsistent tech decisions
- ❌ Costly rework when design meets reality
- ❌ Security and performance as afterthoughts

**With Platform Architecture:**
- ✅ Realistic design constraints from day one
- ✅ Technical decisions documented and justified
- ✅ Developers aligned on approach
- ✅ Foundation for sustainable growth

---

## What's Included

### 1. System Architecture
- High-level architecture diagram
- Technology stack decisions (and rationale)
- Infrastructure requirements
- Deployment strategy

### 2. Data Models
- Entity relationships
- Database schema
- Data flow diagrams
- Storage requirements

### 3. API Specifications
- Endpoint definitions
- Request/response formats
- Authentication & authorization
- Rate limiting and caching

### 4. Technical Requirements
- Performance benchmarks
- Security requirements
- Scalability considerations
- Browser/device support

### 5. Integration Points
- Third-party services
- External APIs
- Authentication providers
- Analytics and monitoring

### 6. Technical Risks
- Known challenges
- Mitigation strategies
- Technical debt considerations

---

## The Dialog with Your Strategic Partner: Saga the Analyst

**The Process (1-2 hours):**

Saga helps you define technical boundaries:

```
Saga: "Let's establish the foundation. What platform are you targeting?"

You: "WordPress site with custom blocks for the design system."

Saga: "Smart choice - familiar editing, structured output.
       Any third-party integrations?"

You: "Newsletter signup (Mailchimp), analytics (Google Analytics)."

Saga: "Got it. What about user authentication?"

You: "No login needed - it's a marketing site."

Saga: "Perfect - that simplifies architecture significantly.
       Let me document this..."
```

As you discuss, Saga creates:
- ✅ Technology stack decisions
- ✅ Data model (if needed)
- ✅ Integration requirements
- ✅ Performance targets
- ✅ Security considerations
- ✅ Technical constraints for design

Then you review together:

```
Saga: "Here's your Platform PRD. Does this match your needs?"

You: "Add mobile-first responsive requirement."

Saga: "Added to technical requirements. ✅ PRD is ready."
```

**Result:** Platform PRD ready to guide UX design and development

---

## Example

*(Example coming soon)*

---

## Agent Activation

To start creating your Platform PRD:

```
@saga I need to create a Platform PRD for [Your Project Name].
```

Saga will begin the conversation and guide you through the process.

---

## How to Create This

**Hands-on Tutorial:** [Module 06: Platform Architecture](../module-06-platform-architecture/tutorial-06.md)

**Workflow Reference:** [Platform PRD Workflow](../src/workflows/3-prd-platform/)

---

## Getting Started with WDS

New to WDS? Install the complete AI agent framework to unlock all capabilities:

👉 **[Install WDS & Get Started](../../getting-started/getting-started-overview.md)**

---

**Previous Deliverable:** [Trigger Map & Personas](trigger-map.md)  
**Next Deliverable:** [Page Specifications & Prototypes](page-specifications.md)