Skip to content

Trace To Work

Traces are execution records. Teams still need a higher-level unit they can review, attribute, and reason about.

That is why WorkUnit exists.

Why A Higher-Level Unit Is Necessary

One agent task can contain:

  • multiple messages
  • several tool calls
  • retries
  • guardrails
  • human review

Those events are useful, but they are not yet the work itself.

WorkUnit rolls related observations into one unit that a person can inspect and reason about.

It creates a durable boundary around the work so downstream decisions attach to something accountable instead of to disconnected spans.

What WorkUnit Preserves

  • title and summary
  • objective and actor context
  • source span lineage
  • evidence refs
  • review state
  • trust state
  • direct cost, allocated cost, and total cost

Why This Matters

Once work is rolled into WorkUnits, teams can ask better questions:

  • what did this agent run actually add up to?
  • which outputs are costly but still low-trust?
  • which items should stay in a review queue instead of being presented as settled?
  • where should policy or economics attach?

This is the difference between telemetry detail and accountable work attribution.

Why Ambiguity Matters

Some traces do not cleanly resolve.

workledger keeps that visible through review-needed states instead of pretending every trace already maps to a confident answer.

That reviewability is part of the primitive, not an afterthought.

What Comes After

Once work has been attributed, you can layer on:

  • review queues and overrides
  • policy classification
  • economics

Those are useful, but they are downstream of trace-to-work attribution.