plano/skills/plano-observability-debugging/SKILL.md

name	description	license	metadata
plano-observability-debugging	Improve Plano tracing and debugging workflows. Use for sampling strategy, span attributes, and trace query-based root-cause analysis.	Apache-2.0	author version katanemo 1.0.0

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.