Design Patterns

The Paved Road Problem: driving workflow adoption across teams you don't control

You built the better workflow, and you have zero authority to make anyone use it. Here is how adoption actually happens — by pull, not decree, because the right way is genuinely the easy way.

Deep dive·platform & engineering-effectiveness·

Scope. A platform, enabling, or tooling team driving adoption of an internal workflow, tool, or golden path across teams it doesn't manage. Framework claims (Team Topologies, DevEx/SPACE, DORA 2024) are cited to primary sources; vendor figures (Netflix >90% on-road, Spotify Backstage) are single-source and flagged as such — re-verify before quoting. A sibling piece covers general engineering leadership; this one stays narrow on adoption mechanics.

Your new pipeline is faster, safer, and better documented than the six the teams are using today. You announced it. You wrote the migration guide. Three months on, two teams tried it, one rolled back, and the rest are quietly still on their own scripts. Nothing is broken — you just have no power to make anyone move, and it turns out that “it's better” was never a reason anyone acts on. Building the better thing was the easy half. Getting teams you don't control to adopt it is the real problem.

The verdict

  • You cannot decree adoption for teams you don't own — and you shouldn't try. Teams weigh their switching cost, not your elegance, and default to what already works for them. A mandate you can't enforce breeds resentment and shadow workflows.
  • The mandate reflex backfires. Decree adoption and you get “100% migrated” on paper and the old scripts in practice — adoption theater, and you lose the visibility a platform is supposed to give you.
  • The pattern that works is the paved road / golden path (Netflix, Spotify, Google): the opinionated, well-supported default that is genuinely easier than rolling your own. In Netflix's own words, they “don't mandate adoption… but encourage it by ensuring [it] is a far better experience than not using [it].”
  • Run it like a product; treat teams like customers. Voluntary adoption is the only real success metric — a captive internal audience does not guarantee it.
  • Win by pull, with a catalog of plays, not one big launch: lower friction below the alternative, scaffold with self-service templates, seed a lighthouse team, migrate by default, guardrails not gates, and strangle the old road incrementally.
  • Mandate only the safety floor. Security, compliance, and multi-tenant blast-radius controls are the rare hard gates — and even those work best bolted onto a paved road that makes compliance the path of least resistance.
One idea: you don't win adoption by getting more authority. You win it by making the supported path so obviously easier to use that authority becomes irrelevant.

Why “it's better” isn't a reason anyone moves

A platform, enabling, or tooling team has one structural handicap: it builds things for teams it has no authority over. In the Team Topologies vocabulary, you are a platform team and the teams you're trying to reach are stream-aligned teams — the ones shipping product. Your relationship to them is X-as-a-Service: they consume what you offer through a clean, self-service interface. Crucially, they are your internal customers, not your reports. You can't tell a customer what to do; you can only make something they'd choose.

That reframes the whole job. Shipping the workflow was the easy half. The hard half is that a competing “workflow” already exists on every team — the pile of bash, the copy-pasted CI file, the thing that already works for them. “Mine is better” asks them to pay a migration cost today for a benefit that's diffuse and future. Most won't. Not because they're wrong, but because the switching cost is real and concrete while the pull is weak and abstract.

The mandate reflex — and why it backfires

When pull is weak, the instinct is to reach for push: get a VP to declare the new workflow mandatory. It feels decisive. For teams you don't control, it reliably fails in three ways.

A decree you can't enforce breeds resentment. People push back against mandates, even reasonable ones. The moment adoption is framed as compliance rather than value, you've turned a potential advocate into someone hunting for the exemption.

It relocates the work into the shadows. This is the shadow-IT lesson, and it's well documented: banning the workaround doesn't stop the building, it moves it somewhere you can't see — strictly worse than the visible version. Teams keep their old scripts, wrap a thin veneer of “compliance” over them, and you lose the very visibility a platform is supposed to give you. In one survey of security professionals, 73% admitted using unsanctioned SaaS in the prior year — people who knew the policy and the reasoning and routed around it anyway.

It produces adoption theater. You can hit “100% of new services use the golden path” on paper while developers work around it at every opportunity. Adoption that comes from value is real; adoption that comes from policy is an illusion. The number looks great and means nothing.

The tell that you're in mandate territory. When the honest answer to “why are teams using this?” is “because they were told to,” you don't have adoption — you have a queue of people waiting for you to stop looking. The public reference point is Backstage: near-universal voluntary use inside Spotify, but adoption reportedly stalls around 10% in many organizations that stand it up and expect a captive audience to show up.

The paved road — the better default, not the only road

