dev-sre

Validate observability implementation with JSON logs, OpenTelemetry tracing, and context propagation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/withmartian-sandbox/ghrc-x-3126672651424eddb640ecc81321a665 --skill dev-sre-withmartian-sandbox
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dev-sre
Source: https://github.com/withmartian-sandbox/ghrc-x-3126672651424eddb640ecc81321a665/tree/main/dev-team/skills/dev-sre
Command: npx skills add https://github.com/withmartian-sandbox/ghrc-x-3126672651424eddb640ecc81321a665 --skill dev-sre-withmartian-sandbox

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates that developers implemented observability correctly so services are not blind in production. It detects missing structured JSON logs, absent or incomplete OpenTelemetry tracing, improper context propagation for external calls, and forbidden plain-print logging patterns that break monitoring and incident response.

Core Features & Use Cases

  • Forbidden Pattern Detection: Identifies fmt.Println, console.log, and other non-structured logging usages and marks them as critical failures.
  • Instrumentation Coverage Measurement: Counts spans across handlers, services, and repositories and enforces a minimum of 90% coverage with a tabular report.
  • Context Propagation Checks: Verifies HTTP, gRPC, and queue calls inject tracing context so traces correlate across services.
  • Automated Fix Workflow: Dispatches fixes to the implementation agent, re-validates up to three iterations, and escalates to the user if unresolved.
  • Use case examples include Gate 2 validation for API services, background workers, and CI gating before testing.

Quick Start

Run the dev-sre skill to validate that task-001's Go API implementation includes JSON structured logging with trace_id, OpenTelemetry spans covering handlers/services/repositories, proper context propagation for external calls, and no forbidden console or fmt prints.

Frequently Asked Questions about dev-sre

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

FAQPage Schema
How do I validate OpenTelemetry tracing and instrumentation coverage in my code?▼

Validate OpenTelemetry tracing and instrumentation coverage by counting spans across handlers, services, and repositories, enforcing a minimum 90% coverage threshold, and generating a tabular report to identify gaps.

Why does structured JSON logging fail validation in production services?▼

Structured JSON logging validation fails when logs lack a trace_id, use forbidden plain-print patterns like fmt.Println or console.log, or do not meet the required JSON format for monitoring and incident response.

How do I verify context propagation for HTTP, gRPC, and queue calls?▼

Verify context propagation by checking that HTTP, gRPC, and queue calls inject tracing context properly, ensuring traces correlate correctly across distributed services during observability validation.

Can I automate the fix for missing observability instrumentation during CI gating?▼

Yes, you can automate fixes for missing observability instrumentation by dispatching fixes to an implementation agent, re-validating up to three iterations, and escalating to the user if issues remain unresolved.

Does dev-sre work for validating observability in background workers and CLI tools?▼

Yes, dev-sre works for validating observability in background workers, CLI tools, APIs, batch processes, and libraries by applying structured logging and tracing checks during Gate 2 implementation.

What is the minimum instrumentation coverage required to pass observability validation?▼

The minimum instrumentation coverage required to pass observability validation is 90% across handlers, services, and repositories, measured by counting spans and reported in a tabular coverage breakdown.