Learning paths
The platform scores your contracts. The Academy teaches you why.
Four short paths that turn the design guidelines from a page you are marked against into something you can actually do. Written around the same dimensions the scorer uses, so what you learn here is what the platform checks there.
In preparation.The curriculum below is settled; the lessons are still being written, and there is nothing to enrol in yet. Each track links to the documentation that covers its ground today.
Told as stories
A guideline is easy to state and hard to care about. So the lessons carrying astorymark come with a short video in narrative form: a team that shipped a contract, what it cost them downstream, and what the rule would have saved. 9 of the 16 lessons are planned that way — the rest are short enough to read.
The curriculum
- FoundationComing soon
Contract-first foundations
Start from the document, not the code. What a contract is for, and what the platform does with it the moment you hand one over.
- Why the contract comes before the implementation Includes a storytelling video
- Anatomy of an OpenAPI document
- Your first onboarding: parse, validate, score, register
- Reading a scorecard without taking it personally Includes a storytelling video
Read today: Onboarding
- CoreComing soon
Designing for the score
One track per scoring dimension. What each one asks of a design, why it asks it, and how to fix a contract that grades badly.
- Foundational Compliance — what breaks generators downstream Includes a storytelling video
- Security — declaring the trust posture you actually meant Includes a storytelling video
- Developer Experience — writing for whoever reads it next
- Mock Readiness — examples good enough to serve
Read today: Design guidelines
- CoreComing soon
Beyond REST
The platform takes four contract formats. This track covers the three that are not OpenAPI, and when each is the honest choice.
- Event-driven contracts with AsyncAPI Includes a storytelling video
- Graph APIs and GraphQL SDL
- Describing a legacy estate with WSDL Includes a storytelling video
- Choosing a format, and living with the choice Includes a storytelling video
Read today: Catalog
- AppliedComing soon
Consuming the catalog
The other half of the lifecycle: finding an API somebody else registered and building against it without a meeting.
- Searching the catalog and reading a contract
- Generating a client you can trust Includes a storytelling video
- Standing up a mock from the specification
- Exposing catalogued APIs to agents over MCP Includes a storytelling video
Read today: Integration
You do not have to wait
Everything the first lessons will teach is already documented, and the fastest way to learn the scoring is to onboard a contract and read what comes back.