All writing
AI Engineering

The Layer I Was Avoiding: Why Does Any of This Exist?

Features and entry points describe the system. Neither answers why it should exist. A BRD layer with provenance, approval, and drift detection — and the question of whether badges change behavior.

SA
Salah Al‑Nawah
May 23, 2026 · 2 min read
airequirementsbrdlattice

Features and entry points describe the system. Neither answers why it should exist. I’ve been avoiding the requirements layer because requirements documents are where good intentions go to die. Stale Word files, wrong within a month.

I’m trying anyway. A BRD in Lattice holds the problem, the goals, the success criteria, the scenarios, the constraints, and what was ruled out. It points down at the features that implement it, and each feature points back up. For existing code the chain runs in reverse: the tool drafts a BRD from code evidence, marks it draft with llm_from_code provenance, and a human must approve it before it counts.

The machine proposes. It never signs. I keep re-deriving this rule from different directions, which probably means it's a real principle and not a preference.

The detail I’m most attached to: approval pins a version. Edit the BRD afterward and a drift badge appears until a human re-approves. That one badge might be the difference between a living artifact and another dead document.

Future me: check whether the badge actually changed anyone’s behavior, or whether people just learned to ignore it.