Skip to main content

Impact Dashboard

Track how much time and effort Surchin saves your team. The Impact dashboard quantifies the value of accumulated knowledge by measuring reuse, avoidance, and estimated savings.

Metrics

The Impact dashboard tracks four core metrics based on positive reinforcement signals (“helpful” ratings) across your organization:

MetricDescription
Solutions reusedSOLUTION insights that received a helpful rating — fixes that were applied again in a new context
Pitfalls avoidedPITFALL insights that received a helpful rating — gotchas that were surfaced before the agent hit them
Patterns followedPATTERN insights that received a helpful rating — reusable code patterns that guided implementation
Workflows appliedWORKFLOW insights that received a helpful rating — process knowledge that saved time

Estimated Savings

Surchin estimates the value of each helpful signal using conservative multipliers:

  • Tokens saved — Each helpful signal represents approximately 2,000 tokens of context that the agent didn't need to rediscover (search, read, experiment).
  • Minutes saved — Each helpful signal represents approximately 3 minutes of developer time that would have been spent investigating, debugging, or re-learning.

These are conservative baselines. The actual savings scale with the complexity of the knowledge being reused — a solution to a subtle RLS bug may save 30 minutes, while a common import pattern saves seconds.

Auto-Capture Funnel

The Impact dashboard includes a funnel visualization showing the auto-capture pipeline:

  1. Events captured — Total session events recorded by the auto-capture hooks
  2. Insights promoted — Events that passed promotion heuristics and became draft insights

This shows the conversion rate of raw activity into curated knowledge, helping you understand how effectively the auto-capture system is identifying valuable patterns.

Weekly Trend

A daily aggregation chart shows helpful signal trends over the selected time window. This reveals whether knowledge reuse is increasing as your substrate grows — a healthy substrate shows a gradual upward trend in helpful signals over time.

Value Card

The overview page includes a headline Impact card that surfaces the top-level numbers at a glance — total helpful signals, estimated tokens saved, and estimated minutes saved for the selected period. This gives stakeholders a quick answer to “is this tool worth it?”

Analytics Tab

The detailed analytics view provides a breakdown by insight kind, showing which categories of knowledge deliver the most value. It includes the trend chart, capture funnel, and per-kind metrics in a single view for deeper analysis.

API

Impact metrics are available via the dashboard API:

GET /api/dashboard/roi?days=7

The days parameter accepts values from 1 to 90 (default: 7). The response includes all metrics, estimated savings, and daily trend data for the requested window.