The Academy
Learn the system, one lesson at a time.
Three short tracks that take you from your first /go run to directing @yagni like a colleague. Read them in order, or jump to the surface in front of you.
The YAGNI Academy is the guided way to learn the system: short lessons, grouped into three tracks, that take you from the onboarding call and your first /go run to directing agent Teams with earned autonomy. Each lesson covers one surface or one habit, in the order teams actually meet them, with videos added as they are recorded.
Course I
Start here
What YAGNI is, how the onboarding call lands your first Brief, and what a /go run looks like. Orientation for the first week.
What is YAGNI and how does it work?
An orientation to YAGNI: coding agents that know your company, the Teams that carry ongoing scopes, and the approval gates that keep every consequential call yours.
Read the lesson Lesson 2How do you get your first Brief?
From the onboarding call to a Brief with real work in it: the GitHub App install, Teams built in the room, and your developers on YAGNI Code the same day.
Read the lesson Lesson 3What is YAGNI Code and how does a /go run work?
The CLI and desktop coding agent: drop-in with your skills, plugins, and MCPs, the /go pipeline from repo map to opened PR, and the meter that prints as you go.
Read the lesson Lesson 4How do you set up MCP servers in YAGNI Code?
Bring the MCP servers your team already uses into YAGNI Code: repo .mcp.json files work as-is, a one-command import moves your Claude Code setup, OAuth logins open from the session panel, and vendor-approved remote servers are the one honest edge case.
Read the lesson Lesson 5How do you export YAGNI Code telemetry to Datadog?
Send every YAGNI Code session in your workspace into Datadog: one admin setup in Settings, the Datadog direct-SaaS preset fills in the endpoint, and yagni doctor confirms Datadog accepted a real record. Traces, metrics, and log events carry tokens, cost, tier, and tool calls in the same shape Claude Code emits.
Read the lesson Lesson 6How do you connect Okta single sign-on to YAGNI?
The full Okta SAML setup for a YAGNI workspace: create the app, exchange the two sets of values, map your admin groups, and turn on the Okta tile. About ten minutes of copy-paste.
Read the lessonCourse II
Running your day
The Feed, your email, the Calendar, and Work: the Decisions you answer and the Receipts that keep the record honest.
How does the Feed work in YAGNI?
The Feed is the stream of Decisions your Teams have staged: one item, one chat, the real artifact rendered in place. Approve, edit, decline, or talk it through.
Read the lesson Lesson 2How does YAGNI triage your email?
Email rides its own lane with two honest states: it needs you, or it is handled, with a Receipt proved from Gmail itself. How triage works and how to delegate it.
Read the lesson Lesson 3How does YAGNI track Work and prepare your Calendar?
Work is the record: by-Team lanes over live work-items, each with a case file you can act on in place. The Calendar is the agenda the workspace prepares against.
Read the lessonCourse III
Directing @yagni
Teams, the Playbook, and the connectors: how the org learns your team's judgment and earns its autonomy.
What is a YAGNI Team and what are its Responsibilities?
A Team owns an outcome: its Responsibilities, its Number, its Playbook, and its record. The agent workers engaged on it carry the execution. How the unit works and when to add one.
Read the lesson Lesson 2How does a Team's Playbook learn your rules?
The Playbook is the shared set of rules a Team has learned for how the work gets done. Where rules come from, what a Play is, and how the Ladder turns a record into autonomy.
Read the lesson Lesson 3How do you ask @yagni for help?
The pinned composer, the contextual rail, and the full-page Ask: one voice with one memory, grounded in your live tools, that can act as well as answer.
Read the lesson Lesson 4Which tools does YAGNI connect to, and what does it do with them?
Native connectors, engineering-first: GitHub, Slack, Jira, Confluence, Linear, Google Workspace, Notion, HubSpot, and Stripe, plus MCP servers and custom services.
Read the lessonThe best classroom is your own workspace.
Connect GitHub and read your first Brief this week. The lessons will still be here when you have questions.
or see how pricing works