Root Cause Analysis
Escalating past the visible symptom until you find the layer that actually produced it.
Root cause analysis is the discipline of continuing to investigate a fault past the first plausible explanation, until you reach the layer that actually produced it. Its practical test is simple: if a fix does not fully clear the symptom, that is evidence you have not found the cause yet — not an invitation to add a second patch beside the first.
The failure mode it guards against is the patch stack: three defensive changes at three different layers, each of which addressed something real but none of which was the cause. Stacked patches are expensive twice over. They cost the round trips it took to write them, and they leave behind code whose purpose nobody can reconstruct — a future reader cannot tell a real constraint from a superstition. See Chesterton's Fence for the other half of that problem.
Root cause work depends on Ground Truth. A hypothesis about a cause is worth exactly as much as the observation behind it, so the move is usually to go get one measurement — the computed style, the network request, the actual bytes on disk — rather than to reason forward from what the code appears to say. Observability is what makes that measurement cheap.
The same instinct applies one level up. When a fix introduces a Regression, the interesting question is not "what broke" but "what about the way I fixed it made this breakable". Fixing the substrate rather than the symptom is what keeps Technical Debt from compounding.
See also4
Falsifiability
A claim is only worth something if you know what observation would refute it.
Method46 connections
Reproducible Case
The smallest set of steps that reliably produces a fault, and the unit of real debugging.
Method25 connections
Silent Failure
A failure that produces no signal, so the absence of an error reads as success.
Method63 connections
Plausible Mechanism
A causal explanation that was inferred rather than tested, and reads as more rigorous for being specific.
Method63 connections
Linked from48
- Anchoring EffectMethod
A stated number pulls subsequent estimates toward it, regardless of relevance.
- Blameless PostmortemMethod
Analyzing an incident on the assumption everyone involved made a reasonable decision given what they knew at the time.
- Bone RemodelingBody & Medicine
Living bone is continuously resorbed and rebuilt, which is why fractures heal and why healing runs in stages.
- Broken Windows TheoryMeaning & Society
The hypothesis that visible disorder invites serious crime, and the long dispute over whether the evidence supports it.
- Cargo CultMethod
Imitating the visible form of a practice while the mechanism that made it work is absent.
- CascadeDesign & Interface
The algorithm deciding which declaration wins when several apply to the same element.
- Chesterton's FenceMethod
Do not remove something whose purpose you cannot explain.
- Correlation and CausationMethod
Two things moving together is evidence for a causal link but never proof of one, or of its direction.
- CronSystems & Tooling
Time-based scheduling of recurring jobs, and the reasons scheduled jobs quietly stop working.
- CSS Custom PropertyDesign & Interface
A user-defined CSS property that participates in the cascade and inherits down the tree.
- DaemonSystems & Tooling
A long-running background process managed by the operating system's service supervisor.
- DeprecationMethod
Marking something as superseded and scheduled for removal, without removing it yet.
- Design TokenDesign & Interface
Named design decisions — color, spacing, radius, type — stored as data so they can be shared and re-themed.
- DispersionMatter & Energy
Refractive index varies with wavelength, so a medium bends colors by different amounts.
- Exhaustive ClaimMethod
A statement of the form "the last one" or "nothing else does this" — load-bearing, and only as good as the search behind it.
- Factory GamePlay & Games
A genre whose core verb is building the machine that plays the game, turning the player into a systems engineer.
- FalsifiabilityMethod
A claim is only worth something if you know what observation would refute it.
- Five WhysMethod
Repeatedly asking why a symptom occurred, chaining each answer into the next question until the causal chain runs out.
- Fracture NonunionBody & Medicine
A fracture that stops progressing toward healing, usually because of motion, gap or lost blood supply.
- GlobSystems & Tooling
Wildcard pattern matching over filenames, similar enough to regular expressions to mislead.
- Ground TruthMethod
The measurement that arbitrates, as opposed to the artifact that merely reports.
- Hanlon's RazorMethod
Never attribute to malice that which is adequately explained by stupidity.
- Hyrum's LawVersion Control & Delivery
With enough users, every observable behavior of an interface becomes a dependency for somebody.
- Inertial Frame of ReferenceMatter & Energy
A coordinate system in which an undisturbed body moves at constant velocity, and none is privileged.
- Monty Hall ProblemMethod
A conditional-probability puzzle in which switching wins twice as often as staying.
- ObservabilityMethod
How much of a system's internal state can be inferred from what it emits.
- Occam's RazorMethod
Prefer the explanation with fewer assumptions, not the one that is simplest to state.
- OverfittingMethod
A model that fits its training data too well has memorized noise instead of learning the pattern that generalizes.
- Pascal's PrincipleMatter & Energy
Pressure applied to a confined fluid is transmitted undiminished throughout it.
- Path DependenceMethod
Outcomes shaped by the sequence of past choices rather than by present merit.
- Planned ObsolescenceMeaning & Society
designing or marketing a product for a shorter useful life than it could otherwise have.
- Polarized LightMatter & Energy
Light whose electric field oscillates in a preferred orientation, and the filters that select for it.
- RegressionMethod
A previously working behavior that a change has broken.
- Reproducible CaseMethod
The smallest set of steps that reliably produces a fault, and the unit of real debugging.
- Rolling ResistanceMatter & Energy
The energy a rolling tire loses to deformation, and why more pressure stops helping.
- Rubber Duck DebuggingMethod
Explaining a problem aloud, in full detail, to a listener who cannot help — and finding the fault while explaining it.
- Scoped StylingDesign & Interface
Confining a set of style decisions to a subtree so the same component can look different in different contexts.
- Segmented SleepBody & Medicine
The claim that pre-industrial night sleep came in two blocks separated by a waking interval, and the dispute over how general that was.
- Silent FailureMethod
A failure that produces no signal, so the absence of an error reads as success.
- Streetlight EffectMethod
Looking where the light is good rather than where the answer is.
- Survivorship BiasMethod
Drawing conclusions from a sample already filtered by success.
- Technical DebtMethod
The future cost of a present shortcut, metaphorically accruing interest.
- Test-Driven DevelopmentTesting & Verification
Writing a failing test first, making it pass, then improving the code with the test as a net.
- Time ZoneSystems & Tooling
Civil time is a political layer over solar time, and its rules change often enough to be data.
- Truncation BiasMethod
Reading a truncated result as if it were the whole result, so every counterexample is invisible.
- Vapor-Compression RefrigerationMatter & Energy
A closed loop that moves heat by boiling and condensing a working fluid at two pressures.
- XY ProblemMethod
Asking for help with your attempted solution (Y) instead of your actual problem (X), so the help solves the wrong thing.
- Yak ShavingMethod
A chain of prerequisite tasks that stands between you and the task you meant to do.