Docs/How It Works

How Shingo Works

Shingo runs a five-stage pipeline that turns raw data from your stack into engineer-ready fixes ranked by dollar impact. No dashboards to configure. No queries to write.

The Pipeline

01

Connect

Read-only APIs

Shingo connects to your billing, analytics, error tracking, and product data through read-only API keys. No SDK installation. No code changes. No agents running in your infrastructure. Setup takes less than 5 minutes per data source.

  • Stripe, PostHog, Amplitude, Mixpanel, Sentry, Segment, and more
  • Database connectors for PostgreSQL, MySQL, and BigQuery (read-only users)
  • All keys encrypted at rest and in transit
02

Compress

Pattern detection

Raw event streams are compressed into behavioral patterns. Shingo processes thousands of user sessions per run, identifying sequences of actions that lead to specific outcomes (conversion, churn, upgrade, downgrade).

  • 12,000+ sessions analyzed per run
  • Cross-source correlation: billing events + product behavior + errors
  • Noise reduction: filters out patterns that don't affect revenue
03

Attribute

Revenue mapping

Each behavioral pattern is mapped to its revenue outcome. Shingo connects the dots between what users do and what happens to your revenue, not as a correlation but as a causal chain with evidence at every step.

  • Maps user journeys end-to-end across billing and product data
  • Tracks revenue impact per pattern (MRR at risk, expansion blocked, churn accelerated)
  • Segments by cohort: new users, power users, enterprise accounts
04

Cause

Causal inference

This is the core differentiator. Instead of showing correlation dashboards, Shingo runs causal inference to identify the actual technical cause of revenue changes. A library update that broke mobile validation. A permission gate that blocks checkout. A timeout that kills the payment flow.

  • 94% average causal confidence score
  • Distinguishes cause from correlation using counterfactual analysis
  • Traces root causes to specific code changes, deploys, and configurations
05

Deliver

Fix specs

Each finding is packaged as an execution package: the root cause, the revenue at stake, the affected users, and an engineer-ready fix with code context. Delivered as a GitHub issue, Linear ticket, or Slack message.

  • Auto-creates tickets in GitHub Issues or Linear
  • Priority labels based on dollar impact
  • Includes file references, code context, and suggested fix

Causation, not correlation

Traditional analytics tools show you what happened. Conversion dropped 12%. Churn is up. A certain page has high bounce rate. But they don't tell you why.

Shingo uses causal inference, not just statistical correlation, to identify the actual technical root cause. The difference matters:

Correlation (typical analytics)

“Mobile checkout conversion dropped 18% this week.”

Causation (Shingo)

“JS lib v2.4.0 deployed Mar 2 broke mobile form validation in checkout.tsx:142. Impact: $1.8M/yr. Fix: revert to v2.3.1.”

The Execution Package

Every finding Shingo delivers is a complete execution package. Your engineers get everything they need to evaluate and ship the fix:

Root causeJS lib v2.4.0 broke mobile validation in checkout.tsx:142
Revenue at risk$1.8M/yr across 12,847 affected sessions
Causal confidence94% — based on counterfactual analysis
Regression timelineMar 2: lib update → Mar 3: failures spike → Mar 8: cohort drop-off
Suggested fixRevert to v2.3.1 or patch validation logic in checkout.tsx
DeliveryGitHub issue #2847 created in your repo with priority label