Skip to content

Enforce concise, single-move tutor responses #47

Description

@rosshd

Parent: #41

Follow-up to: #42

Problem

The tutor prompt asks for concise, atomic teaching moves, but live responses frequently combine multiple explanations, examples, concepts, and checks.

In the dogfood run, four of six responses exceeded 100 words.

The strong-answer response used roughly 190 words, introduced parameters, arguments, object references, mutability, and another check, and claimed a slide position that persisted state did not support.

The off-topic response listed four IDE products before returning to the lesson.

This increases cognitive load, slows coverage, and creates more opportunities for factual or state inconsistency.

Goal

Make each tutor turn deliver the smallest useful teaching move for the learner's demonstrated state.

Response policy

  • Correct answer: confirm specifically and transition without re-teaching demonstrated knowledge.
  • Partial answer: acknowledge the useful part, correct one gap, and ask one targeted production or transfer check.
  • Incorrect answer: identify one misconception, give the minimum contingent help, and request one repair attempt.
  • Stuck learner: give one worked example or alternate explanation, then one faded completion or self-explanation task.
  • Off-topic question: answer briefly and redirect without an inventory dump or graded transition question.

Acceptance criteria

  • The tutor move contract permits at most one primary teaching move and one learner action per response.
  • Strong answers receive brief confirmation and forward progress without redundant explanation.
  • Struggling responses isolate one sub-concept instead of introducing adjacent concepts.
  • Off-topic answers are brief and return to the active learning goal.
  • Learner-visible slide, unit, progress, and mastery claims come from authoritative state rather than model inference.
  • Checks are unambiguous and target the gap addressed in the same turn.
  • Prompt and deterministic tests cover each response policy branch.
  • Live dogfood rubrics flag unnecessary length, multiple simultaneous concepts, and invented state claims.
  • make check passes.

Priority

P0 teaching-quality and trust blocker.

Metadata

Metadata

Assignees

No one assigned

    Labels

    P0Release blocker for v1.0enhancementNew feature or request

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions