3 minute read Platform Engineering

Introduction

As platform engineers, we’re tasked with a balancing act:

  • Too little structure → every team builds things their own way, leading to fragmentation, duplication, and friction.
  • Too much structure → engineers feel boxed in, creativity suffers, and workarounds multiply.

That’s where the concept of a Golden Path comes in.

A Golden Path is the opinionated, paved road that helps teams ship software faster, safer, and with less mental overhead, without making them feel like they’re on rails they can’t escape from.

Done right, it’s the backbone of a great developer experience.

What Is a Golden Path?

A Golden Path is a well-documented, supported way of doing something within your engineering org, like spinning up a new microservice, configuring observability, or deploying to production.

It includes:

  • Templates or scaffolds
  • CI/CD configurations
  • Infra modules (Terraform, Helm, etc.)
  • Pre-baked observability setups
  • Access policies and secrets handling
  • Clear documentation, examples, and linters

It’s not a mandate. The Golden Path is the easy way, not the only way.

Why Golden Paths Work

Golden Paths are effective because they reduce onboarding friction, lower the cognitive load for common tasks, encourage consistency across services and teams, encode best practices into reusable assets, and make compliance and governance invisible.

The principle of “Don’t make me think” applies just as much to infrastructure as it does to UI design, making these paths invaluable for scaling developer productivity.

How to Design an Effective Golden Path

1. Start With User Research

Golden Paths aren’t about what’s easiest to support, they’re about what’s most helpful to engineers.

  • Shadow teams doing common tasks
  • Interview new hires about onboarding pain
  • Run feedback sessions on existing tooling

2. Pick High-Leverage Use Cases First

Don’t try to boil the ocean. Choose high-friction, high-frequency areas like:

  • Creating a new service
  • Deploying to production
  • Adding logging and metrics
  • Setting up authentication

Then pave those first.

3. Bake in Guardrails, Not Walls

Opinionated doesn’t mean inflexible.

✔️ Make it easy to follow the path ✔️ Warn when deviating ✖️ Don’t prevent deviation

Examples:

  • Lint for non-standard patterns, but allow overrides
  • Provide templates with sane defaults, but support custom config
  • Wrap tools in UX-friendly CLIs, but expose the raw tools for power users

Guardrails guide. Gates block.

4. Automate the Boring Stuff

Engineers shouldn’t have to:

  • Manually configure CI pipelines
  • Copy-paste Dockerfiles
  • Wire up metrics and alerts from scratch

Use:

  • Service creation CLIs (create-service)
  • GitOps + templating (Backstage, Cookiecutter, Yeoman)
  • Platform APIs (e.g. ArgoCD, Terraform Cloud, Crossplane)

The best Golden Paths feel like magic—things “just work.”

5. Document Like a Designer

Bad docs kill good paths.

  • Use concrete examples, not just abstract rules
  • Prefer screenshots and terminal recordings over wall-of-text guides
  • Document trade-offs and escape hatches

And most importantly: keep the docs versioned with the path itself. Your path is code, and your docs should live alongside it.

6. Measure and Improve

Treat your Golden Path like a product.

Track:

  • Adoption rates (% of services using the path)
  • Time-to-onboard for new engineers
  • Support tickets or Slack questions per week
  • Pull request feedback on path templates

Iteration matters more than perfection. Ship, observe, refine.

Common Pitfalls (and How to Avoid Them)

Pitfall Solution
Golden Path is too rigid Allow opt-outs and support plug-ins for customisation
Engineers feel forced Position as the “easy way,” not the “only way”
Templates get stale Make the platform team responsible for regular updates
Tooling too fragmented Standardise on a small set of core interfaces
Teams build their own paths Invite teams to contribute improvements upstream

Conclusion

Golden Paths are how great platform teams scale developer experience.

They provide just enough structure to help engineers move fast, stay secure, and focus on their product, not YAML files and infrastructure rabbit holes.

But the magic lies in the balance: opinionated, not authoritarian. Helpful, not heavy-handed. That’s the difference between a paved road and a walled garden.

Leave a comment