Docs/Findings & Fixes

Findings & Fixes

A Shingo finding is a complete execution package. It tells your engineers what broke, why it matters, and how to fix it, all in one place.

Anatomy of a finding

Every finding includes these components:

Signal IDSHG-2847

Unique identifier for tracking and reference

SeverityCritical / High / Medium / Low

Based on revenue impact and confidence score

Root causeJS lib v2.4.0 broke mobile form validation

The specific technical issue that caused the revenue impact

File referencecheckout.tsx:142

Exact file and line where the issue originates

Revenue impact$1.8M/yr

Annualized dollar amount at risk

Sessions affected12,847

Number of user sessions impacted during the analysis window

Causal confidence94%

How certain Shingo is that this cause produced the effect

Regression timelineMar 2 → Mar 3 → Mar 8 → Mar 10

Chronological sequence from cause to detection

Suggested fixRevert to v2.3.1

Engineer-ready fix with code context

Example finding

SIGNAL #1— 94% confidence

cause: checkout.tsx:142 — JS lib v2.4.0 broke mobile validation

impact: $1.8M/yr · 12,847 sessions

cohort: mobile users, top-LTV (18% drop-off)

fix: revert to v2.3.1

Slack #eng-revenue · GitHub issue #2847 created

Delivery channels

Findings are delivered where your team already works:

GitHub Issues

Auto-created issues with priority labels, revenue impact tags, file references, and suggested fix. Your team reviews and ships.

Linear Tickets

Tickets created with priority, project assignment, and full finding context. Integrates with your existing sprint workflow.

Slack

Real-time notifications to your eng-revenue or eng-alerts channel with a summary and link to the full finding.

REST API

Programmatic access to all findings for custom integrations, dashboards, or internal tools.

Regression timeline

Each finding includes a timeline showing the chain of events from cause to detection. This helps your team understand the full story:

Mar 2lib updated to v2.4.0
Mar 3mobile checkout failures spike
Mar 8top-LTV cohort drop-off hits 18%
Mar 10Shingo identifies causal link
Mar 11fix deployed, revenue recovers