microsoft / microsoft/hve-core

feat(skills): observability-planner for release-readiness pillar

Open
#2,412 1 comment 1 reaction 0 assignees View on GitHub
enhancement needs-triage skills
Dominant language
Python
Stars
1.5k
Forks
301
Avg merge
3d 3h
Merged PRs (30d)
92

Description

## Skill Name

observability-planner

## Programming Language

Other — documentation-driven playbook skill (no executable scripts, same as `performance-slo-planner`)

## Purpose

The `release-readiness-gate` skill assesses an **Observability** pillar (logs, metrics, traces, alerting), but no dedicated planner produces a consumable artifact for it, so the gate falls back to codebase signals only. The repo has adjacent support — the `telemetry-foundations` skill (vocabulary) and `telemetry-overlay` instructions — but nothing that emits an `observability-plans/` artifact. This leaves Observability assessed less rigorously than the six pillars that do have producers. A standalone, `user-invocable` playbook skill (mirroring `performance-slo-planner`) would produce a first-class plan the gate can consume.

## Prerequisites

None — documentation-driven playbook, no external tools or scripts.

## Requirements

- Standalone `user-invocable` playbook skill (Procedure + Output Format), same shape as `performance-slo-planner`; no phase/state machine or agent.
- Reuse `telemetry-foundations` as its vocabulary reference rather than re-embedding telemetry semantics.
- Produce a plan covering: signals to observe per critical journey, metric/trace/log coverage, alerting + on-call wiring, dashboards, and observability gaps/backlog.
- Write output to `.copilot-tracking/observability-plans/-observability-plan.md`; add that folder to the disclaimer / untrusted-content applyTo globs (as done for `release-readiness/`).
- Register in the `project-planning` collection (planners live there; the gate consumes cross-collection).
- Update `release-readiness-gate` Default Pillars "Evidence source" to point at this skill.

---

_Context: release-readiness-gate has two pillars without a dedicated producer (Observability, Operational Readiness)._

Contributor guide

Open the contributing guide

Research direction

Start by reading the adjacent performance-slo-planner, telemetry-foundations, telemetry-overlay instructions, and release-readiness-gate. Add the user-invocable procedure and output format, register it in the project-planning collection, add observability-plans/ to the disclaimer globs, and update the gate's Observability evidence source; done means the dated plan artifact and all integrations are specified.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.