Validation & research

Proven on real data. Every figure measured.

Spiderbrain turns a project into a dependency graph and scores every node for importance, blast radius and risk. For those scores to be worth acting on, two things must hold: the ranking has to concentrate what matters, and the engine must never silently corrupt a node's identity or give a different answer on the same input. This report documents both, measured on 14 real datasets: 13 external corpora across six domains, plus Spiderbrain's own codebase.

External corpora validated 2026-05-30 with validate-real-corpora.mjs on decision layer v5.0.7. Self-analysis generated 2026-06-04 with the v5 engine. Consolidated in v5.1.0: 30 gate scripts, 353 assertions green. Nothing here is a target or a projection.

Summary

Across 13 external corpora, signal lift ranged 1.48× to 2.41× (importance concentrated 48% to 141% above a typical item). Identity silent-corruption was zero; 94 real same-hash collision groups were tested with zero silent misattachment; every decision score was finite; and every result was bit-identical under suppression and deterministic under shuffling. One defect was found by this validation and fixed before release. Run on its own codebase, Spiderbrain found 7 masters across 1,525 nodes with clean community structure and provably independent metrics.

14 real-world datasets13,607 nodes scored0 silent corruptions94 collision groups → 0 misattachbit-for-bit deterministic
DomainDatasetNodesSignal liftCollisions → misattachDeterministic
Software & codeSaroir1,6722.25× +125%78 → 0
Software & codeperform.digital2191.90× +90%13 → 0
People analyticsemployee-attrition1,4702.41× +141%none
Insuranceinsurance1,3382.03× +103%1 → 0
Clinical trialsoncology1,0001.57× +57%none
Clinical trialscardiology1,0001.59× +59%1 → 0
Clinical trialsdiabetes1,0001.60× +60%none
Clinical trialsmental_health1,0001.56× +56%none
Clinical trialsneurology1,0001.54× +54%1 → 0
Clinical trialsvaccines1,0001.48× +48%none
Diagnosticsbreast-cancer5691.91× +91%none
Geophysics & materialsearthquakes2,0001.86× +86%none
Geophysics & materialsbatteries3391.94× +94%none
Developer tooling (self)Spiderbrain1,5251.11× webscore†self-analysis

† The blind-spot signal lift is not computable on the self-brain (metric variance too low, see Assessment); webscore concentration is shown instead. Identity and collision guarantees apply to the decision-layer mutation tests on the 13 external corpora.

Metrics, names and definitions

Every metric used in this report, in plain language.

webscore
Severity. How much it would hurt if this one node failed on its own.
spikescore
Blast radius. If this breaks, how much breaks along with it.
blastVolume
Total risk in one number, combining severity and blast radius.
Masters
Keystones. The few hubs everything leans on, which also act as firebreaks that stop damage spreading.
Blind-spot index
Important but unexamined. High criticality with little review or documentation.
Drift
Going stale. A node has changed in ways that no longer match its past.
Signal lift (discriminationRatio)
The mean of the top 10% of nodes divided by the population mean. It measures concentration, not count, so it is corpus-size invariant. 2.0× means the important few score twice a typical item.
Reach
How far a node’s influence spreads, scored at node scope and cluster scope (0 to 1).
Necessity
How irreplaceable a node is (0 to 1). 1.0 means nothing else can stand in for it.
Modularity (Leiden)
Quality of the community structure the engine finds (0 to 1). Higher means cleaner, more separable clusters.
Shortcut audit
Checks that no metric is a trivial proxy of another. INDEPENDENT means the scores carry distinct signal, not one number wearing different hats.

The five decision-layer guarantees

#GuaranteeWhat it testsTarget
AIdentity safetyRename, edit, delete and correlated-churn mutations applied to a 60-node sample.0 silent corruptions
BForced collisionFor every real same-hash group, judge one member, delete it, and prove the judgment never silently re-attaches to a surviving twin.0 silent misattach
CDecision scoresReach (node and cluster scope) and necessity computed on real data.0 non-finite
DDeterminismThe matcher digest must be stable when node order is shuffled, run three times.identical ×3
ESuppression invariantPartitioning the ranked output must leave the signal lift unchanged.0 bits changed

Validation log

Per-dataset results, exactly as the harness recorded them. Signal lift is the discriminationRatio; rename-auto is the share of renames auto-resolved (the rest correctly defer); reach and necessity are decision-layer scores on the top-ranked node.

DatasetTypeNodesEdgesSignal liftRename-autoCollisions → misattachReach n / cNecessity
SaroirReal codebase1,6722,2862.2467×44/6078 → 00.19 / 0.200.96
perform.digitalReal codebase2192541.9046×52/6013 → 00.64 / 0.580.99
employee-attritionPublic dataset1,4702,3162.4143×60/60none0.36 / 0.830.96
insurancePublic dataset1,3381,2712.0319×60/601 → 00.67 / 0.650.96
oncologyClinicalTrials.gov1,0004,8361.5673×60/60none0.54 / 0.540.96
cardiologyClinicalTrials.gov1,0003,7881.5908×60/601 → 00.78 / 0.600.96
diabetesClinicalTrials.gov1,0003,2321.6012×60/60none0.75 / 0.570.96
mental_healthClinicalTrials.gov1,0004,6411.5604×60/60none0.57 / 0.520.96
neurologyClinicalTrials.gov1,0004,0991.5414×59/601 → 00.00 / 0.670.96
vaccinesClinicalTrials.gov1,0004,1381.4800×60/60none0.74 / 0.820.96
breast-cancerPublic dataset5699781.9135×60/60none0.00 / 0.710.94
earthquakesPublic dataset2,0005,0281.8562×60/60none0.78 / 0.910.96
batteriesPublic dataset3391,1391.9402×60/60none0.81 / 0.930.96

