Platform Teams Are Building Products for Developers—So Why Don’t They Do User Research?
I need to tell you about a platform team that built something technically brilliant that absolutely nobody wanted to use.
Last year, I was consulting with a mid-size tech company on design systems. While I was there, their platform team spent 9 months building what they described as “the most elegant deployment system ever created.”
I sat in on their demo. The tech was genuinely impressive:
- Beautiful microservices architecture
- Elegant abstractions over Kubernetes complexity
- Flexible configuration system supporting every edge case imaginable
- Comprehensive API with OpenAPI specs
The platform engineers were so proud. They’d solved incredibly hard technical problems. The architecture was clean. The code was pristine.
Then they launched it to the engineering org.
Developers hated it.
What Went Wrong? They Never Talked to Users.
The platform team never once:
- Interviewed developers about their actual deployment pain points
- Observed developers going through existing deployment workflows
- User-tested the CLI before shipping (the syntax was completely unintuitive)
- Designed documentation for human consumption (it read like API reference material)
- Created onboarding flows that matched how developers actually think
They built what they thought was elegant, not what developers needed.
Six months after launch, platform adoption was stuck at 35%. Developers were creating workarounds to avoid using it. The platform team couldn’t understand why their “technically superior” solution wasn’t being adopted.
Because they built for technical correctness, not user experience.
Compare This to a Platform Team That Got It Right
Now contrast that with another platform team I worked with:
Before writing a single line of code, they:
- Ran 20 developer interviews asking: “Walk me through your last deployment. What was painful?”
- Shadowed 5 developers during actual deploy workflows, taking notes on friction points
- Created user journey maps showing where developers got stuck
- Prototyped CLI commands and tested them with developers before implementation
- Designed documentation structure based on how developers search for answers (not how engineers organize information)
After shipping their first golden path:
- Weekly office hours where developers could give feedback
- Quarterly usability testing sessions (“Try this new feature, we’ll watch and take notes”)
- Developer NPS surveys with open-ended questions
- Anonymous feedback channel for platform complaints
Results:
- 85% platform adoption within 6 months
- Developer NPS went from +12 (before platform) to +68
- Support ticket volume down 55%
- Developers actively requested new features instead of being forced to use the platform
The difference? Product discipline. User research. Developer experience as first-class concern.
Platform Engineering IS Product Management for Internal Tools
Here’s my thesis: If we’re serious about “platform as product,” then platform teams need actual product discipline—not just the metaphor.
What product teams would NEVER do:
Build features without talking to users
Ship UIs without usability testing
Write documentation without considering findability and readability
Ignore user feedback because “technically it works fine”
Measure success by features shipped rather than user satisfaction
Yet I see platform teams do all of this routinely.
What “Platform as Product” Actually Looks Like
If you’re treating developers as customers, here’s what should be happening:
1. Discovery Before Development
Product teams: Research user needs, validate problems before building
Platform teams should: Interview developers, identify pain points, validate that golden paths solve real problems
2. Usability Testing
Product teams: Test prototypes with users, iterate based on feedback
Platform teams should: User-test CLIs, dashboards, and workflows before shipping. Watch developers try to use your tools without explaining anything.
3. Documentation as Product
Product teams: Treat docs as part of product experience
Platform teams should: Design documentation for humans. Information architecture. Visual hierarchy. Searchability. Not just “here’s the API reference.”
4. Feedback Loops
Product teams: User research, NPS surveys, feature requests, customer support data
Platform teams should: Developer interviews, NPS, office hours, feedback channels, observing how developers actually use (or avoid) your platform
5. Iterative Improvement
Product teams: Ship, measure, iterate based on data and feedback
Platform teams should: Golden paths aren’t “done”—they’re continuously improved based on developer usage patterns and feedback
The Question Nobody’s Asking
Here’s what I’m genuinely curious about:
Should platform teams literally hire designers, or are we expecting DevOps-turned-platform engineers to develop design thinking on their own?
Because here’s the thing: asking ops folks to suddenly care about:
- Information architecture
- Visual hierarchy in dashboards
- Intuitive CLI syntax
- Documentation findability
- User journey mapping
- Typography and readability
…feels like asking product managers to suddenly become SREs. Different skill sets. Different training. Different ways of thinking about problems.
When you build external products for customers, you wouldn’t dream of shipping without:
- Product managers (prioritization, user research, roadmap)
- Designers (UX, information architecture, visual design)
- Engineers (implementation)
Why do we think internal platforms are different?
My Controversial Take
Platform teams should be cross-functional from the start: engineers + product managers + designers.
Not “eventually when we scale.”
Not “when budget allows.”
From day one.
Even if it’s:
- 3 platform engineers
- 1 product manager (50% time)
- 1 designer (25% time)
That cross-functional mix ensures you’re building useful, usable platforms—not technically elegant solutions nobody wants.
The Design Expertise Platforms Actually Need
If you’re going to push back on “hire a designer,” let me be specific about what design brings:
CLI/Tool Usability
- Command syntax that matches mental models
- Error messages that actually help (not just stack traces)
- Help text that’s discoverable and useful
Documentation Design
- Information architecture (how docs are organized)
- Navigation and findability
- Visual hierarchy (headings, lists, code examples)
- Onboarding flows and tutorials
Dashboard/Portal UX
- Layout and navigation
- Data visualization that actually communicates insights
- Responsive design for different screen sizes
Developer Onboarding
- First-run experiences that guide without overwhelming
- Progressive disclosure (show complexity only when needed)
- Visual walkthroughs for common workflows
You could train platform engineers to do this. But why reinvent expertise that already exists?
The Real-World Example: Spotify’s Backstage
Look at Backstage, Spotify’s open-source internal developer portal. It’s successful because:
- Design system thinking: Consistent UI patterns, reusable components
- Plugin architecture: Designed for extensibility with good DX
- Documentation: Actually well-designed, not just comprehensive
- Onboarding: Thoughtful first-run experience
Backstage didn’t happen by accident. It had design input from the start.
My Questions for This Community
-
Has anyone embedded a designer on their platform team? What changed? Was it worth the investment?
-
For platform engineers: What’s the hardest part of “thinking like a product person”? Is it research? Prioritization? UX? Something else?
-
For product managers: If you joined a platform team, what would you change first?
-
For everyone: Should developer experience be a specialized discipline, or can any engineer learn it?
I genuinely believe platform engineering’s success depends on embracing product discipline—not just talking about “platform as product” while building like traditional infrastructure teams.
What’s your experience?