Learn

Check it out here

A site for more optimized learning. A course gets imported and displayed in nice and structured fashion. This functions as a study tool for both long and short term learning with review, notes, and quick lookup functionality.

A course is the specific thing you want to learn/study (like a class, or certain subject). You can ask an AI to easily design the course. The course is made by formatting the needed course data. The code and visual experience is handled by this site.

Using

Getting started

1. Make a course for the content you want to learn.
2. Click Add Course to browse the prebuilt library (which starts with DEMO), or import a course folder, .zip, or .course.json file from your device.
3. Click on the course to enter. There'll be a sidebar with all the course sections, and the different features:
   • Overview has an Index link at the top for course concepts and categories.
   • Review opens questions due from concepts or question types you've attempted. Choose Mixed practice there to practice a range of subsections, including questions that are not due. Question-bank courses share the same questions and history across lessons and practice; reserved check questions stay separate.
   • Dependency Map demonstrates how sections connect to each other.
   • Explore lets you find information by search and filters.
   • Saved shows the blocks you saved with notes.
4. Each section is split into subsections which is further split into blocks.
   • Each block represents some form of information.
   • Some blocks are hidden depending on the mode, but they can always be opened (there will always be a sign of it being there, so you're not missing anything).
   • You can click/drag down on the horizontal tabs on the bottom of the block to save a note (notes will appear in Saved).
   • Blank notes act as simple bookmarks that still appear in Saved.
5. The top right provides Study, Review, and Names modes. These correspond to the depth of information shown.
   • Study is like reading through a textbook. It shows the most, with the only things hidden being the In Depth blocks.
   • Review is like going through ones notes. Each block may have a description which is used instead of the full content. Certain blocks are also not hidden. This view is tailored by the course creator.
   • Names hides everything, showing the bare minimum.

Writing a course

To start working on a course:

#               id       name
npm run new -- ma26600 "Ordinary Differential Equations"

This will add a course to courses/ma26600.

You can then start working on the course within that folder. The changes can be validated with:

npm run validate -- ma26600
npm run validate:current -- ma26600  # require the current question schema
npm run validate -- --migration-report ma26600  # count legacy questions to migrate
npm run audit -- --profile draft ma26600  # report content debt while writing
npm run coverage -- ma26600 --init-review  # create low-topic review checklist
npm run audit -- --profile publish ma26600  # required before calling it publish-ready

node plugin/scripts/pack.mjs <id> creates a .course.json you can import into a site (not needed though, you can just import the course folder).

Write a course with AI

You can write a course in either paired, manual, or single mode. Single uses a single model to generate the course automatically. Paired uses a strong planner/reviewer model and a cheaper writer (subagent). Manual uses the same 2 models as paired, but you have to be the one to switch between them using the prompt below:

Expensive Model (planning)
> Create a course on [subject] from [source paths] in manual paired mode, without subagents. The learning goal is [goal].

This determines the needed scope, and saves a plan.

Cheap Model (writing)
> Continue the working course through all remaining writing and answer checks.

This resumes the saved plan, checks the first representative lesson before bulk writing, then completes the course.

Expensive Model (validation)
> Validate and finish the working course using narrow evidence packets.

This checks coverage and selected evidence, then finishes if clean or saves consolidated corrections.

Cheap Model (only if corrections are needed)
> Apply the saved corrections and verify affected answers. Save correction results with `author corrected`, then run checked `done --all`. Return the issue IDs and changed IDs to the reviewer; do not finish or accept the review.

Expensive Model (required after corrections)
> Review the changed items and affected context with `screen --changed`; expand any source or math evidence needed. Record acceptance with `reviewed --all`, then finish the course.

authoring/ are the general instructions for the AI. manifest.yaml selects rules to display by phase, role, and course shape. agents.toml defines the role of the AI agent. flow contract defines the course creation flow.

node tools/author.mjs begin ma26600 --mode paired --handoff manual --source /abs/textbook.pdf
node tools/author.mjs status ma26600
node tools/author.mjs index ma26600
node tools/author.mjs pilot ma26600 --sub s1-1 # before bulk writing
node tools/author.mjs done ma26600 --all
node tools/author.mjs screen ma26600 --all
node tools/author.mjs issues ma26600 --report .author/ma26600/issues-report.yaml
# writer corrects; then:
node tools/author.mjs corrected ma26600 --report .author/ma26600/correction-results.yaml
node tools/author.mjs done ma26600 --all
node tools/author.mjs screen ma26600 --changed
node tools/author.mjs reviewed ma26600 --all
node tools/author.mjs finish ma26600

Claude:

# to add as a plugin
/plugin marketplace add Jightning/learn
/plugin install create-course@learn

# adding as a plugin without installing
claude --plugin-dir plugin

Other Agents:

Run the following command

node plugin/install.mjs ~/my-courses   # for other agents, adds the AGENTS.md which links back to this repo

Development

Developing:

npm install
npm run dev

Building:

npm run build  # for dist/
npm run deploy  # builds, publishes to Cloudflare Pages, and keeps 2 newest deployments
npm run check  # engine checks against demo and _template; user courses are not read

Testing:

npm run test  # full testing

npm run test:unit
npm run test:integration
npm run test:browser

Adding a Public Course

After making a course, it can be made public by adding the course to the gitignore, and including it in tools/lib/files.mjs under PUBLIC_CATEGORIES.