Roadmaps
A roadmap is a learning path drawn as a map: the topics, milestones, tasks and projects between where you are and what you want to be able to do. You generate one, follow it node by node, and back up the important milestones with proof.
Open Learn → Roadmap AI in the sidebar. The sidebar entry appears once you are signed in. A public roadmap can also be opened from a shared link without signing in, but generating a roadmap, checking off progress, opening a node's resources and AI Assist all need an account.
Browse first
The Roadmaps page shows totals (Roadmaps, Learners, Completed,
Public), a search box — by title, #tag or keyword, Ctrl + K
— and the same tabs as Learn AI: For You, Continue, Explore,
Most Liked, Editor Picks, Most Interacted, My Likes and
My Roadmaps. Filter by level.
Following someone else's public roadmap costs nothing.
There is no separate Follow button. Open a roadmap and check your first node: from then on it counts as yours to track, shows your percentage on its card, and appears on the Continue tab here and in Learn AI, and under Continue Learning on Feeling Lucky.
Generate a roadmap
- Select Generate next to the search box.
- Answer What do you want to learn? — 4 to 120 characters. Be specific: "Become a junior DevOps engineer" works better than "DevOps".
- Choose your Starting level.
- Choose Visibility: private or public. You can change it later.
- Confirm. It costs 25 Jolt.
The roadmap appears stage by stage as it is generated, so you can start reading before it finishes.
A few rules about generating:
- Private is the default. The form remembers the level and visibility you chose last time.
- The 25 Jolt is taken when you confirm and returned automatically if generation fails. Keep the page open until the roadmap is saved: leaving the page stops the generation, and the Jolt is returned.
- Private really is private. Other users who open the link see Private roadmap. Only you (and platform administrators) can open it.
- From a syllabus. A course in Syllabus AI has a Generate Roadmap button that fills this form for that course and asks you to confirm the same 25 Jolt (Generate Course Roadmap). Once a course has roadmaps, the button becomes View Roadmaps.
Manage your roadmap
The gear menu on your roadmap's card has:
| Option | What it does |
|---|---|
| Make Public / Make Private | Switch visibility |
| Show Generation Prompt | The request the roadmap was generated from. Owner only, free. |
| Delete Roadmap | Removes it. You are asked to confirm, and it cannot be undone. |
Reading the map
| Node | Meaning |
|---|---|
| Topic | Something to learn |
| Milestone | A point where you should be able to do something concrete |
| Task | A specific exercise |
| Project | Something to build |
| Decision | A fork — pick the branch that suits you |
| Note | Context or advice |
| Grouped | Several related nodes together |
The side panel has two tabs:
- Progress — how far you are, and your proof checkpoints.
- AI Assist — a chat that knows this roadmap. Locked until you unlock it for 25 Jolt, once per roadmap.
Work through the roadmap
Every node except a Note has a checkbox. Checking it saves your progress at once and moves the percentage bar; unchecking it undoes that. Notes are there to read and never count.
Select a node's name (you need to be signed in) to open its dialog:
| Part | What it gives you |
|---|---|
| Free Resources | Links found for that topic |
| Matched Lessons | Existing Learn AI lessons on the topic, free to read |
| Mark as Complete | Only on milestones, tasks and projects — opens the declaration described below |
| Take a Quiz | A self-evaluation quiz on this node. Pick Easy, Normal or Hard; it costs 1 Jolt, charged only if the quiz is created, and opens as a spot quiz |
| Generate New Lesson | Opens Learn AI in a new tab with a request already written for this node. The usual 25 Jolt applies when you confirm. The new lesson is linked to this roadmap node. |
AI Assist on a roadmap
- Free on your own roadmap. Roadmaps you generated have AI Assist open at no cost; the unlock dialog says so (Roadmap owners get free access without spending Jolt).
- 25 Jolt once on anyone else's roadmap. The dialog shows the cost and your balance first.
- 500 messages per unlock. When you reach the cap you see Message Cap Reached; Unlock More Messages adds another 500 for another 25 Jolt.
- Signed-out visitors see Sign in to use AI Assist.
Proof of competence
Some checkpoints on a roadmap ask for proof: evidence that you actually did the thing, not just checked it off. This is what makes a completed roadmap mean something.
The Progress tab shows Proof of Competence — N / M checkpoints declared. Without evidence your progress stops short of 100%: the page tells you the cap ("Without evidence, progress caps at …") and how much evidence you still need.
How the percentage works, in plain terms:
- Checking nodes (or declaring checkpoints) moves you up to the cap.
- The last part of the bar unlocks only with evidence attached to some of your checkpoints — not necessarily all of them. The Progress tab shows how many, as N/M evidence needed for 100%, and Evidence requirement met once you have enough.
- The cap and the share of checkpoints that need evidence are set by your platform, so read the numbers on the tab rather than assuming them.
- A roadmap counts as Completed when you reach 100%.
Declare a checkpoint complete
- Select the checkpoint (Click to declare), or Add evidence.
- Attach evidence — either:
- a PDF, up to 10 MB, or
- a public URL — a repository, a deployed site, a write-up.
- Add Notes if they help the reviewer understand what you did (optional).
- Confirm that the work is your own, and submit.
You see Declaration Submitted. If you need to change what you sent, use Re-submit with new evidence.
Details that matter:
- Several items are fine. Drop more than one PDF (PDF only, max 10 MB each; other file types and larger files are skipped) and add as many links as you like with Add.
- The self-declaration appears only when you attach evidence. Check I agree to the above declaration to submit; it is timestamped and recorded with your name.
- It counts at once. Submitting marks the checkpoint as done and updates your percentage immediately (Proof of competence submitted successfully!). You do not wait for an approval.
- Re-submitting replaces the old declaration. The earlier evidence is removed and the new set is kept.
A link to a public repository with a short README, or a live URL of the thing you built on your lab, is the fastest to review. A PDF works for reports and certificates.
Next steps
- Learn AI — generate a lesson for any node you are stuck on
- Discussions — ask the community
- Publishing your lab — a live URL makes strong evidence