Add a new HTTP endpoint to Coremetry — ALWAYS in its own internal/api/<domain>.go file with a `registerXxxRoutes(mux)` method, so api.go (11.8k lines, 352 routes) grows by exactly one line. Covers route/auth/audit/serveCached/writeErr conventions, the four…
Coremetry production bug → repro → one-sentence root cause → minimal fix + regression test → shipped as its own v0.10.X+1 via /release. Use when the operator reports a defect they OBSERVED in the running product ("operator-reported X", "X sayfası boş…
Render the operator's prioritised DEVELOPMENT queue — in-progress and pending items grouped bugs > scale > features > polish, at most 7 rows with effort estimates, ending in the literal prompt "Hangisi?" so the operator picks rather than reading analysis. Use…
Checklist for every change to Coremetry's OTLP→ClickHouse conversion (internal/otlp/) — the field-by-field map of what reaches CH and what is silently dropped, plus the six things that break quietly — span links, exemplars, attribute routing (promoted →…
Cut a Coremetry release — compute the next v0.10.X tag from git tags, run every gate, stage explicit paths, commit in the CLAUDE.md format, annotate the tag, push, then rebuild the image in the background with `make image` (never `make docker-up` — v0.9.210).…
Coremetry ClickHouse guardrails — decision tree for new tables/MVs/columns, engine choice, ORDER BY and where high-cardinality columns go, the MV-first invariant, distributed-safe column adds (the two-boot contract), the four rollup families (narrow/wide span…
Coremetry's UI component contract — find the existing primitive BEFORE writing a new one (the ui/ barrel is incomplete, which is how half the duplicates were born), pick the right Button/table variant, respect the @grafana/ui boundary (2 files, 2 jobs,…
Diagnose ONE concrete Coremetry slowness complaint ("X sayfası yavaş", "bu uç 3 saniye") with measurements instead of guesses — split backend vs frontend by TTFB + X-Cache, then EXPLAIN indexes=1 + system.query_log read_rows/read_bytes on the ClickHouse side,…