schematize
Skills · Claude Code · Agent Skills

Ein System, das man nicht sieht, kann man nicht betreiben — ohne Verhandlung.

OpenTelemetry mit Collector, korrelierte Traces, Metriken und Logs, SLOs mit Burn-Rate und Alerts, die auf ein Runbook zeigen. Observability entsteht mit dem Service, nicht danach.

v0.2.1Disciplina · Observabilidadegithub.com/schematizeme/skill-observability

Betreut von Lucas Andrade

schematize-observability · v0.2.1bash
$ schematize install observability
GitHub →Skill (.zip) herunterladen/observability-help · github.com/schematizeme/schematize-cli

Nicht verhandelbare Mindeststandards

Werden nie abgeschaltet, "um schneller zu sein". Vollständige Liste in der Skill.

OpenTelemetry und Collector

Das SDK spricht OTLP mit einem Collector, nie direkt mit dem Backend; ein Vendor-SDK im Service-Code ist verboten.

Entsteht mit dem Service

Ein Service ist erst fertig, wenn er strukturierte Logs, Metriken und Traces ausgibt, Probes bereitstellt und mit versioniertem Dashboard, Alerts und SLO startet.

Korrelation in jedem Log

trace_id und span_id in jedem JSON-Log, statische Meldung mit den Daten in Attributen und deployment.environment.name im Resource.

Keine PII oder Secrets in der Telemetrie

An der Quelle maskieren und redaction im Collector nutzen; user_id, E-Mail und IP werden nie Metrik-Label.

Sampling verliert nie Fehler

100 % der fehlerhaften oder langsamen Traces per Tail-Sampling; die RED-Metrik wird nicht aus gesampelten Traces abgeleitet.

Jeder Service hat ein SLO

Multi-Window-Burn-Rate auf dem Error Budget, und ein aufgebrauchtes Budget stoppt Features.

Alerts sind Symptome, mit Runbook

Alerts auf Nutzersymptome mit severity, for und runbook_url; ein Alert, auf den niemand reagiert, wird gelöscht.

Getrennte Umgebungen

Telemetrie aus dev und hml erreicht nie das prd-Backend, und hml weckt niemanden.

Befehle

Installiert in .claude/commands/. Führe /obs-help jederzeit aus.

/obs-alertsPrüft oder schreibt Alerts (Nutzersymptom, severity, for, Runbook) und führt check-alertas.mjs aus.
/obs-ccContext compact: schreibt Kontext + Checkliste ins Archiv und führt /compact aus.
/obs-claudeErstellt oder fügt die Immer-an-CLAUDE.md für observability im Repo-Root zusammen (überschreibt keine Blöcke anderer Skills).
/obs-dashboardDashboard als Code (SLO, RED, USE und Links).
/obs-handoffSchreibt das Kontext-Handoff ohne Kompaktierung — Sitzungsende oder Aufgabenwechsel.
/obs-helpListet alle Befehle auf.
/obs-instrumentInstrumentiert einen Service nach dem Standard (SDK zum Collector, semconv, JSON-Log, Healthchecks) in der Sprache des Rols.
/obs-loadLädt zwingend den gesamten normativen Inhalt und beginnt, ihn anzuwenden.
/obs-reviewPrüft die Observability eines Services (Signale, Korrelation, PII, Kardinalität, Probes, SLO) und führt die Gates aus.
/obs-sloDefiniert SLI, SLO und Error Budget in /docs/slo.md und erzeugt die Burn-Rate-Regeln.

Für KI-Agenten

Ohne menschliches Eingreifen installieren. Metadaten in llms.txt.

  • Ausführen: git clone https://github.com/schematizeme/skill-observability.git && ./skill-observability/install.sh
  • Oder herunterladen: https://github.com/schematizeme/skill-observability/releases/latest/download/skill-observability.zip und nach .claude/skills/ entpacken
  • Kopiere assets/CLAUDE.md in das Repo-Root (Immer-an-Regel).
  • Bestätige mit /obs-help.

Nicht installieren wollen?

Lies die vollständigen Standards und kopiere sie direkt in dein Projekt — oder installiere die Skill, damit der Agent sie selbst durchsetzt.

GitHub →Pakete