Skip to content
jisome

How it decides

It has an opinion, and here is where the opinion comes from.

It answers a different question

Most recommendation engines answer “what do you like?” This one answers “what do you actually need?” Those produce different books. Ask for a relationship book and a normal engine gives you one, because it has no opinion and so cannot tell you that your relationship problem is a money problem.

The stated want is usually a symptom. Someone who wants to start a business with no savings does not have a business-knowledge problem. The order is wrong, not the goal, and the difference between those two is the whole product.

Three books, because more is a list

Always three, always in order, with one thing to do between each pair. A thirty-book list is a wall. The first book reframes the constraint, the second gives you the repeated behaviour that fixes it, and the third applies it to what you originally asked about. So the last book is usually the closest to what you came for, and that is deliberate.

There are two actions rather than three, because an action after the third book would sit months out and could not be given a condition you could actually check. A vague action is worse than no action, especially as the last thing you read.

Every book is checked before you see it

The model proposes titles. It does not get to assert that they exist. Every proposal is resolved against the Open Library catalogue on both the title and the author’s surname, and anything that does not match confidently is discarded and regenerated. If it still cannot be confirmed, the slot is filled from a hand-checked list instead.

This matters more than it sounds. The model is an open one and the catalogue is an open one, which is the combination most likely to produce a confident reference to a book that was never written. Nothing unverified reaches this page, and that is enforced by a test over fifty situations rather than by hoping.

What is not checked is the sentence about why a book suits you. That is a judgement rather than a fact, so the system is forbidden from making claims about what is inside a book at all: the sentence is about your situation and the book’s place in the order. A run once attributed “pay yourself first” to a book that is not about money, and that is the sort of thing this rule exists to make impossible.

Some things it will not do

It will not prescribe a book in response to a crisis. Anything describing self-harm, abuse, a child at risk, acute distress or a deadline you cannot meet stops the whole process and routes to real services instead. That check runs on everything you type, before anything else, and if the check itself cannot run then nothing is prescribed either.

It will not invent a problem. If nothing is in the way, it says so and prescribes nothing, because an advisor who always finds something to fix is a recommendation engine with better manners.

It will not sell you anything. No prices, no affiliate links, no shop. The catalogue links go to catalogue records.

Where it is weak

The diagnosis takes a while, sometimes more than a minute, and the status line tells you what it is doing rather than pretending to be faster than it is.

Book availability in East Africa is a real constraint and this is honest about it rather than optimistic. Where the only confirmed route is secondhand, it says secondhand. It does not claim an audiobook exists, because no source it can reach actually knows.

And it can be wrong about you. That is what the control at the foot of every roadmap is for, and using it is the product working rather than failing.