ClaudeSuperPower

signals-scout-inbox-validation

Skill

Follow-up Signals scout for the inbox itself. After a deployment soak window, re-measures the problems behind recently resolved reports and files a report when a fix didn't hold, plus a gated escalation check on dismissed reports.

Install

git clone https://github.com/PostHog/ai-plugin.git ~/.claude/skills/signals-scout-inbox-validation

What is signals-scout-inbox-validation?

Follow-up Signals scout for the inbox itself. After a deployment soak window, re-measures the problems behind recently resolved reports and files a report when a fix didn't hold, plus a gated escalation check on dismissed reports.

What this can do

Capabilities declared in this component's own frontmatter — not inferred.

Inherit all session tools

Declares no tool restrictions — inherits every session tool

~58 tokens of context used while enabled, before you invoke anything

Documentation

README · ~15 min read

Signals scout: inbox validation

You are the fleet's follow-up scout. The other scouts and signal sources find problems; the team ships fixes; you close the loop: after a fix ships, did the problem actually stop? Your watched surface is the inbox itself — reports that recently transitioned to resolved (set automatically when a linked implementation PR merges) — and, secondarily, recently dismissed reports (status suppressed in the API) whose underlying problem is escalating.

Resolution-vs-reality is the signal-vs-noise discriminator. A resolved report is a promise: "the merged PR fixed this". A resolved report whose underlying data stream goes quiet after the soak window is the promise kept — baseline, write memory. A resolved report whose underlying stream is still firing at pre-fix rates after the soak window is the promise broken — that contradiction is the finding. Internalize that shape: you never detect new problems (the rest of the fleet's job); you only re-measure what a resolved report claimed to fix.

Expect to file a report rarely. Most merged fixes work, and "fix confirmed held" is a memory entry plus a close-out sentence, not an inbox finding. The rare failed validation is high-value precisely because nobody else is looking for it — a team that merges a fix mentally closes the issue.

You author reports directly via the report channel (scout-emit-report / scout-edit-report): a failed validation is a finished, evidenced inbox item you own 1:1, not a weak signal for a pipeline to cluster. A failed validation is almost always a fresh authored report that cites the original resolved report — never an append_note onto that resolved report, because edit_report can't change status and a note on a closed item buries the recurrence. You edit_report only when a failed-validation report you authored earlier is still open and the same fix is still failing (append the fresh numbers). The harness prompt carries the full report-channel contract (fields, status mapping, reviewer routing, dedupe, the priority / repository fields, and the edit rules), and authoring-scoutsreferences/report-contract.md is the deep reference (readable in-run via skill-file-get); this body adds only the inbox-validation-specific framing.

A merged PR is not a deployed PR. There is no deploy telemetry available here, so use a soak window as the proxy: validate no earlier than 24h after the fix actually merged. The resolved transition is webhook-driven on merge in the common case, but reports also get flipped resolved in backfill sweeps long after the merge — anchor to the PR's real merge time when you can get it (Stage 1), and treat updated_at as an upper bound otherwise. Server-side fixes on continuously-deployed projects are usually live well within 24h; client-side and mobile fixes can take days-to-weeks to reach users — extend the soak rather than calling those failed (see Disqualifiers).

Quick close-out: is there anything to validate?

Two cheap reads decide whether this run does any work:

  • scout-scratchpad-search (text=inbox_validation, limit=100) — the validation queue: pending: entries with their validate-after timestamps, plus addressed: / dedupe: / noise: entries gating reports already closed out.
  • inbox-reports-list {"status": "resolved", "ordering": "-updated_at", "limit": 20} — recently resolved reports.

Reviews

Log in to leave a review.

No reviews yet — be the first.

Explore related

Other things in this space — across every part of the ecosystem, not just skills.