# Plano Observability Debugging

> Plano Observability Debugging is an Agent Skill for devops & security published in the katanemo/plano repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

- Skill name: `plano-observability-debugging`
- Category: [DevOps & Security](https://www.openparable.com/skill/devops-security/1)
- Source: https://github.com/katanemo/plano/blob/HEAD/skills/plano-observability-debugging/SKILL.md
- Repository: katanemo/plano (6,859 GitHub stars when collected)

## SKILL.md

# 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.

---

Source: https://www.openparable.com/skill/devops-security/plano-observability-debugging (OpenParable). Cite the canonical URL above.