PlatformEngr® Platform fundamentals course

See the end result · about 20 minutes

A platform design for people and agents: a preview of where the course takes you

Clone the finished design of the example company and run its check. Read the four files that matter most: the mission, the capability map, the golden path and the agent policy. Then give a coding agent a person's token, the way teams do when they are in a hurry, and watch the check refuse it.

This is a preview, not the first step. It shows the finished design with few explanations, so you can see where you are heading. To learn it, start the full course: it builds the same design from an empty repo, file by file, and explains every decision.

This preview

The finished files and their check. Commands to copy, few explanations.

The full course

8 modules: the platform as a product, teams, capabilities, a golden path, agents as users, a scorecard, and a decision with a 90-day plan, all in your own repo.

Your setup

Every command below uses these values. They stay in this browser and are shared with the full course. Needs Git and Node.js 20 or newer. No cluster, no cloud account.

    What just happened

    platform.yaml ── who it is for, what it will not do teams.yaml ──── who owns what, and how teams work together capabilities.yaml ── what is offered ──> golden-paths/new-service.yaml ── for people and agents agents/policy.yaml ── what each agent may do, as whom, with which approval metrics/scorecard.yaml ── outcomes ──> plan/90-days.yaml ── see it, pave it, prove it

    The full course writes every one of these files with you, breaks each on purpose, and ends with a decision of your own.