167 lines
4.3 KiB
Markdown
167 lines
4.3 KiB
Markdown
# 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)
|