The pattern that solves adoption-without-authority has a name and a lineage: the paved road (Netflix), the golden path (Spotify), and the paved path (Google). All three describe the same move — make the supported way so much easier than rolling your own that leaving it becomes the expensive choice.

Netflix coined the framing. A paved road is “a set of tools and practices that are formally supported by centralized teams” who act as force multipliers, turning specialized knowledge into reusable building blocks. The governing sentence — the whole pattern in one line — is Netflix's own: they “don't mandate adoption of those paved roads but encourage adoption by ensuring that development and operations using those technologies is a far better experience than not using them.” By the company's reports, over 90% of Netflix engineers stay on the paved road, because going off-road takes more effort, not less.

Spotify gave it the other common name. A golden path is “the opinionated and supported path to build something” — a backend service, a website, a data pipeline. It grew from a real pain: as Spotify scaled, teams learned how to do things through hallway rumor (“rumour-driven development”), and that fragmentation became the bottleneck. The path is explicitly optional: “if you are an adventurer you can of course leave the Golden Path… but then you will not have the same support.”

Paved road, not the only road. The road is opinionated and strongly supported; the ditch is still open, just unpaved. You win adoption by making the supported path so much easier that leaving it is the expensive choice — not by fencing the ditch.

The control spectrum: nudge, gate, net, checkpoint

Google Cloud's platform team published a taxonomy that stops people from conflating “paved road” with “mandate.” It splits control into four mechanisms — and adoption lives almost entirely in the first row:

MechanismWhat it doesForce
Golden pathPre-configured, secure-by-default patterns that make the right choice the easy choice. “The best platforms don't block developers; they steer them.”Soft nudge
GuardrailAn automated barrier that prevents catastrophic outcomes — “to prevent catastrophic events, not to direct workflow.”Hard gate
Safety netReactive detection and recovery (alerts, auto-rollback) — doesn't prevent the crash, reduces the harm.Reactive
Manual checkpointHuman judgment for genuinely complex, accountable decisions (architecture / security review).Human

The other three exist so you don't have to gate the everyday path: reserve hard gates for the rare things that can hurt other people, and let everything else be a nudge. Google's own warning: “a platform with too many guardrails feels like a maze of restrictions.”

Run it like a product, treat teams like customers

Every adoption play below descends from one frame: your platform is a product, its users are customers, and adoption is the only real measure of success. Team Topologies makes this concrete with the Thinnest Viable Platform — the smallest set of APIs, docs, and tools that measurably accelerates other teams. Not the biggest platform you can build; the thinnest one that actually helps.

Camille Fournier, who ran platform engineering at scale, punctures the most seductive trap here: the captive audience. When you're “the only option,” it's tempting to assume adoption is guaranteed. It isn't — that assumption is exactly how “platform teams end up with several overlapping half-finished products.” Her framing of the actual job: the product work is not “tell everyone they have to use it.” It's finding “what will make it easy for them to migrate,” paired with real incentives — a higher SLO, easier access to compute — that make moving obviously worth it.

The reframe in one sentence. Stop asking “how do I get them to adopt this?” and start asking “why would a rational, busy team choose this over what they have today?” If you don't have a crisp answer, you have a product or a marketing problem — not an adoption problem.

The adoption plays — 12 moves that drive pull

No single play carries adoption; these stack. The first eight create the pull that makes teams want the road, the next three move existing work over once the road is genuinely better, and the last is the rare hard edge you reach for only after pull is real. The table is the catalog; the figure shows where each play sits on the adoption journey.

