Study Plan: PM Guide¶
The deepest single feature in Kwilo, explained for someone who has never seen the code. No AI guesses the ranking; it is one transparent rule.
Want the full visual explainer?
The richer, designed walk-through with a worked example is embedded below, and also opens full-screen: open the Study Plan explainer in a new tab.
The promise¶
A learner subscribes and we say: "We tell you exactly what to study next, ranked by what the exam actually asks, weighted by where you are weak." That's only honest if the order comes from real data, computed the same way every time.
The whole idea in one line¶
For every chapter, ask two questions and multiply the answers:
Priority = how much the exam cares × how weak you are
- How much the exam cares (Importance): counted from the real past-paper question bank. Same for every learner.
- How weak you are (Gap): from your own practice history. Personal to you.
Rank every chapter by that number. The top eligible chapter becomes "study this today."
Why multiply, not add¶
Multiplying means a chapter only ranks high when both are true: the exam cares AND you're weak.
| Exam cares a lot | Exam barely asks | |
|---|---|---|
| You are weak | ✅ Study this: high payoff | Low priority, few marks |
| You are strong | Don't re-drill, you own it | Ignore, waste of time |
The plan hunts the top-left box: tested and weak. A learner's most-tested chapter can still rank low if they already know it; their weakest chapter can rank low if the exam never asks it.
The engine¶
The flow: gate (Pro + b2c_user) → resolve the learner's goal → compute Importance (pluggable per exam) × Gap (universal) → sort → pick today's chapter (respecting prerequisites) → assemble the plan. If the question bank isn't loaded, it returns an honest empty state, never a fake plan.
The three learner states¶
- New / free user: sees a free outline teaser and an upgrade nudge. The conversion hook.
- Pro, no history yet (cold start): accuracy shows as a dash, order driven by exam importance alone, phase diagnose.
- Active Pro user: full personalized ranking, real accuracy, readiness climbing. Every practice session re-ranks.
A "no history" learner who practices one chapter becomes "active" on the next load. The plan is never stale.
What to remember¶
One rule: study what's both heavily-tested and where you're weak. One honesty rule: never invent a score we haven't earned: show a dash or degrade to empty, rather than fake a plan. Every rank is explainable to the learner who asks "why this chapter?"
Related¶
- B2C flow: where Study Plan sits in the paid journey
- Study Plan gate (feature doc): the freemium lock around it
- Full visual explainer