The Biscuit

A biscuit joint uses a thin, oval-shaped piece of compressed beechwood — the biscuit — inserted into matching slots cut in two boards being joined edge to edge. The biscuit is dry when inserted. When glue is applied, the biscuit absorbs moisture and swells, tightening the joint from inside. The biscuit does not provide the joint's strength — the glue does that. The biscuit provides alignment: it prevents the two boards from sliding out of registration while the glue sets. It is a temporary alignment device that becomes a permanent fixture.

Dowel pins in furniture assembly work the same way. When a tabletop is glued to an apron, or a shelf to a side panel, the dowels register the pieces in exact alignment during clamping. Once the glue cures, the dowels are structurally redundant — the glue bond is stronger than the dowel. But without the dowels, the pieces would shift during clamping, and the glue joint would cure in the wrong position. The dowel is a biscuit of registration: it exists for the minutes of assembly, but it stays forever.

In software deployment, a feature flag serves the biscuit function between old and new code. During deployment, both the old behavior and the new behavior exist in the codebase. The feature flag aligns the transition — routing users to the new behavior incrementally while the old behavior remains available as a fallback. Once the new behavior is confirmed stable, the flag is nominally unnecessary — the new code runs for everyone. But like the biscuit, the flag often stays in the codebase long after the transition is complete, a permanent remnant of a temporary alignment need.

The biscuit is the principle of alignment that outlives its purpose. The joint's strength comes from the glue. The deployment's stability comes from the tested code. But neither can reach its final state without the alignment mechanism that held things in place during the transition. The biscuit's contribution is temporal — it matters most during the minutes or hours when the system is between states. After that, it does nothing. But removing it would mean trusting that the alignment it provided was not also providing something else — a shear pin, a moisture bridge, a backup registration that no one tests until the day it matters.