Every corpus also passed, uniformly: silent-corruption 0, decision scores finite, determinism identical ×3, and signal lift bit-identical before and after suppression. Suppression removed exactly 2 adjudicated nodes per corpus without changing the ranking of the rest.

14th dataset: Spiderbrain on Spiderbrain

We run the engine on its own source. This is the brain of the shipping app, generated on 2026-06-04.

1,525nodes scored
7masters (keystones)
7clusters
0.4646Leiden modularity
1.11×webscore lift (top 10% / mean)
1.30×blastVolume lift
INDEPENDENTshortcut audit (R² 0.547)
N/Ablind-spot index (low variance)

The 7 masters it found: src/graph/types.ts, package.json, public/brain.json, src-tauri/capabilities/default.json, supabase/referral.sql, bridge/server.mjs, scripts/vendor-engine.mjs. The top-scoring node is src/graph/types.ts (webscore 8.7): the type system is the keystone the rest of the app leans on, which is exactly what you would expect, and a useful sanity check that the score tracks reality.

Rationale

Why across domains. An importance score that only works on code proves little. Code, people, insurance, medicine, geophysics and materials share nothing except structure, so passing all of them shows the method keys on structure, not on the quirks of one domain.

Why these guarantees. A ranking is only useful if the thing it ranks keeps its identity as the project changes, and if the same input always yields the same answer. So we test identity under churn, the worst case of a deleted content twin, finiteness, determinism, and invariance under suppression.

Why dogfood. We run Spiderbrain on Spiderbrain. If the team would not trust it on its own code, neither should you.

Why determinism is the bar. Agents act on these scores. A score that changes between runs cannot be audited or trusted. Same input, same brain, every time.

Assessment

All 13 external corpora pass every guarantee after one fix, and the self-analysis behaved exactly as designed, including where it declined to score.

The defect this validation caught. The first run was not clean, which is the point of testing on real data. Neurology and insurance each showed one silent misattachment. The root cause: the matcher assumed a coincidental content twin has different neighbors, but on dense record graphs two records can share both the content hash and most of their neighbors. When one was deleted and exactly one twin survived, the judgment auto-applied. The fix captures whether the content hash was unique at the moment of decision; a judgment made on a non-unique hash never auto-applies and always defers to a human. Code brains never hit this because their twins differ structurally, so only the dense real record graphs exposed it.

Honest notes.Across the six clinical areas, signal lift spans 1.48× (vaccines) to 1.60× (diabetes); we show that exact range rather than rounding it to a tidy 1.5× to 1.6×. The self-brain's blind-spot index could not be computed: its variance was too low because the brain was built without commit history and the codebase is structurally uniform, so the engine returned a diagnostic instead of a fabricated number. Rename-auto rates below 60/60 on the code brains (44/60, 52/60, and neurology's 59/60) are collision-group members correctly deferring, not failures: you cannot auto-resolve a rename while an identical twin still exists.

Scope and limits. Mutations are synthetic but applied systematically (60-sample stride, no clock, no randomness). Each corpus was run once, which is sufficient because every result is deterministic and bit-identical under shuffle. Public datasets are modeled as dependency graphs, not used in their original tabular form.

Impact

Most relevance and importance scores are heuristic and drift between runs. Spiderbrain's does not. It is deterministic, it is identity-safe under churn, and it generalizes from source code to clinical trials to earthquakes on the same engine. That is the property an AI agent needs from its memory: a structural map it can act on, replay and audit, that says the same thing today and next week. This is the foundation under context engineering, the difference between a model that re-reads everything and one that knows what matters.

What this means, by domain

Software & code

On three real codebases (Saroir, perform.digital and Spiderbrain itself) the engine concentrated importance on the handful of files that carry the system, and held identity safe through 91 real content-hash collision groups with zero silent misattachment. For agents and engineers, that means attention lands where failure actually hurts, and the map does not drift.

People analytics

On 1,470 employee records, signal lift was the highest we measured (+141%), pulling the few factors that truly drive attrition out of hundreds of fields.

Insurance

On 1,338 policy records, the engine ranked the high-leverage risk factors (+103%) so underwriting attention lands where it counts, with identity safe through a real collision group.

Clinical trials

Across six therapeutic areas and 6,000 trial records, lift held in a tight 1.48× to 1.60× band, isolating the pivotal criteria consistently instead of spiking on one area and missing another.

Diagnostics

On 569 breast-cancer cases, lift was +91%, surfacing hidden-critical features rather than only the obvious ones.

Geophysics & materials

On the largest graph we ran (2,000 earthquake nodes) and a 339-node materials set, lift held at +86% and +94%, showing the method scales without losing its edge.

Spiderbrain itself

Run on its own 1,525-node codebase, the engine found 7 masters and clean community structure (modularity 0.46), and its shortcut audit returned INDEPENDENT, confirming the metrics are not proxies of one another. The blind-spot index correctly declined to score: with no commit history loaded the variance was too low, so the diagnostic refused to emit noise rather than invent a number. We ship a tool we run on ourselves.