PlatformEngr® Platform fundamentals course

Platform engineering fundamentals for the AI era: printable course notes

Design a platform as a product for people and agents: mission and users, team topologies, a capability map, a golden path, an agent policy, a scorecard, an architecture decision record and a 90-day plan, all as files in Git with a check on every pull request.

These pages are the same content as the interactive course, on one page per module, for reading and printing.

Four pieces

PieceWhat it is
See the end resultNot the first step: a 20-minute preview. Clone the finished design, run its check, break one rule and read the files. Useful to know where you are heading.
Full course8 modules from an empty repo to a platform design with a decision and a 90-day plan: the platform as a product, teams, capabilities, a golden path, agents as users, a scorecard, and a capstone.
Reference repoThe finished design for the example company, and the check that reads it.
Your repoplatform-design: your platform's design as files. You create it in module 00.

Your setup

Commands in these notes use these values (shared with the interactive course, stored only in this browser).

Outline

ModulePartTimeYou areYou will
00 Orientation: a platform design you can checkOrientation15 minPlatform teamCreate your repo platform-design with the design check, and see the check run on GitHub.
01 What a platform is, and platform as a productThe product and its people25 minPlatform teamWrite platform.yaml: the mission, the users and their problems with evidence, the owner and the non-goals.
02 Teams and how they work togetherThe product and its people25 minPlatform and productWrite teams.yaml: five teams with their Team Topologies types, and how each pair works together and why.
03 The capability map: what the platform offersWhat the platform offers25 minPlatform teamWrite capabilities.yaml: eleven capabilities in seven layers, each with an owner, a status and the interfaces people use to reach it.
04 Golden paths: the supported way, not the only wayWhat the platform offers25 minPlatform and productWrite golden-paths/new-service.yaml: six steps from repository to production, each on an offered capability, with support and an escape hatch.
05 Agents: the platform's second kind of userWhat the platform offers30 minPlatform teamMake coding agents users of the platform: an agent user in platform.yaml, capabilities they can call, AGENTS.md in the golden path, and agents/policy.yaml with identity, scope, approval, budget and audit.
06 Measuring value: outcomes, not outputProve it20 minPlatform teamWrite metrics/scorecard.yaml: eight metrics for delivery, stability, adoption, experience and cost, each with a source, a baseline and a target, and a list of metrics to avoid.
07 Capstone: the first decision and the first 90 daysProve it35 minPlatform teamWrite ADR 0001 and plan/90-days.yaml for the example company, then an ADR of your own, unaided, through a pull request.

Between you and a real platform