Reproducible Case
The smallest set of steps that reliably produces a fault, and the unit of real debugging.
A reproducible case is a minimal, reliable procedure that produces a fault on demand. It is the fundamental unit of debugging, because everything else — bisecting, diagnosing, verifying the fix — depends on being able to trigger the behaviour at will.
Building one is often most of the work. The steps that matter are usually to fix the environment (a clean database, a restarted server, a known input) and then to remove everything that does not change the outcome. What remains is both the diagnosis and, frequently, the test.
A differential repro is the strongest form: two builds identical except for one variable, each producing a different observable. It converts "something in this upgrade broke fonts" into "this version emits the preload tags and that one does not", which is a fact rather than a theory. See Ground Truth.
Two habits keep repros honest. Write the reproduction before the fix, so you have seen the red — see Falsifiability. And distinguish a genuine repro from an intermittent one: a fault that appears once and clears on retry is a Flaky Test until proven otherwise, and reasoning about the code from a single occurrence usually wastes the afternoon.
See also5
Hand-picked in the note itself — the neighbours worth reading next.
Root Cause Analysis
Escalating past the visible symptom until you find the layer that actually produced it.
Method21 connections
Determinism
The property that identical inputs produce identical outputs, and the foundation of caching and verification.
Systems & Tooling27 connections
Race Condition
A defect whose occurrence depends on the relative timing of concurrent operations.
Testing & Verification11 connections
Regression
A previously working behaviour that a change has broken.
Method16 connections
Observability
How much of a system's internal state can be inferred from what it emits.
Method15 connections
Related2
Nearby in the graph rather than deliberately chosen. Looser, sometimes surprising.
Linked from14
Notes elsewhere in the wiki that reach for this one.
- BundlerWeb Platform
The tool that resolves an application's modules into the files a browser downloads.
- DeterminismSystems & Tooling
The property that identical inputs produce identical outputs, and the foundation of caching and verification.
- Flaky TestTesting & Verification
A test that passes and fails on identical input, and the most corrosive thing a suite can contain.
- Ground TruthMethod
The measurement that arbitrates, as opposed to the artifact that merely reports.
- InstrumentationTesting & Verification
Adding measurement to code so its execution can be observed, and the distortions that introduces.
- ObservabilityMethod
How much of a system's internal state can be inferred from what it emits.
- Procedural GenerationGraphics & Games
Creating content algorithmically rather than authoring it by hand.
- Race ConditionTesting & Verification
A defect whose occurrence depends on the relative timing of concurrent operations.
- RegressionMethod
A previously working behaviour that a change has broken.
- Root Cause AnalysisMethod
Escalating past the visible symptom until you find the layer that actually produced it.
- Seeded RandomnessGraphics & Games
Pseudorandom generation from an explicit seed, so any output is reproducible.
- ShaderGraphics & Games
A small program run on the graphics processor for every vertex or every pixel.
- Visual Regression TestingTesting & Verification
Comparing rendered output against a stored baseline to catch unintended visual change.
- VoxelGraphics & Games
A volumetric pixel — a value on a regular three-dimensional grid.