> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sovara-labs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Philosophy

> The principles behind Sovara’s approach to improving agents.

Agentic systems improve through a disciplined loop: observe real runs, find the
mistakes that matter, and apply the right fix. Sovara keeps that loop grounded
in recorded behavior instead of guesswork.

The workflow is intentionally simple. Traces show the run, annotations focus
review, and lessons turn recurring domain knowledge into runtime context.

<div className="philosophy-graphic-wrap">
  <img className="philosophy-graphic" src="https://mintcdn.com/sovaralabs/OdK0xacItKjR_8Im/assets/visualizations/graph-example.png?fit=max&auto=format&n=OdK0xacItKjR_8Im&q=85&s=85d293a9951d1fdd9fa0a8760a318a48" alt="Sovara workflow from observing traces to surfacing errors and improving agents" width="3583" height="2933" data-path="assets/visualizations/graph-example.png" />
</div>

<Steps titleSize="h2">
  <Step title="Observe">
    Start from real executions. Sovara keeps the run steps and runtime context
    together so the team can inspect the behavior that actually occurred.

    The concrete observability views are covered in [Runs](/observability/runs),
    [Manual inspection](/observability/manual-inspection), and
    [Run chat](/observability/run-chat).
  </Step>

  <Step title="Surface errors">
    Not every run deserves manual review. Sovara prioritizes the failures,
    regressions, confusing outputs, and behavioral gaps most likely to teach the
    team something.

    Review surfaced runs in [Annotations](/annotations/overview). To learn how
    Sovara chooses which runs deserve attention, read about our [Recommendation
    Algorithm](/annotations/recommendation-algorithm).
  </Step>

  <Step title="Improve">
    Once you understand the error, apply the right kind of fix. Some issues need
    a better prompt or a new tool. Others come from missing domain knowledge,
    where a reusable lesson is the better fix.

    To understand that pattern, start with [What are
    lessons?](/sovaradb/lessons). Then learn how to [create and manage
    lessons](/sovaradb/creating-managing-lessons), and how Sovara performs
    [auto-injection](/sovaradb/auto-injection) at runtime.
  </Step>
</Steps>