decision-tracing

Trace agent decision points with options, actions, and context.

7|1|Updated Dec 26, 2025
One-click install
npx skills add https://github.com/nexus-labs-automation/agent-observability --skill decision-tracing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-tracing
Source: https://github.com/nexus-labs-automation/agent-observability/tree/main/skills/decision-tracing
Command: npx skills add https://github.com/nexus-labs-automation/agent-observability --skill decision-tracing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Trace agent decisions and the reasoning behind actions to improve debugging, auditing, and reliability in automated workflows.

Core Features & Use Cases

  • Capture decision points, including the set of options, the selected action, and the rationale.
  • Attach contextual metadata such as tool usage, routing decisions, and post-hoc evaluation to support debugging and optimization.
  • Use cases include production debugging, decision quality assessment, and compliance auditing of automated agents.

Quick Start

Query an agent run to surface each decision point, including options considered, the chosen action, and the surrounding context.

Frequently Asked Questions about decision-tracing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I trace agent decisions and reasoning in multi-step workflows?

To trace agent decisions in multi-step workflows, you query an agent run to surface each decision point, capturing the options considered, the chosen action, and the surrounding context. This provides actionable debugging signals.

What is decision tracing in automated agent workflows?

Decision tracing in automated agent workflows is identifying and tracking every agent decision point, including available options, chosen actions, and influencing context. It improves debugging, auditing, and reliability.

Does this decision tracing approach work with Langfuse for automated agents?

Yes, tracing agent decisions requires integration with tracing hooks like Langfuse and structured decision data. This setup captures decisions, rationale, and outcomes for production debugging and compliance auditing.

Can I capture the rationale and available options when debugging agent routing decisions?

Yes, you can capture decision points including the set of options, the selected action, and the rationale. It attaches contextual metadata such as tool usage and routing decisions to support debugging.

What's the best way to audit tool usage and decision quality in automated workflows?

To audit tool usage and decision quality, apply decision tracing across multi-step agent workflows. This surfaces post-hoc evaluation and surrounding context to support compliance auditing and optimization.

Why do I need structured decision data and tracing hooks for agent debugging?

Structured decision data and tracing hooks are required to capture decisions, rationale, and outcomes. Without this structured integration, the system cannot surface actionable insights or debugging signals.