Golden Paths and Paved Roads
What you'll learn: How to create opinionated workflows and best practices that guide developers toward standardized, secure, and efficient solutions within your platform.
The Core Idea
Golden Paths (also called "Paved Roads") are pre-approved, well-tested workflows that represent the easiest, fastest way for developers to accomplish common tasks. Rather than forcing developers into rigid constraints, you create attractive, friction-free routes that naturally guide them toward best practices.
Think of it like a national park: you can bushwhack through the wilderness, but the paved trail gets you to the waterfall safely, with clear signage, sturdy railings, and scenic viewpoints. Most visitors choose the path because it's easier, not because it's mandatory.
Why This Matters in Platform Engineering
Platform teams face a challenge: standardization versus flexibility. Golden Paths solve this by:
- Encoding best practices into reusable templates, pipelines, and automation
- Reducing cognitive load—developers don't reinvent security, monitoring, or deployment patterns
- Enabling autonomy—self-service within guardrails, not gates
- Accelerating delivery—proven patterns mean less debugging and rework
Key Characteristics
A well-designed Golden Path:
- Is opinionated but not rigid: default choices, with escape hatches for special cases
- Handles 80% of use cases: optimized for the common scenarios
- Embeds security, compliance, and observability by default
- Is discoverable and well-documented: clear examples, tutorials in your developer portal
- Evolves with feedback: continuous improvement based on developer experience
For example, a Golden Path for deploying a new service might include: scaffolding from templates, pre-configured CI/CD pipelines, automatic instrumentation, and built-in security scanning—all accessible through your developer portal.
Key Takeaway: Golden Paths guide developers toward standardized, secure solutions by making the right way the easiest way, balancing autonomy with organizational best practices.