Platform Product Manager
Strategic product management expertise for API-first and developer-focused platforms — from API design and developer experience to ecosystem building and platform metrics.
Philosophy
Great platform products aren't about features. They're about making developers successful.
The best API and platform products:
- Developer experience is product experience — DX is your primary differentiator
- APIs are user interfaces — Design them with the same care as visual UIs
- Documentation is product — Great docs reduce support, increase adoption, drive success
- Ecosystem multiplies value — Your integrations make your platform stickier
How This Skill Works
When invoked, apply the guidelines in rules/ organized by:
api-*— API design principles, standards, and patternsdx-*— Developer experience, onboarding, and successdocs-*— Developer documentation strategy and standardssdk-*— SDK and library strategyversioning-*— API versioning, deprecation, and migrationcommunity-*— Developer community and ecosystem buildingmarketplace-*— Integration marketplace and partner strategymetrics-*— Platform health and success metrics
Core Frameworks
Platform Maturity Model
| Stage | Focus | Key Metrics | Team Structure |
|---|---|---|---|
| Foundation | Core API, basic docs | API uptime, error rates | PM + Engineers |
| Growth | DX, SDKs, onboarding | Time-to-first-call, activation | + DevRel, DX engineers |
| Scale | Ecosystem, marketplace | Integration count, partner revenue | + Partner team |
| Platform | Network effects, flywheel | Platform GMV, ecosystem value | Full platform org |
The Developer Journey
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ DISCOVER │ → │ EVALUATE │ → │ ADOPT │ → │ EXPAND │
│ │ │ │ │ │ │ │
│ - Search │ │ - Docs │ │ - Signup │ │ - More APIs │
│ - Content │ │ - Sandbox │ │ - First call│ │ - Higher │
│ - Referral │ │ - Pricing │ │ - Use case │ │ volume │
│ │ │ │ │ solved │ │ - Referral │
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘API Design Hierarchy
┌─────────────────┐
│ CONSISTENCY │ ← Predictable patterns
├─────────────────┤
│ SIMPLICITY │ ← Easy to understand
├─────────────────┤
│ DISCOVERABILITY│ ← Self-documenting
├─────────────────┤
│ RELIABILITY │ ← Stable and trustworthy
├─────────────────┤
│ PERFORMANCE │ ← Fast and efficient
└─────────────────┘Developer Success Metrics Stack
┌─────────────────────────────────────────────────────────────────┐
│ BUSINESS OUTCOMES │
│ Revenue, Retention, Net Dollar Retention │
├─────────────────────────────────────────────────────────────────┤
│ DEVELOPER SUCCESS │
│ Active Developers, API Calls, Use Cases Completed │
├─────────────────────────────────────────────────────────────────┤
│ DEVELOPER EXPERIENCE │
│ Time-to-First-Call, Activation Rate, Support Tickets │
├─────────────────────────────────────────────────────────────────┤
│ PLATFORM HEALTH │
│ Uptime, Latency, Error Rates, Documentation Quality │
└─────────────────────────────────────────────────────────────────┘Platform Types
| Type | Examples | Key Success Factor | Primary Metric |
|---|---|---|---|
| Infrastructure API | Stripe, Twilio, AWS | Reliability + DX | API calls, uptime |
| Data API | Plaid, Clearbit | Data quality + freshness | Data coverage |
| Aggregation Platform | Zapier, Segment | Integrations + ease | Connections made |
| Developer Tools | GitHub, Vercel | Workflow fit + speed | Active projects |
| Embedded Platform | Shopify Apps | Distribution + value | Install rate, GMV |
API Style Comparison
| Style | Best For | Complexity | Flexibility | Caching |
|---|---|---|---|---|
| REST | CRUD operations, simple resources | Low | Medium | Excellent |
| GraphQL | Complex data fetching, mobile | Medium | High | Manual |
| gRPC | Internal services, high perf | High | Low | N/A |
| Webhooks | Real-time events, async flows | Low | Medium | N/A |
| WebSocket | Bi-directional, real-time | Medium | High | N/A |
Anti-Patterns
- API-first without developer-first — Technically great API that's hard to use
- Documentation as afterthought — Docs written after API is "done"
- Breaking changes without warning — Surprising developers with incompatibilities
- Vanity integrations — Building integrations nobody uses for marketing
- Platform before product-market fit — Building ecosystem before core value
- Ignoring support signals — Not treating support tickets as product feedback
- One-size-fits-all SDK — Same SDK strategy for all languages/use cases
- Versioning without migration path — New versions without upgrade guides