Hint Ladder

also known as Graduated Scaffolding, Hint Sequence, Smallest-Nudge-First

Withhold the direct answer and release help along a graduated ladder, starting with the smallest abstract nudge and increasing specificity toward a worked solution only as the learner stays stuck.

Context

A tutoring or coaching agent helps a learner work through problems they are meant to master, not just get past. The agent can produce the full solution instantly, and a learner who is stuck will often ask for exactly that. The pedagogical goal, though, is for the learner to do the cognitive work, so the agent's help has to support that work rather than replace it.

Problem

An agent optimised for helpfulness answers the question it is asked, which for a stuck learner means handing over the solution. That resolves the immediate request but removes the productive struggle that produces durable learning, and it does so invisibly because the learner feels helped. The agent needs a way to give just enough help to keep the learner moving without giving so much that it does the thinking for them.

Forces

A stuck learner wants the answer now, but the answer now is what prevents the learning the session exists for.
Too little help leaves the learner stuck and frustrated; too much help removes the struggle that builds the skill.
The right amount of help depends on the learner's current state, which changes with each attempt and is only estimated, not known.
Graduated help costs more turns and more judgement than simply answering, and a determined learner can still push for the full solution.

Example

A student stuck on a recursion exercise asks the tutoring agent for the answer. Instead of printing the function, the agent first asks what the base case should be. The student tries and fails twice, so the agent steps up and names the missing base case, then on a third failure shows the one line that handles it — and only if the student is still stuck does it reveal the full function.

Diagram

stateDiagram-v2 [*] --> Nudge Nudge --> Concept: still stuck Concept --> PartialStep: still stuck PartialStep --> WorkedSolution: still stuck Nudge --> Solved: progress Concept --> Solved: progress PartialStep --> Solved: progress WorkedSolution --> Solved Solved --> [*]

Solution

Therefore:

Define a ladder of help from least to most specific — an orienting nudge, a pointer to the relevant concept, a partial step, and finally a worked solution — and start at the bottom. After each hint the learner attempts the problem again; on a failed attempt the agent steps up one level, and on progress it holds or steps down. The level is keyed to an estimate of the learner's mastery and to the count of consecutive failures, so specificity rises just fast enough to keep the learner moving and no faster. The full solution sits at the top of the ladder as a last resort, reached only after the smaller nudges have been tried, rather than offered first.

What this pattern forbids. The worked solution is never offered first; help must start at the least-specific rung that might unstick the learner, and specificity may rise only after an attempt shows the smaller nudge was insufficient.

And the patterns that stand alongside it, or against it —

alternative-toSocratic Questioning Agent★— Drive the agent toward its goal by asking the user a sequence of strategic, open-ended questions that surface the user's own latent knowledge, goal, or context — rather than producing an answer directly.
complementsDynamic Scaffolding★— Inject task-specific scaffolding (examples, hints, schemas) into the prompt only when the task type warrants it.
complementsDisambiguation★★— Have the agent ask a clarifying question before acting on an ambiguous request.
alternative-toProductive Struggle Erosion✕— Anti-pattern: a tutoring or coaching agent optimised for helpfulness gives the correct, in-scope answer to a stuck learner, removing the productive struggle that builds the skill, so the learner feels helped while learning less.