plano-observability-debugging

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

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

Skill7.1k starsChanged 7 months ago

View on GitHub Mount Discuss

What's in it

Plano Observability and Debugging
When To Use
Apply These Rules
Execution Checklist

---
name: plano-observability-debugging
description: Improve Plano tracing and debugging workflows. Use for sampling strategy, span attributes, and trace query-based root-cause analysis.
license: Apache-2.0
metadata:
  author: katanemo
  version: "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.