observability-setup-builder

name	observability-setup-builder
description	Add or improve logging, metrics, tracing, dashboards, and alert-ready instrumentation structure. Use when a service lacks visibility or incident triage is too hard.

Observability Setup Builder

Overview

Add or improve logging, metrics, tracing, dashboards, and alert-ready instrumentation structure.

Core Workflow

1. Gather the source material, existing conventions, templates, and destination format before drafting.
2. Extract the information that matters most for the intended audience and discard low-signal noise.
3. Structure the output so it matches repo, team, or domain expectations instead of starting from a blank generic outline.
4. Draft the artifact, then surface any missing facts or decisions that still need human input.

Deliver

• A ready-to-edit draft in the expected structure and tone.
• The main sections, decisions, or states the artifact should include.
• Open questions or missing facts that would improve the final output.

Guardrails

• Do not invent facts, metrics, approvals, or guarantees that are not supported by the inputs.
• Prefer existing repo or team conventions over generic formatting.
• Keep the output useful and specific rather than padded.
• Prefer repository evidence, command output, and nearby tests over vague intuition.