A new paradigm where the knowledge creator — not the seeker — becomes the primary subject of the system.
Interactive Context Management · Internal Vision Document
The entire RAG literature — including Karpathy's LLM-wiki — is designed around one subject: the knowledge seeker. The pipeline exists to serve queries. Even sophisticated wiki patterns are fundamentally about making retrieval better for the person asking.
What IllTellYou's next phase proposes is a different subject entirely: the knowledge creator as protagonist. The system's job is not to serve queries — it is to help the provider improve, maintain, and trust their own knowledge. Retrieval becomes a side effect, not the goal.
Standard RAG has one relationship: query in, answer out. Interactive Context Management introduces three new relationships — none of which require a student to trigger them.
The provider interrogates their knowledge base as a student would — not to get an answer, but to see how their content is represented. Gaps, stale claims, and weak explanations become visible. Inline amendment follows naturally.
Every question asked by a student is a signal. Repeated questions reveal gaps. Poor answers reveal weak content. The system clusters these signals and presents them to the provider as prioritised improvement suggestions — without the provider needing to monitor sessions directly.
When a new source contradicts an existing one, or when a concept is mentioned across multiple sources with inconsistent definitions, the system flags it. No external audit required. The knowledge base acts as its own editor.
Starting from the knowledge creator's needs — not from retrieval requirements — yields four atomic operations. These are not features; they are the verbs of a new interface paradigm.
The provider asks the system a question not to get an answer for a student, but to see how their knowledge is currently represented. The output is a mirror for the author — revealing how the material would respond to a real query. The starting point for any amendment session.
The system proactively analyses the knowledge store and surfaces tensions — without being asked. No query needed; the system acts as an editor that never gets bored. Particularly valuable for wiki and multi-source memo categories where contradictions naturally accumulate over time.
The system processes session history, clusters questions by topic, identifies questions that received weak or incomplete answers, and presents them as ranked improvement suggestions. The provider decides whether to act. This transforms student sessions from ephemeral conversations into a permanent improvement signal.
A targeted, conversational correction that the system integrates into the existing knowledge base. Not a delete-and-replace workflow. Not a full re-upload. A surgical edit triggered inline from any of the other three operations — the natural conclusion of the reflect/challenge/learn cycle.
The primitives map onto IllTellYou's category system unevenly — and that's correct. A memo is almost entirely Reflect and Amend. A university course generates the richest signal for Learn. The architecture supports all four everywhere; which are surfaced in the UI is a category-level configuration.
| Category | Reflect | Challenge | Learn from interactions | Amend |
|---|---|---|---|---|
| Education | H | M | ★ | H |
| Wiki | H | ★ | M | H |
| Memo | ★ | M | L | ★ |
| Coaching | M | L | H | M |
| Family | M | L | L | H |
★ = Very High · H = High · M = Medium · L = Low
Interactive Context Management does not replace the RAG pipeline — it uses it as its substrate. The Has-A composition pattern already established in IllTellYou's codebase means ICM slots in cleanly without architectural rewrites.
Today the teacher portal has two modes: add content, and share. ICM introduces a third — "Tend your knowledge." Three entry points, each mapping to one or two primitives, each optional without affecting the core product.
The provider asks a question and sees what their own knowledge base would say — not a student's query, but a provider's audit. Gaps and weak answers are immediately visible. Inline amendment available after any response.
The system analyses the full knowledge base and returns a structured report: contradictory claims between sources, outdated facts, concepts mentioned with inconsistent definitions, orphaned material with no cross-references.
Clustered questions from all student sessions, ranked by frequency and answer quality. The questions that revealed gaps in the material are surfaced first. Each cluster links directly to the relevant content — or to the absence of it.
The raw Qdrant RAG pipeline — already built — defines the Pro experience. ICM defines Gold: knowledge that improves itself over time, powered by background LLM analysis and persistent memory.
Every competitor — ChatPDF, NotebookLM, custom RAG deployments — optimises the query path. None of them treat the knowledge creator as the primary subject. That is the opening.
"The shift from 'RAG platform' to 'Interactive Context Management' changes what we are building. Every competitor is a retrieval system. ICM is an authorship system. The students benefit downstream — but the provider is the one the platform serves most deeply."
— IllTellYou · Internal architecture notes, 2026