Skip to content
matthewcm.dev

    ↑ ↓ move · ↵ open · tab scopeopen graph →

    Golden Paths and the Recommended Routine

    The best developer platforms feel like a good beginner programme — opinionated, safe, explained, and easy to leave once you know why.

    Growingmetaphortended planted 3 min read
    On this page

    When I got serious about bodyweight training, I did what thousands of people do: I followed the Recommended Routine from the r/bodyweightfitness community. Warm-up, three pairs of exercises, a core triplet, three times a week. For each movement there’s a progression ladder, and one rule: start at three sets of five, add a rep per set each session, and when you hit three sets of eight with good form, move to the next step.

    It’s not the perfect programme for anyone. It’s a very good programme for almost everyone starting out, and that’s exactly why it works.

    What the routine gets right

    • It removes decisions. A beginner doesn’t need to understand periodisation to make progress. Pick your step on each ladder and go.
    • The defaults are safe. Rows are non-negotiable because they balance all the pushing. The warm-up exists because wrists and shoulders complain otherwise. Bad choices are hard to make by accident.
    • It explains itself. Every section links to the why. People learn the principles while following the plan.
    • It expects you to graduate. After six months or a year, most people move to a split, add skills, or design their own plan — and they do it well because the routine taught them what matters.

    That’s a golden path

    A golden path is the platform version: an opinionated, supported default that takes a team from nothing to a deployed, observable service without making fifty decisions. Repo, CI, logging, dashboards, alerts — one step.

    The parallels are close enough to use as a design checklist:

    Recommended RoutineGolden path
    Progression ladders with clear criteriaVersioned templates with clear upgrade steps
    Rows are non-negotiableSecurity scanning, observability and ownership are built in, not optional extras
    Every exercise links to the whyEvery default links to the decision behind it
    You can swap a progression if you lack equipmentSupported escape hatches for teams with real constraints
    People graduate to their own programmeTeams can leave the path — and own the extra work when they do

    Paved road, not a cage

    The routine isn’t enforced by anyone. People follow it because it’s the easiest way to get good results. That’s the property I care most about in a golden path: optional but attractive. If teams have to be ordered onto it, it isn’t easy enough yet.

    I’ve built one for designers on a low-code workflow platform — templates that gave them a working, well-structured workflow on day one — and the lesson was the same as in the gym. Adoption follows ease. Mandates create resentment and workarounds.

    Where the metaphor breaks

    A routine is a document; a golden path is software. Software rots. If a template copies code into every new service, those copies drift the day they’re created. The fix is the platform equivalent of keeping the routine in one wiki page: templates that reference shared, versioned modules rather than copying them, so improvements reach existing services.

    Also, beginners leave a routine when they outgrow it. Teams sometimes leave a golden path because it’s broken. Treat departures as user research, not disloyalty.

    Takeaways

    • Design for the beginner’s first success, and explain every default.
    • Make the safe choice the easy choice; make the non-negotiables few and obvious.
    • Keep it thin and versioned; reference modules, don’t copy them.
    • Measure whether teams actually find it faster — inside an Internal Developer Platform, adoption is the metric.
    • Expect graduates. A path that nobody can leave has become a cage.

    Related: Skill Trees as Platform Capability Maps for what comes after the beginner routine; SAID: Train for the Production You Actually Run for making the defaults realistic.

    • #golden-paths
    • #platform-engineering
    • #developer-experience
    • #paved-road
    • #training-principles

    ↪ Links to (4)