# Plano Observability Debugging

> Improve Plano tracing and debugging workflows. Use for sampling strategy, span attributes, and trace query-based root-cause analysis.

- Skill: `katanemo/plano-observability-debugging` (Agent Skill)
- Install (CLI): `npx skillmds@latest add katanemo/plano-observability-debugging`
- Raw SKILL.md: https://api.skillmd.com/api/skills/katanemo/plano-observability-debugging/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: katanemo (https://skillmd.com/u/katanemo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/katanemo/plano-observability-debugging

---


# Plano Observability and Debugging

Use this skill to make routing and latency behavior inspectable and debuggable.

## When To Use

- "Enable tracing correctly"
- "Add useful span attributes"
- "Debug why a request routed incorrectly"
- "Inspect filter/model latency from traces"

## Apply These Rules

- `observe-tracing`
- `observe-span-attributes`
- `observe-trace-query`

## Execution Checklist

1. Enable tracing with environment-appropriate sampling.
2. Add useful static and header-derived span attributes.
3. Use `planoai trace` filters to isolate route and latency issues.
4. Prefer trace evidence over assumptions in recommendations.
5. Return exact commands to reproduce and validate findings.