The 12 adoption plays — mix them; don't rely on one.
PlayWhat it isWhy it drives pull adoptionSource
1. Make it the path of least resistanceThe paved road has to be genuinely easier than rolling your own — measured in the developer's time and cognitive load, not in your architecture diagram.If the golden path is even slightly more annoying than the shortcut, the shortcut wins. When off-road is the expensive option, teams stay on.Netflix paved road; Google “steer, don't block”
2. Self-service scaffolding & templatesTurn the golden path into a button: fill a short form and get a repo, running CI/CD, catalog registration, and observability wired in. Spotify implements this as Backstage software templates; cookiecutter, a create-* generator, or a Terraform module do it at any scale.The template is the opinion, made executable — adoption costs a form, not a migration project.Spotify golden paths / Backstage; Team Topologies (XaaS)
3. Co-create with a lighthouse teamBuild with your developers, not for them: pick one or two real teams, build the path around their workflow, and let their success be the reference story.A working lighthouse adopter proves the road goes somewhere — worth more than any slide deck.platformengineering.org, “Lessons from the trenches” (Red Hat)
4. Start embarrassingly small, ship in weeksOne template, two pilot teams, a basic catalog — then iterate in public.Momentum and trust come from shipping something useful fast, not a six-month unveiling that lands to a shrug. The Thinnest Viable Platform is a strategy, not a compromise.Team Topologies (TVP); “Lessons from the trenches”
5. Optimize Day 2–50, not Day 1Creating a service is under 1% of its lifetime; win the boring long tail — deploys, on-call, upgrades, audits.Netflix's first console features weren't compelling enough to change habits; solving the daily grind is what makes adoption follow the relief.platformengineering.org, “golden paths that actually go somewhere”
6. Market it like a productReal docs, changelogs, office hours, demos, an internal launch — the developer-relations muscle, pointed inward.A technically perfect but undiscoverable path fails. Great teams tell a story about what they built and why it makes the whole org more effective; UX and clarity beat feature count.Camille Fournier, “Product for Internal Platforms”
7. Dogfood and embedUnderstand usage “not through surveys, but through writing code around the offering yourself,” and embed platform engineers inside partner teams.You feel the friction your users feel, then remove it — the fastest way to keep the road worth staying on.Camille Fournier, “Product for Internal Platforms”
8. Guardrails, not gatesPrefer a nudge that keeps people moving over a block that stops them: a CI check detects a vulnerable base image, auto-substitutes a patched one, and opens a PR explaining the change.Guardrails steer back to secure-by-default without halting the merge; gates breed workarounds.Google Cloud control mechanisms; Semgrep “guides not gates”
9. Migrate by default: opt-out, not opt-inMake the golden path what teams get unless they actively choose otherwise — new repos scaffold onto it, the shared pipeline points at it, the secure library is the one already imported.Defaults are the quietest, strongest lever; opt-out carries far more teams than any opt-in campaign, and legitimate exceptions still get a documented off-ramp.secure-by-default / Google Cloud; escape-hatch principle
10. Strangle the old road incrementallyUse the strangler-fig approach: route new work and one slice at a time onto the paved road behind a facade, let both run in parallel, and grow the new path around the old until the old one is safe to remove.Each migrated slice ships independently, so risk and effort stay small — no big-bang switching cost a busy team will refuse.Thoughtworks / AWS strangler-fig pattern
11. Deprecate & sunset the old road — on a real timelineOnce the road is genuinely better and migration is easy, announce a deprecation with a concrete date, stop supporting the old path, and pair it with a carrot (better SLO, less on-call).Pull gets you most of the way; the last holdouts need the alternative to actually go away — but only after the road is the obvious choice, or you're back to a mandate.strangler decommission; Fournier on migration incentives
12. The justified mandate: pave the compliance floorReserve hard gates for security, regulatory, and multi-tenant blast-radius controls — anything where one team's shortcut can hurt others — and bolt the mandate onto a paved road.Make the compliant path the easy default so “mandatory” is felt as “already done for me,” not another hoop. A mandate without a paved road is just friction with a memo.Google Cloud control mechanisms (hard gates)

That's the pattern and the plays — the working model. If you just need to act, stop here: build a genuinely-easier default, run it like a product, and let teams pull. The rest is proving it took, and the ways it fails.

How to know it's working — measure usage, not installs

The fastest way to fool yourself is to count the wrong thing. Portal logins and “templates available” are vanity metrics; they tell you nothing about whether the road is carrying traffic. Three signals matter more.

Active usage — unique developers actually running the workflow (CLI commands, API calls, pipeline runs), not who installed it once. A rising count means the platform is in the daily flow; a flat one means shelfware with a landing page. Percent of services on the golden path is the headline adoption number and the best leading indicator of whether delivery metrics will improve — and because you win by pull, the honest version is the voluntary rate: if the path is optional and 80%+ choose it, you've succeeded; under 50%, the problem is the path, not the people. DevEx signals (from the authors of SPACE) predict whether people want to stay: feedback loops, cognitive load, and flow state — measured with focused surveys plus system signals, not gut feel.

SignalTypeWhat it tells you
% of services on the golden path (voluntary)LeadingWhether pull is working, right now
Active users / active usageLeadingWhether it's in the daily flow vs shelfware
Time-to-onboard / time-to-first-PR / template-to-prodLeadingHow low the on-ramp friction actually is
DevEx: feedback loops, cognitive load, flowLeadingWhether people will stay by choice
DORA: lead time, deploy frequency, change-fail, MTTRLaggingThe outcome that justifies the platform's existence
The evidence is nuanced — say so honestly. DORA's 2024 research found internal developer platforms improve individual, team, and org performance — but heavy platform reliance was also associated with roughly an 8% dip in throughput and some delivery-stability cost, and teams should expect a temporary performance dip before the platform matures. The lever that reliably pays off is developer independence (getting work done without waiting on your team), worth about a 5% productivity gain; the factor that decides success is user-centricity. Translation: a paved road that reduces autonomy or adds a queue can go backwards. Build for self-service, or the metric moves the wrong way.

