The Librarian AI
Didactic means a book is trying to teach, correct, or steer the reader in a fairly direct way. Sometimes that can be useful. Sometimes it can even be powerful. But it is different from a book that trusts story, argument, comedy, beauty, or experience to do the work.
ClearShelf's didactic score is not a verdict on whether a book is good, moral, important, or worth reading. It is a narrower signal about how much the book feels like a living work versus a delivery mechanism for a conclusion.
A high score usually means the book is story-first, reader-first, or craft-first. A low score usually means the book is trying hard to manage the reader's response. Politics, religion, or strong convictions do not automatically lower a score. Heavy-handedness does.
How the score works
The Librarian AI looks for a few broad signals rather than pretending to compute literary truth.
- Story momentum: Is there real narrative life, curiosity, delight, tension, or usefulness beyond the message?
- Reader agency: Does the book leave room for the reader to think, or does it keep pushing toward a sanctioned conclusion?
- Character texture: Are people allowed to feel human and contradictory, or are they mostly examples and symbols?
- Message pressure: How much of the reading experience feels instructional, ideological, or morally managed?
The overall score is an editorial judgment, not a math formula. The examples below are here to make the spirit of the rubric legible.
Examples
Project Hail Mary by Andy Weir
ClearShelf score: 96/100
This scores high because the book's ideas arrive through tension, problem-solving, character chemistry, and delight. It wants to entertain first, then let its admiration for competence and cooperation ride inside the story.
- Story momentum 98/100
- The engine is suspense, discovery, and survival rather than lesson delivery.
- Reader agency 95/100
- The novel trusts readers to enjoy the science and draw their own conclusions.
- Character texture 89/100
- The emotional core is simple but sincere, and it earns attachment.
- Message pressure 6/100
- There is almost no sense of being managed toward an approved belief.
Winnie-the-Pooh by A. A. Milne
ClearShelf score: 99/100
This scores high because the book feels almost frictionlessly alive on the page: playful, gentle, funny, and entirely uninterested in turning its charm into a lesson-delivery machine. Even its sweetness feels earned by tone and character rather than pushed as correction.
- Story momentum 94/100
- The book moves by voice, play, and delight rather than by thesis or moral staging.
- Reader agency 98/100
- It leaves the reader wonderfully free to enjoy, notice, and dwell.
- Character texture 93/100
- The characters are simple but vividly themselves rather than symbolic placeholders.
- Message pressure 4/100
- There is some moral atmosphere, but almost no coercive feeling.
Anthem by Ayn Rand
ClearShelf score: 31/100
This scores low not because it has strong ideas, but because it is built as a thesis-delivery system. Characters and scenes mostly exist to carry the argument, so the reading experience feels steered rather than discovered.
- Story momentum 42/100
- The fable shape moves, but narrative life is secondary to the polemic.
- Reader agency 34/100
- The book strongly channels the reader toward one ideological conclusion.
- Character texture 24/100
- People function more like symbolic positions than fully alive characters.
- Message pressure 82/100
- The argument is the point, and the book rarely lets you forget it.
A Is for Anarchist by billy woods and m. musgrove
ClearShelf score: 12/100
This scores very low because it uses a children's alphabet format as direct ideological instruction. The issue is not the politics themselves; it's the minimal space left for play, ambiguity, or a child's own encounter with the world.
- Story momentum 8/100
- There is no real narrative frame carrying the reading experience.
- Reader agency 12/100
- The book tells the reader what to affirm instead of inviting exploration.
- Character texture 5/100
- It works in slogans and symbols rather than persons or situations.
- Message pressure 96/100
- The instructional purpose overwhelms every other dimension.
What the score is for
ClearShelf uses the score to decide what belongs on public shelves and how much caveat a recommendation needs. It is meant to help readers who want books with life in them, not to settle arguments about canon, politics, or taste forever.
The Librarian AI aims to be objective about the rubric, but it is still fallible, and the working document behind it is shaped with ongoing human judgment and touch. If you want the full underlying rubric and prompt, the raw working document is also published at /the-librarian-ai.md.