Kizuki never overrules you and never accepts a disagreement without asking. When sources disagree, this order decides what is true:
A "Does this fit?" question shows the sentence of the material that differs from what you wrote. You choose one answer (answerSchema):
| Your choice | Saved as | Effect |
|---|---|---|
| The material is right. I got this wrong. | verdict material-right |
A miss: the session is not clean, and the sentence is listed under "What you got wrong". |
| The material is wrong. | verdict material-wrong, plus your version |
recordAnswers saves a correction (addCorrection) tied to the session, with your answer as its note. Your version is required. |
| Neither: Kizuki misread what I wrote. | verdict misread |
No miss and no correction. A small model sometimes sees a disagreement that is not there. |
Kizuki shows these three choices as a pick list, and asks for your version right after "The material is wrong". recordAnswers also checks in code: it refuses a round where a "Does this fit?" question has no choice, or where "the material is wrong" has no version.
Every source Kizuki shows gets a number, such as [2] Page 4 of ch1.pdf. In terminals that support links (iTerm2, Ghostty, WezTerm, VS Code), clicking it opens the file. /open 2 opens it from the keyboard and says which page to go to.
/correct 2 records a correction to that source. Kizuki shows the passage, then asks for the wrong words, your version, and an optional note. addCorrection refuses the correction unless the wrong words pass the word-for-word quote check against the passage.
Corrections live in corrections.jsonl as correction.added events (correctionEventSchema). From then on:
When the model points at a sentence it cannot read, Kizuki records a clarification.asked event with the fixed question UNCLEAR_QUESTION. /review asks the open questions one at a time, after the concepts and links; Enter with nothing typed skips one. Your answer (answerClarification) becomes "Your reading of “…”", shown under the passage to you and to the model in later sessions.