Roadmap overview
Your roadmap is the path I build for you, end to end, from your evaluation to exam day. Three layers, in this order: phases → milestones → tasks.
Phases
A phase is a chunk of the certification that hangs together — usually one or two related domains. Every roadmap has between 3 and 5 phases, sequenced from your weakest domain to your strongest.
Each phase has:
- A title and short description (generated by
ARIA, specific to your gaps). - An estimated number of weeks based on your daily study minutes and target exam date.
- A status: active, locked, or completed.
Only one phase is active at a time. The next one stays locked until you finish the current one.
Milestones
Each phase contains 2–4 milestones. A milestone is the actual unit of work — a focused topic group with a validation gate at the end.
Every milestone carries:
- A
domain_focus— which domain it belongs to. - A
topicslist — the subjects you will cover. - A
sessions_requiredcounter — how many roadmap sessions you must complete before validation unlocks. - A
validation_score_required— the score you need on the milestone validation test to pass. - An estimated minutes total.
Milestone count scales with your starting level: Novice domains get the most milestones, Proficient get the fewest. That is the whole point of the evaluation — I do not waste your time on what you already own.
Tasks
Tasks are what you actually do day to day. The dashboard surfaces one task at a time via the Today Task card, picked by get_today_task() every time you reopen the app. Tasks are either:
- Roadmap tasks — they advance milestones and count toward the pass guarantee.
- Free-play tasks — optional, improve your readiness score, never advance milestones.
The split between these two is critical. See Two lanes for the full explanation — it is the most common source of confusion.
State badges
Every milestone shows one of these statuses on the timeline:
| Badge | Meaning |
|---|---|
| Active | Currently unlocked. Work here. |
| Locked | Earlier milestones must finish first. |
| Validate (validation_ready) | Sessions done. Time to take the validation test. |
| Completed | Validation passed. |
| Failed | Validation failed. You can retry. |
| Restructured | Failed twice. I rewrote the approach. Read the notes before retrying. |
The phase itself can also be on track, slightly behind, at risk, or off track — that pill at the top of the roadmap reflects your pace against your target exam date.
How I generate it
The moment your CAT evaluation closes, I take your domain scores and levels and feed them, alongside your daily-study-minutes preference and target exam date, to ARIA's roadmap generator. She:
- Decides phase count (3–5) based on the breadth of weak domains.
- Sequences phases worst-to-best.
- Allocates milestones per domain by level.
- Writes the whole structure into your account in one transaction.
- Picks your day-1 task.
If you regenerate (rare — usually triggered by a manual reset), I tear down the old phases and milestones cleanly first. There is no zombie state.
Reading the timeline
The roadmap screen is a vertical phase list. Each phase card expands to show its milestones. Tap any milestone to open the detail view — that is where you launch sessions and read restructure notes.
The header shows your readiness score (0–100) and your schedule status. Both are live — they update after every roadmap session.