Skip to content

Glossary

Reasoning trace

A reasoning trace is the visible record of the steps a system produced on its way to an answer, which makes a wrong result diagnosable without making the record an account of what actually happened.

In plain terms

The working shown alongside the answer. It is genuinely useful: when something comes out wrong you can usually see which step went astray instead of guessing. What it is not is a recording of what went on inside, and treating it as one is where people get into trouble.

01

Why it matters

Because a wrong answer with visible working is a fixable problem and a wrong answer without one is a mystery. Being able to point at the step where a figure was misread, or where a condition was quietly dropped, turns debugging from re-running the request hopefully into reading. That is the whole of the practical benefit.

02

How it works

It is generated text, produced alongside the answer rather than extracted from the machinery. The steps are written the same way everything else is written, which is why they read so plausibly and why they can be wrong in the same ways. Nothing is instrumenting the system and reporting back.

The record and the actual computation can diverge, and this is the part worth holding on to. A trace can describe a route that sounds reasonable while the answer arrived by some other means, so a convincing set of steps ending in a correct answer is not proof that those steps produced it. It is a description offered in good faith by something that cannot introspect.

It is often abridged, and how much varies by product and by tier. Some vendors show a summary rather than the full working, some show it only on request, and some withhold it entirely for commercial reasons, so absence of visible reasoning tells you about the product rather than about the system. Assume you are reading an edited version.

Its real home is debugging rather than assurance. Reading where a step went wrong is fast and reliable, while using the trace to justify a decision to somebody else imports the assumption that it describes what happened. For anything that needs to be defensible afterwards, a record of inputs and outputs is worth more than a record of stated reasoning.

Two things it is easy to confuse

Two things it is easy to confuseThe reason this confusion is so durable is that the trace behaves like a log almost all of the time. It appears alongside the work, it is ordered, it names the things that were touched, and when the answer is wrong it very often does point at the place where the mistake was made. Anybody using it for a fortnight would reasonably conclude it was a log. The difference only announces itself in the case that matters most, which is when somebody outside the team asks why the system concluded what it concluded. At that moment the honest answer is that the account was written by the same thing that wrote the answer, and it has no privileged access to its own workings. That does not make it worthless, and it does move it from the evidence pile to the diagnosis pile. Keep the inputs, keep the outputs, and use the trace to find out what to fix rather than to prove what occurred.A logEmitted by the machinery.Records what happened.Holds up under scrutiny.Written to be evidence.A traceWritten by the same process.Describes a plausible route.Usually right, neverguaranteed.Written to be read.Both arrive as text in the samewindow, which is why thedistinction collapses inpractice. Only one of them issafe to put in front of somebodywho needs convincing.
The reason this confusion is so durable is that the trace behaves like a log almost all of the time. It appears alongside the work, it is ordered, it names the things that were touched, and when the answer is wrong it very often does point at the place where the mistake was made. Anybody using it for a fortnight would reasonably conclude it was a log. The difference only announces itself in the case that matters most, which is when somebody outside the team asks why the system concluded what it concluded. At that moment the honest answer is that the account was written by the same thing that wrote the answer, and it has no privileged access to its own workings. That does not make it worthless, and it does move it from the evidence pile to the diagnosis pile. Keep the inputs, keep the outputs, and use the trace to find out what to fix rather than to prove what occurred.
03

Seen in the wild

  • An automation platform whose agents sit inside the scenario builder with their reasoning and tool calls visible step by step as they run.

    Make
  • An assistant strong at detailed instructions, where the working shown alongside a long analysis is what makes a wrong turn locatable.

    Claude
  • An editor whose agent plans before it builds, so the intended route is readable before the diffs arrive rather than only afterwards.

    Cursor
04

Common misconceptions

People assume

It shows how the answer was reached.

In fact

It shows a plausible account of how it could have been reached, written by the same process that wrote the answer. The two usually correspond and nothing enforces that they must, so a trace is a strong debugging aid and weak evidence. Treat it as testimony rather than as a log.

People assume

What I am shown is the whole of it.

In fact

Most products summarise, some show it only on request, and several withhold it for commercial reasons. Which of those you are looking at is a property of the product and its tier rather than of the system, so a short trace means the vendor chose brevity, not that the work was brief.

05

Telling them apart

Reasoning trace vs Chain of thought

Reasoning trace

The record you are shown.

Chain of thought

The technique of working through steps.

One is an interface decision and the other is a way of producing answers, so a system can use the technique thoroughly and show you almost none of it.

06

Questions

Can I use it to explain a decision to somebody else?
Only carefully, because it imports an assumption that will not survive scrutiny. The trace is a plausible account rather than a recording, so presenting it as the reason a system concluded something is a claim you cannot substantiate. For anything that must be defensible later, keep the inputs and outputs and treat the reasoning as colour.
Is a longer trace a better one?
Not reliably, and length is largely a product decision rather than a quality signal. Some vendors show working in full, some summarise, some charge for it, so comparing two products by how much they display tells you about their interfaces. What matters is whether you can locate the step that went wrong.
What is it genuinely good for?
Finding the point of failure, which it does very well. When a result is wrong you can usually read to the step where a figure was misread or a condition dropped, and fix the request rather than re-running it and hoping. That single use justifies turning it on wherever a product offers the choice.
07

Key takeaways

  • It is generated text, not instrumentation reporting back.
  • The account and the actual computation can diverge, so it is testimony.
  • How much you see is a product decision, usually an abridgement.
  • Excellent for locating a failure, weak as evidence for anybody else.
09

Tools that use this

  • Make

    Agent reasoning and tool calls visible step by step in the builder.

  • Claude

    Working shown alongside long analyses, so a wrong turn is locatable.

  • Cursor

    The intended route readable before the diffs arrive.

Last checked July 2026

All glossary terms