Where paved roads fail — the anti-patterns

Anti-patternWhat it looks likeThe fix
“If you build it, they will come”Ship the platform, expect adoption to follow the obvious superiority. It doesn't; superiority isn't self-evident to busy teams.Plays 3, 6 — co-create and market it. Adoption is earned, not deserved.
Paving a road nobody wantsBuilt in isolation from a spec, not from real pain. Netflix's first console features weren't compelling enough to change habits.User research first (Plays 3, 5). Validate demand before you pave.
Mandate-first rolloutLead with a VP decree instead of value. Produces resentment, shadow workflows, and adoption theater.Lead with pull; reserve mandates for the safety floor (Play 12).
The golden cage / railroadThe path is so rigid there's no escape hatch; it works for 80% and traps the other 20%, who resent it.“Not the only road” — documented off-ramps; pave a new road if enough teams go off-road.
Forced migration, no incentiveDemand teams move by a date with nothing in it for them but effort.Pair migration with a real carrot and make it incremental (Plays 10, 11).
Measuring installs, not usageCelebrate portal logins and available templates while real work routes around the platform.Track active usage and voluntary % on the golden path (see Measuring).

What to actually do Monday

If you're a platform team staring at low adoption: stop trying to push, and go make the road worth choosing. Pick one lighthouse team and build the golden path around their real Day-2 pain. Turn it into a one-command template. Make it the default for new work, with a documented off-ramp. Market it like a product and measure the voluntary percent on the path, not the logins. Reserve the mandate for the security and compliance floor — and even there, pave it so compliance is the easy default.

The whole pattern reduces to one uncomfortable truth: you don't have authority over these teams, and the fix is not to get more authority. It's to build something so obviously better to use that authority becomes irrelevant. Netflix said it in a sentence a decade ago, and it still holds — don't mandate the road; make it a far better experience than the alternative, and let people choose it.

References

  1. Netflix Technology Blog — Full Cycle Developers at Netflix: Operate What You Build (paved-road definition; “don't mandate adoption… far better experience”; force multipliers).
  2. Spotify Engineering — How We Use Golden Paths to Solve Fragmentation in Our Software Ecosystem (golden path = opinionated + supported; optional; 2020).
  3. Backstage / Spotify — Backstage 101 and InfoQ: How Spotify Leverages Paved Paths and Common Tooling (golden paths as software templates).
  4. Google Cloud Blog — Platform engineering control mechanisms (golden paths / guardrails / safety nets / manual checkpoints; when to gate), Darren Evans, 2025.
  5. Team Topologies — Key concepts (platform team, X-as-a-Service, internal customers) and Thinnest Viable Platform examples.
  6. Camille Fournier — Product for Internal Platforms (captive-audience trap; migration incentives; dogfooding; “not tell everyone they have to use it”), 2020.
  7. platformengineering.org — Building your golden path: Lessons from the trenches (build with, not for; start small), Castelo & Lago (Red Hat), 2026.
  8. platformengineering.org — How to pave golden paths that actually go somewhere (Day 2–50; Netflix console habit-change lesson), Aeris Ransom, 2023.
  9. Mia-Platform — Paved Roads, Golden Paths, Guardrails and Railroads (golden-cage / railroad anti-pattern; escape hatches), 2025.
  10. Semgrep — AppSec guides, not gates (guardrail = redirect without blocking; auto-PR pattern), 2024.
  11. Thoughtworks — Embracing the Strangler Fig Pattern and AWS Prescriptive Guidance: Strangler fig (incremental, not big-bang migration).
  12. InfoQ — DevEx, a New Metrics Framework from the Authors of SPACE (feedback loops / cognitive load / flow; ACM Queue 2023; Noda, Storey, Forsgren, Greiler).
  13. DORA — Capabilities: Platform engineering and 2024 Accelerate State of DevOps report (productivity gains; ~8% throughput tradeoff; independence; user-centricity).
  14. Datadog — Success metrics for platform engineering teams and Jellyfish — Golden paths your developers will actually use (active usage vs installs; % on the path as leading indicator).
  15. TechTarget — Behind the scenes, Spotify's Backstage a work in progress (external adoption stalls ~10% vs internal voluntary adoption).
  16. MindStudio — Banning Shadow IT Just Drives It Underground (mandates relocate work out of sight; the fast-lane fix).