observability-designer

Design correlation-first observability strategies for distributed and AI-native systems.

Updated May 9, 2026
One-click install
npx skills add https://github.com/GustavoGutierrez/engineering-skills --skill observability-designer-gustavogutierrez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability-designer
Source: https://github.com/GustavoGutierrez/engineering-skills/tree/main/skills/observability-designer
Command: npx skills add https://github.com/GustavoGutierrez/engineering-skills --skill observability-designer-gustavogutierrez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Correlation-first observability design turns fragmented telemetry into actionable insight by defining how logs, metrics, traces, and AI/workflow signals should be modeled, emitted, and governed so you can detect incidents and diagnose root causes reliably.

Core Features & Use Cases

  • Telemetry architecture & correlation model: Defines an ID taxonomy (trace/request/workflow/step/tenant/agent) and propagation rules so every signal can be linked end-to-end.
  • Golden-signal-first observability: Establishes latency, traffic, errors, and saturation SLI/SLO candidates before adding domain-specific signals.
  • AI telemetry & workflow state observability: Specifies prompt/token/cost telemetry, tool/retrieval signals, guardrail/evaluator outcomes, and workflow state transition signals for async/agentic systems.
  • Cost and privacy governance: Adds sampling, retention, redaction, and privacy classification so observability stays safe and sustainable in production.

Quick Start

Ask an AI system: "Design an observability strategy for my distributed AI-native service, including correlation IDs, logs/metrics/traces schemas, AI telemetry, workflow observability, alerting SLI/SLO candidates, and a telemetry cost/privacy policy."

Frequently Asked Questions about observability-designer

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

FAQPage Schema
How do I design an observability strategy for a distributed AI-native service from scratch?

To establish golden-signal observability, define latency, traffic, errors, and saturation SLI/SLO candidates before adding domain-specific signals. This ensures baseline system health is measured, and AI telemetry like prompt/token cost and guardrail outcomes are layered on top.

What is correlation-first observability and how does it handle distributed tracing?

Correlation-first observability turns fragmented telemetry into actionable insight by defining an ID taxonomy for traces, requests, workflows, steps, tenants, and agents. It enforces propagation rules so every distributed signal can be linked end-to-end for root cause diagnosis.

Can I use this to monitor agentic and async workflow state transitions?

Yes, you can monitor agentic and async systems by specifying workflow state transition signals alongside AI telemetry. This captures tool and retrieval signals, guardrail outcomes, and prompt/token cost data, ensuring full visibility into complex AI-native operations.

How do I manage telemetry costs and apply privacy redaction in production?

Managing telemetry costs and privacy requires adding sampling, retention, and redaction rules with strict privacy classification. This privacy-by-design approach ensures observability remains safe and sustainable in production while still detecting incidents reliably.

What are the limitations of a correlation-first telemetry strategy?

A correlation-first telemetry strategy requires consistent propagation of correlation ID hierarchies across all services; if any component fails to emit structured schemas or follow sampling rules, end-to-end traceability breaks, limiting root cause analysis and release-readiness validation.