Academy Track

How It Works

1. Topic or outline: Generate a full N-lesson Academy track
2. Write the lessons: MDX · ≥3 quizzes · ≥2 bespoke diagrams · BuildChallenge
3. Register the track: tracks.ts · tiers.ts · exams.ts · diagram + challenge exports
4. Build + test: tsc --noEmit · vitest · npm run build compiles every MDX
5. Sanitize gate: verify-pii.py + verify-codenames.py — no leaks
6. Create PR: Merge → Vercel deploy + Discord announce cron fires

Invocation Triggers

Use Cases

• Generate a full course track from a topic outline
• Add a new lesson to an existing Academy track
• Build an MDX-based educational module with quizzes and exercises

The Problem

Writing a course track by hand is the slowest kind of busywork. Every lesson needs prose, three application-style quiz questions, two diagrams that actually teach, and a runnable exercise — then all of it has to be wired into tracks.ts, tiers.ts, exams.ts, and the integrity tests without breaking the build. Skip the diagrams and you have a wall of text. Skip the registration and the lesson renders to nothing with no error. Academy Track does the whole assembly line and refuses to call a thin lesson done.

What It Does

1. 1
   Define the track

   Lock the name, slug, tier, lesson count, diagram prefix, and which lessons get a BuildChallenge. The next free lesson block is read off disk so numbering never collides.

2. 2
   Write each lesson MDX

   Per lesson: 800 to 2000 words of concrete teaching, three or more application-style quiz questions with explanations, a doctrine callout, and both bespoke diagrams rendered in the body. Prose-only does not pass.

3. 3
   Build diagrams and challenges

   Each diagram is a hand-built React component in the house palette — grids, flow arrows, decision trees, not styled bullet lists. Hands-on lessons get an id-based BuildChallenge with a real stub, TODOs, and a correct reference solution.

4. 4
   Wire into the registry

   Export every diagram in index.ts, register the challenge module in buildChallenges.ts, append the track to tracks.ts, add the slug to its tier in tiers.ts, and bump the exact lesson and track counts the integrity tests assert.

5. 5
   Build, test, sanitize

   Run tsc, vitest, and npm run build — the build compiles every MDX and is the real gate. The PII and codename gates run because the academy is publicly served.

6. 6
   Open the PR

   Branch, commit the content plus all registration files, and open the PR. On merge, Vercel deploys and the date-stamped lessons fire the ingest and Discord announce crons.

What You Get / What It Doesn't Do

Tips

Get the Skill