How I Designed Rule Referee's Engine Around Human Thought
By Autumn Wohlwend · · 10 min read · Updated Oct 2026
A look at the four-layer engine behind Rule Referee: semantic memory, intent normalization, deterministic retrieval, and clarification. Built to be consistent.
Quick answer
Rule Referee's engine works in four stages: semantic memory, intent normalization, deterministic retrieval, and clarification. Each stage does one job and can stop the process when something doesn't make sense. When a question could mean more than one rule, the engine asks instead of guessing, and nothing is ever generated.
When I started building Rule Referee, I wasn't trying to build another chatbot. I was trying to build something that would give the same answer every single time, no matter how the question was phrased.
Most chat-based tools operate like a single blended mind. Memory, interpretation, retrieval, and language generation all happen at once inside one step. The result can feel impressive, but it's also fragile. When uncertainty appears, the system fills the gap with confidence instead of clarity.
That isn't how humans think.
Human reasoning happens in layers. We remember. We interpret. We recall. We pause. And when something doesn't make sense, we ask questions before answering. I wanted to build Rule Referee's engine the same way.
Thinking in Layers Instead of Prompts
Rather than treating retrieval as one continuous act, I broke the engine into distinct layers, each with a single responsibility. Not because it's elegant, but because it mirrors how human cognition actually works.
At a high level, Rule Referee moves through four stages:
- Semantic Memory
- Intent Normalization
- Deterministic Retrieval
- Clarification and Interruption
Each layer is allowed to do only one job. More importantly, each layer is allowed to stop the process if something doesn't make sense.
In human terms, this is the difference between answering quickly and answering carefully.
Inside the app, those four stages run in two parts: a rules engine that finds the rule and a conversation layer that handles follow-ups and clarifying questions. You can see both in the Rule Referee architecture.
Semantic Memory: Storing Meaning, Not Text
Humans don't store knowledge as transcripts. We store meaning. Concepts, relationships, definitions, and examples live independently of the conversations we have about them.
I designed Rule Referee's knowledge base the same way.
Instead of raw text, every rule lives in a structured rulebook I designed for each game. Each rule includes a clear name, a straight forward summary, the core rule, examples, the common ways people ask about it, tags, and edge cases. This matters because a deterministic engine can only behave well if its memory is written to be retrieved. Ambiguous knowledge leads to ambiguous answers.
This layer behaves like long-term memory. It doesn't change just because a conversation does.
Intent Normalization: Translating Language Into Meaning
Players rarely ask questions in clean, precise phrasing. They circle ideas, skip context, use shorthand, and assume shared understanding.
Before retrieving an answer, the engine first stabilizes the question. It looks for the underlying intent and maps it to a form the system can reason about consistently. "Can I go again?", "Do I get another turn?", and "Can I keep going?" are all treated as the same intent, even though the wording is different.
This layer exists to reduce ambiguity before it becomes a problem. If intent can't be normalized cleanly, the engine does not guess. It pauses.
Deterministic Retrieval: Recall Without Improvisation
Human recall is not creative. When we remember a rule, we don't invent a new one. We retrieve what already exists.
This is the principle behind Rule Referee's retrieval layer.
Once intent is clear, the engine scores every rule in that game's rulebook against the question and ranks the best matches, with a confidence score. There is no improvisation and no best-guess generation at this stage.
- If one rule is a clear match, it is returned.
- If several rules match closely, ambiguity is surfaced.
- If nothing matches, the engine stops and says so.
This is not a limitation. It's a boundary. Rule Referee doesn't answer questions it doesn't have a verified answer for.
Clarification as a Cognitive Interrupt
One of the most important design decisions I made was treating clarification as a control flow decision, not a conversational habit.
In humans, uncertainty triggers interruption. We pause and ask for clarification before continuing. Rule Referee follows the same principle.
When a question could match multiple rules, Tally responds with "I'm not 100% sure which rule you mean" and surfaces the top three rule names that most closely match. The user replies with 1, 2, or 3 (or a few words from the option), and Rule Referee returns the answer for their selection.
Nothing is guessed. Nothing is generated. The engine simply resumes with better information.
Memory Without Authority
Rule Referee does maintain conversation context, for the game you're playing and only on your device. But context does not override the rulebook.
Past messages inform what the user is asking about. They do not redefine the rules themselves. A previous misunderstanding doesn't silently become truth.
In human terms, remembering a conversation doesn't rewrite what you learned years ago. This separation prevents drift and keeps the engine grounded across long sessions.
Tradeoffs I Accepted Deliberately
This approach is not optimized for spectacle.
It interrupts more often. It produces fewer "magical" answers. It requires more structure up front.
But I was willing to accept those costs for one reason:
I'd rather build a system that pauses than one that pretends.
Reliability is important, but it doesn't demo well. However, over time it's what makes a tool trustworthy, especially when correctness matters.
Why This Matters
By separating memory from interpretation, recall from generation, and confidence from uncertainty, Rule Referee becomes easier to trust and easier to extend without breaking.
I'm not trying to build something that sounds intelligent. I'm trying to build something that's honest about what it knows, consistent in how it answers, and designed to pause rather than guess.
That's the engine behind Rule Referee.
Rule Referee, the offline board game rules app
Plain English questions, rulebook-checked answers, and no internet needed at the table.
Under the hoodHow the Rule Referee engine works
The two layers behind every answer, and what happens when a question isn't covered.
Game libraryThe full game library
All 65 board and card games Rule Referee covers today.
An engine that pauses instead of pretending
Try it at your next game night. 5 games are free, and it works offline. See the full architecture.
