Architecture

Internal Developer Platforms Should Feel Like Products

· 5 min read · Updated Mar 11, 2026
Internal developer platforms that applied product management principles (user research, onboarding optimization, NPS measurement) achieved 74% developer adoption within 6 months, compared to 31% for platforms that relied on organizational mandates, based on data from 11 platform teams I have worked with since 2022.

Why do internal developer platforms fail when they prioritize control over experience?

Internal platforms fail because they are designed to satisfy organizational requirements (standardization, compliance, cost control) rather than to solve problems that developers actually have, creating tools that developers circumvent rather than adopt.

An internal developer platform (IDP) is a self-service layer that abstracts infrastructure complexity, providing developers with standardized workflows for building, deploying, and operating software. When designed well, it reduces cognitive load and accelerates delivery. When designed poorly, it adds bureaucratic friction that drives shadow IT adoption.

I have seen the same failure pattern 7 times across 11 organizations. A platform team is formed. They build a portal. The portal requires developers to fill out forms, wait for approvals, and follow workflows designed by the platform team without developer input. Developers, who are measured on delivery velocity, find the portal slower than their existing ad-hoc methods. They work around it. The platform team, measuring adoption, adds enforcement policies. Developers resent the enforcement. The platform becomes synonymous with bureaucracy. Adoption stalls at 31%.

The platforms that succeeded followed a different path. They started by asking developers what problems they faced. They built solutions to those problems. They measured satisfaction alongside adoption. They iterated based on feedback. They treated their developers as customers, not subjects. This is not a radical idea. It is product management applied to internal tools, and it works because the same principles that make external products successful (user-centricity, iterative development, satisfaction measurement) apply to internal products.

What product management principles translate most directly to platform engineering?

User research, progressive onboarding, and continuous satisfaction measurement are the three product principles that have the largest impact on platform adoption.

User Research: Before building any platform capability, the team conducts 5 to 8 developer interviews to understand the current workflow, identify friction points, and validate that the proposed solution addresses a real problem. In one organization, this research revealed that developers did not want a deployment portal. They wanted a CLI tool that integrated with their existing Git workflow. The platform team built the CLI. Adoption reached 82% in 4 months because the solution fit into the developer’s existing context rather than requiring them to adopt a new context.

Progressive Onboarding: The platform provides value within 5 minutes of a developer’s first interaction. A new developer can deploy a service to a staging environment by running a single command within their first hour. Advanced features (custom resource configurations, compliance guardrails, cost optimization) are introduced progressively as the developer’s needs grow. This mirrors the onboarding pattern of successful SaaS products: immediate value, then depth. I explored onboarding principles in the onboarding process mirror.

NPS Measurement: The platform team surveys developers quarterly using a Net Promoter Score survey supplemented with open-ended questions. The NPS score is tracked alongside adoption metrics. A platform with high adoption but low NPS is a platform maintained by mandate, not satisfaction. The goal is both. In my experience, platforms with NPS above 40 sustain adoption growth without enforcement policies. Platforms with NPS below 20 require mandates to maintain adoption, which creates organizational friction.

How does this approach connect to the broader philosophy of platform engineering?

Platform engineering is a service discipline. The platform exists to make other teams more effective, and measuring success by the platform’s capabilities rather than by the developers’ outcomes inverts the purpose.

The organizations that build the best internal platforms share a mindset I recognize from platform engineering as service to others. The platform team does not measure success by how many features the platform has. They measure success by how fast developers can go from idea to production, how few incidents are caused by infrastructure issues, and how little time developers spend on undifferentiated work. These are developer outcomes, not platform outputs.

According to the CNCF Platform Engineering white paper, successful platforms are “compelling” rather than “mandated.” This language matters. A compelling platform is one that developers choose because it makes their work easier. A mandated platform is one that developers tolerate because the alternative is a policy violation. The engineering effort required to build either is similar. The organizational outcomes are dramatically different.

What are the practical steps for transforming a bureaucratic platform into a product?

Start by measuring developer satisfaction, identify the top 3 friction points, solve them in the next quarter, and communicate the improvements visibly.

  • Measure first: Deploy a developer satisfaction survey before changing anything. Establish a baseline NPS and collect qualitative feedback on the biggest pain points. This takes 1 week.
  • Fix the top 3: Address the three most-cited friction points in the next quarter. Resist the temptation to rewrite the platform. Fix specific, concrete problems. “Deployments take 25 minutes” is a solvable problem. “The platform needs a new architecture” is a project that will take a year and delay relief.
  • Communicate improvements: When a friction point is resolved, communicate the change directly to the developers who reported it. This closes the feedback loop and builds trust that the platform team listens. In one organization, this practice alone improved NPS by 15 points before any technical changes shipped.
  • Create a developer advisory board: 4 to 6 developers from different teams who meet monthly with the platform team to review priorities and provide input on upcoming changes. This ensures the platform roadmap reflects actual developer needs, not the platform team’s assumptions about developer needs.

The internal developer platform is the most visible expression of how an organization values its engineers’ time. A platform that respects developer time by being fast, intuitive, and genuinely helpful sends one message. A platform that wastes developer time with forms, approvals, and bureaucratic workflows sends another. Both messages are heard clearly by every engineer in the organization. The platform is not just infrastructure. It is infrastructure as conversation, and the conversation should be one of service, not control.