Documentation
Methods
How this platform estimates what you still remember, when to ask again, and how a language model can tutor without becoming an answer key.
This note describes the methods of the Elenchus study platform. It is not a research report, not a clinical guideline, and is not attributed to a named investigator. Hover or tap a dotted word for a plain-language definition.
1. Design
Elenchus is a system (Karpicke & Roediger, 2008; Roediger & Butler, 2011; Dunlosky et al., 2013). A learner studies a card by trying to produce the answer, not by rereading the back. That choice is the whole product. Rereading and last-minute cramming are easy and feel like studying; they are weak for later (Dunlosky et al., 2013). Testing is not used here as assessment of a person. It is used as the study event itself — the same idea that has been shown in medical education as (Larsen et al., 2008).
is the second constraint. Reviews are delayed until recall would start to fail (Cepeda et al., 2006, 2008; Wozniak & Gorzelańczyk, 1994). Making retrieval slightly harder on purpose is the (Bjork, 1994). The schedule is not a streak calendar and not a notification firehose.
Progress is reported as a written in meters. The mountain photograph in the header is that number, not a badge for opening the app. Color starts at 1.00 m. A set’s is computed when the set is written, so ten decks show how much climb is still left if every card is kept.
2. Setting and materials
The system runs in a browser on the learner’s own devices (a Windows PC, a Mac, a phone). Sign-in is optional for local study and used when the same library should follow the person. No classroom, no proctor, no sample recruited for a trial. The seeded exemplar is the January 2026 Texas Driver Handbook: official Appendix C items, chapter sets in one deck, plus sign recognition. Learners may add any other corpus.
A card has a front (the prompt), a back (the target), optional hint and media, and optional authored used only in Learn (multiple choice). Drill is a flip. Write is fill-in-the-blank against the back. Distractors never pollute Drill or Write. When distractors are missing, the client prefers same-chapter answers of similar shape over shuffling unrelated backs.
3. Measures
Tokens
Knowledge volume is counted in , not cards. A token is estimated as ceil(characters / 4) after whitespace collapse. That is the common portable approximation of a (see Sennrich et al., 2016), not a claim about any vendor . A fifth-grader’s short fact and a board-exam paragraph are therefore not worth the same.
Density
Each set carries an : elementary 1.00, high school 1.35, college 1.80, professional 2.40, board exam 3.00. If the learner does not set a band, density is estimated from word length. These weights are a product convention so that harder material climbs farther per token. They are not a and should not be cited as one.
Hold and meters
Held tokens = tokens × density × . Meters = held tokens / 24. One meter is therefore 24 everyday tokens still held, or eight board-exam tokens still held. Reported is always shown to the hundredth of a meter.
The live header currently uses a stepwise hold: 0 if never reviewed, 0.18 if only seen, 1.00 if the card meets the (mastered, or interval ≥ 21 days with at least two successful reviews). That step is honest about “seen versus kept.” It is too generous about calendar time. The specified function, used to interpret a set a year later, is the FSRS curve described next — not a library-wide .
Span
When a set is added, its is the meters it would be worth if every card were retained today (hold = 1). The library span is the sum of set spans. The difference between span and current altitude is the climb still left. Ten sets do not “send someone into space”; they publish a ceiling. Whether the person is on that ceiling next year depends on review, not on the day the cards were pasted in.
4. Scheduling
Default scheduling is (Ye et al., 2022). Memory is tracked as , stability S (), and retrievability R. After each grade (again, hard, good, easy) the scheduler updates S and sets the next so that the review lands near the requested retention, default 90%. remains available as a fallback (Wozniak & Gorzelańczyk, 1994).
FSRS-5 writes forgetting as a , not a single :
R = (1 + (19/81) · t / S)−0.5
That shape matches the finding that forgetting is rapid at first and then flattens (Wixted & Ebbesen, 1991, 1997). Ebbinghaus’s curve for unused is much steeper (Ebbinghaus, 1885/1913; Murre & Dros, 2015) and is the wrong model for a handbook someone actually drilled. Under the FSRS-5 constants, predicted recall reaches 50% at about thirteen times current stability. A card that has only just become “retained” (S ≈ 21 days) is near half after roughly nine months without review. A card whose stability is a year is still near 90% at one year. There is no single “knowledge decays 50% per year” constant that the literature will support.
Long horizons need a floor. Bahrick (1984) found that Spanish learned in school dropped for about three to six years and then a remainder sat almost unchanged for decades — — with the size of that remainder set by how well the material was originally learned, not by the calendar. The platform therefore treats a well-retained card as able to keep a (on the order of 0.15–0.25) rather than falling to zero. That floor is a reading of Bahrick, not a new experiment.
5. Language models as tutors
Well-designed computer tutors can approach the effect of a human tutor (VanLehn, 2011). add open-domain dialogue, which is useful and also risky: they can (Kasneci et al., 2023). Elenchus does not let the model be the . The source of truth is the card. The model is a tutor in the sense Mollick and Mollick (2023) describe as a coach or devil’s advocate — it asks, it does not replace the back of the card.
Connection is the (Anthropic, 2024). Claude, Grok, or Gemini on the learner’s machine can call a small set of tools against the local library:
- get_library — catalog, per-set span, missing choices, total climb left.
- get_context — the full set plus a brief for discussing the concept, not dumping an answer key.
- add_from_chat — turn a question the learner just asked into a card, with the question stored as .
- set_choices — write three plausible distractors. Learn uses them. Drill and Write do not.
- due / review — the same FSRS grades the on-screen reviewer uses.
Prompts shipped with the server tell the model to generate distractors that a tired test-taker might actually pick, and to refuse to put those distractors on flip cards. When the learner is confused, the intended loop is: discuss the idea, then add a card from that confusion, then schedule it. The model is not asked to “know the handbook.” It is asked to work from the cards it just fetched.
6. Nudges when the learner is not in the app
Most forgetting happens between sessions. A tutor that only speaks inside the study tab is silent at the moment the schedule actually matters. The platform treats the language-model conversation as a second door into the same library. If the learner is talking to Claude or Grok about something else, the model can still read the due queue and the . That is the out-of-session channel that exists today: not a push notification, a tutor who is already in the room.
The decision rules follow design (Nahum-Shani et al., 2018) and the ordinary idea of a (Thaler & Sunstein, 2008). are already on the card: retrievability R, days since last review, count overdue, and the library “weather” (caught up, getting behind, overdue). Suggested rules, for a tutor that has just been opened:
- If weather is overdue and nothing has been reviewed in 48 hours: open with the smallest due set, one question, then stop.
- If a set’s held meters have fallen more than 10% of its span since the last session: say so in meters, not as a scold.
- If the learner is already talking about the topic: add a card from that question rather than changing the subject to “you have 40 due.”
- Never send more than one prompt per calendar day from the tutor. Never frame a lapse as a character failure.
Operating-system notifications are not required for this loop and are not claimed as part of the current method. If they are added later, the same rules apply: one timely ask, tied to a due card, easy to dismiss. A streak that punishes a missed day is not a nudge. It is a different product.
7. Limitations
The meter is a , not a neural measurement. Density bands are assigned, not validated against exam scores. FSRS parameters are the published defaults until a learner has enough of their own reviews to fit. Language models can still ; them in fetched cards reduces that risk, it does not remove it (Kasneci et al., 2023). Permastore is inferred from Bahrick’s decades-long Spanish data, which is recognition and recall of school learning, not a driver handbook and not a nursing exam. This document does not report outcomes. It reports how the platform is built, and which findings that construction is trying to respect.
References
- Anthropic (2024). Model Context Protocol specification. https://modelcontextprotocol.io/. https://modelcontextprotocol.io/
- Bahrick, H. P. (1984). Semantic memory content in permastore: Fifty years of memory for Spanish learned in school. Journal of Experimental Psychology: General, 113(1), 1–29. https://doi.org/10.1037/0096-3445.113.1.1
- Bjork, R. A. (1994). Memory and metamemory considerations in the training of human beings. In J. Metcalfe & A. P. Shimamura (Eds.), Metacognition: Knowing about knowing (pp. 185–205). MIT Press.
- Cepeda, N. J., Pashler, H., Vul, E., Wixted, J. T., & Rohrer, D. (2006). Distributed practice in verbal recall tasks: A review and quantitative synthesis. Psychological Bulletin, 132(3), 354–380. https://doi.org/10.1037/0033-2909.132.3.354
- Cepeda, N. J., Vul, E., Rohrer, D., Wixted, J. T., & Pashler, H. (2008). Spacing effects in learning: A temporal ridgeline of optimal retention. Psychological Science, 19(11), 1095–1102. https://doi.org/10.1111/j.1467-9280.2008.02209.x
- Dunlosky, J., Rawson, K. A., Marsh, E. J., Nathan, M. J., & Willingham, D. T. (2013). Improving students’ learning with effective learning techniques: Promising directions from cognitive and educational psychology. Psychological Science in the Public Interest, 14(1), 4–58. https://doi.org/10.1177/1529100612453266
- Ebbinghaus, H. (1913). Memory: A contribution to experimental psychology (H. A. Ruger & C. E. Bussenius, Trans.). Teachers College, Columbia University. (Original work published 1885).
- Karpicke, J. D., & Roediger, H. L., III (2008). The critical importance of retrieval for learning. Science, 319(5865), 966–968. https://doi.org/10.1126/science.1152408
- Kasneci, E., Sessler, K., Küchemann, S., Bannert, M., Dementieva, D., Fischer, F., Gasser, U., Groh, G., Günnemann, S., Hüllermeier, E., Krusche, S., Kutyniok, G., Michaeli, T., Nerdel, C., Pfeffer, J., Poquet, O., Sailer, M., Schmidt, A., Seidel, T., Stadler, M., Weller, J., Kuhn, J., & Kasneci, G. (2023). ChatGPT for good? On opportunities and challenges of large language models for education. Learning and Individual Differences, 103, Article 102274. https://doi.org/10.1016/j.lindif.2023.102274
- Larsen, D. P., Butler, A. C., & Roediger, H. L., III (2008). Test-enhanced learning in medical education. Medical Education, 42(10), 959–966. https://doi.org/10.1111/j.1365-2923.2008.03124.x
- Mollick, E. R., & Mollick, L. (2023). Assigning AI: Seven approaches for students, with prompts (Wharton School working paper). https://doi.org/10.2139/ssrn.4475995. https://doi.org/10.2139/ssrn.4475995
- Murre, J. M. J., & Dros, J. (2015). Replication and analysis of Ebbinghaus’ forgetting curve. PLOS ONE, 10(7), Article e0120644. https://doi.org/10.1371/journal.pone.0120644
- Nahum-Shani, I., Smith, S. N., Spring, B. J., Collins, L. M., Witkiewitz, K., Tewari, A., & Murphy, S. A. (2018). Just-in-time adaptive interventions (JITAIs) in mobile health: Key components and design principles for ongoing health behavior support. Annals of Behavioral Medicine, 52(6), 446–462. https://doi.org/10.1007/s12160-016-9830-8
- Roediger, H. L., III, & Butler, A. C. (2011). The critical role of retrieval practice in long-term retention. Trends in Cognitive Sciences, 15(1), 20–27. https://doi.org/10.1016/j.tics.2010.09.003
- Sennrich, R., Haddow, B., & Birch, A. (2016). Neural machine translation of rare words with subword units. In Proceedings of the 54th Annual Meeting of the Association for Computational Linguistics (pp. 1715–1725). Association for Computational Linguistics. https://doi.org/10.18653/v1/P16-1162
- Thaler, R. H., & Sunstein, C. R. (2008). Nudge: Improving decisions about health, wealth, and happiness. Yale University Press.
- VanLehn, K. (2011). The relative effectiveness of human tutoring, intelligent tutoring systems, and other tutoring systems. Educational Psychologist, 46(4), 197–221. https://doi.org/10.1080/00461520.2011.611369
- Wixted, J. T., & Ebbesen, E. B. (1991). On the form of forgetting. Psychological Science, 2(6), 409–415. https://doi.org/10.1111/j.1467-9280.1991.tb00175.x
- Wixted, J. T., & Ebbesen, E. B. (1997). Genuine power curves in forgetting: A quantitative analysis of individual subject forgetting functions. Memory & Cognition, 25(5), 731–739. https://doi.org/10.3758/BF03211316
- Wozniak, P. A., & Gorzelańczyk, E. J. (1994). Optimization of repetition spacing in the practice of learning. Acta Neurobiologiae Experimentalis, 54(1), 59–62.
- Ye, J., Su, J., & Cao, Y. (2022). A stochastic shortest path algorithm for optimizing spaced repetition scheduling. In Proceedings of the 28th ACM SIGKDD Conference on Knowledge Discovery and Data Mining (pp. 4381–4390). Association for Computing Machinery. https://doi.org/10.1145/3534678.3539081

