CONTEXT.md

Syllo

Syllo turns source material into roadmaps where a learner can plan, study, read, and track progress.

Language

Roadmap: The learner's editable collection of modules, tasks, resources, notes, review cards, and settings for one goal. Avoid: Workspace, course, project

Module: One skill inside a Roadmap, holding the tasks, notes, and resources that teach it. Avoid: Section, chapter, lesson

Level: One rung of a Roadmap's ladder: Basics, Intermediate, or Advanced. A Level is complete when all its Core Items are done. Roadmaps made before levels existed read as a single Level whose tasks are all core. Avoid: Stage, tier, difficulty

Current Level: The first Level in a Roadmap that is not complete. Avoid: Active level

Core Item: One of at most five tasks per Level that cover the essentials, usually a video. Finishing every Core Item in a Level unlocks level-up. Avoid: Required task, main video

Go-Deeper Item: An optional task in a Level that is not core. It never counts toward level-up. Avoid: Bonus, extra

Reading Track: The books in a Roadmap, kept apart from the Levels so reading never blocks level-up. Avoid: Book list, library

Focused Roadmap: A Roadmap the learner has chosen to work on now. At most three Roadmaps are focused at once; only focused Roadmaps feed Today. Avoid: Active roadmap, pinned roadmap

Next Step: The first unfinished Core Item in a Roadmap's Current Level. Go-Deeper Items and the Reading Track never count. Avoid: Current task, up next

Today: The queue of actions waiting for the learner: resuming a video, review cards due, the Next Step of each Focused Roadmap, Picks to approve, and the next book chapter. Avoid: Dashboard, home feed

Pick: A resource Scout proposes for a goal, waiting for the learner to keep or skip it. Avoid: Suggestion, result

Learning Session: A period in which a learner works in one Roadmap and produces progress, review, timing, or achievement changes. Avoid: Visit, browser session

Learning Record: The durable history of learning activity across Roadmaps, including streaks, achievements, and daily task counts. Avoid: Analytics data, usage data

Roadmap Intake: The conversion of source material and learner choices into a validated Roadmap draft, either from a goal through Scout or from the learner's own notes. Avoid: Parsing, generation