schematize
Skills · Claude Code · Agent Skills

Sistema que você não enxerga, você não opera — sem negociação.

OpenTelemetry com Collector, traces, métricas e logs correlacionados, SLO com burn-rate e alerta que aponta runbook. A observabilidade nasce com o serviço, não depois.

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

Mantido por Lucas Andrade

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

Pisos inegociáveis

Não se desligam "pra ir mais rápido". Lista completa na skill.

OpenTelemetry e Collector

O SDK fala OTLP com um Collector, nunca com o backend; SDK de vendor no código do serviço é vetado.

Nasce com o serviço

Só está pronto o serviço que emite logs estruturados, métricas e traces, expõe probes e sobe com dashboard, alertas e SLO versionados.

Correlação em todo log

trace_id e span_id em todo log JSON, mensagem estática com o dado em atributo e deployment.environment.name no Resource.

Sem PII nem segredo na telemetria

Mascarar na origem e usar redaction no Collector; user_id, e-mail e IP nunca viram label de métrica.

Amostragem nunca perde erro

100% dos traces com erro ou lentos via tail sampling; a métrica RED não deriva de trace amostrado.

Todo serviço tem SLO

Burn-rate multi-window sobre error budget, e budget esgotado trava feature.

Alerta é sintoma, com runbook

Alerta de sintoma de usuário com severity, for e runbook_url; alerta que ninguém age é apagado.

Ambientes separados

Telemetria de dev e hml jamais vai para o backend de prd, e hml não acorda ninguém.

Comandos

Instalados em .claude/commands/. Use /obs-help a qualquer momento.

/obs-alertsAudita ou escreve alertas (sintoma de usuário, severity, for, runbook) e roda check-alertas.mjs.
/obs-ccContext compact: gera contexto + checklist no archive e roda /compact.
/obs-claudeCria ou mescla o CLAUDE.md sempre-on de observability na raiz (não sobrescreve blocos de outras skills).
/obs-dashboardDashboard como código (SLO, RED, USE e links).
/obs-handoffGera o handoff de contexto sem compactar — fim de sessão ou troca de tarefa.
/obs-helpLista todos os comandos.
/obs-instrumentInstrumenta um serviço no padrão (SDK para Collector, semconv, log JSON, healthchecks), na linguagem do rol.
/obs-loadCarrega à força o corpo normativo e passa a aplicá-lo.
/obs-reviewRevisa a observabilidade de um serviço (sinais, correlação, PII, cardinalidade, probes, SLO) e roda os gates.
/obs-sloDefine SLI, SLO e error budget em /docs/slo.md e gera as regras de burn-rate.

Para agentes de IA

Instale sem intervenção humana. Metadados em llms.txt.

  • Rode: git clone https://github.com/schematizeme/skill-observability.git && ./skill-observability/install.sh
  • Ou baixe: https://github.com/schematizeme/skill-observability/releases/latest/download/skill-observability.zip e descompacte em .claude/skills/
  • Copie assets/CLAUDE.md para a raiz do repo (regra sempre-on).
  • Confirme com /obs-help.

Não quer instalar?

Leia as normativas completas e copie direto pro seu projeto — ou instale a skill para o agente aplicar sozinho.

GitHub →Pacotes