
✣
This Isn't a Detection Problem
Three Decisions the Evidence Forced
Record, Not Detect
Every engineer I talked to rejected a tool that flags these trade-offs as bugs. The decision already gets made informally. What's missing is the record, not a detector.
Timing Matters More Than Visibility
Two designers told me, independently, that a note left in the file goes invisible within days. The fix isn't a louder note. It's showing the information only at the exact moment someone's about to act against it.
Documentation Must Be Optional
Every entry gets saved automatically, with an optional note, never a required one. A required explanation is exactly what people skip under deadline pressure.
✣
What They Actually Said
"90% of the time production doesn't match Figma, it wasn't a mistake — it was a consciously negotiated engineering trade-off... Having a bot flag intentional decisions as 'bugs' creates friction where none needs to exist."
— Rajesh K., Engineering manager, async interview
"By day three? It's basically wallpaper... a small text string in the inspector panel is practically invisible."
— Priya I., Product Designer, async interview
What Changed
Stopped trying to catch problems automatically. Started designing to keep a record instead.
✣
Key Flows
Nothing Yet. → 2. Someone's about to repeat the old trade-off.
What happens
A designer tries to switch on the exact option that was already ruled out.
Why it matters
It's the clearest way to catch the exact moment someone's about to repeat a decision that was already made.
The Moment of Choice
What happens
The system shows what was already decided: who, why, and when.
Why it matters
This replaces a note nobody would keep reading with information that shows up exactly when it's needed.
What Happens After an Override
What happens
Choosing to go ahead anyway is saved automatically: who, and when, with room for a short note if they want one.
Why it matters
Requiring an explanation is exactly what gets skipped when a two-minute decision would take fifteen minutes to write up.
What Happens After Standing Firm
What happens
Choosing to leave things as they are gets saved the same way.
Why it matters
Without this, only "go ahead anyway" would leave a trace. Standing firm would look identical to a decision nobody ever questioned, and the exact problem this project exists to solve would quietly come back.
✣
Why the Flow Looks This Way
What this shows
Who decided, why, and when.
What this deliberately leaves out
Severity, ownership, and review status.
✣
Flow Validation
✣
Why This Project Matters
Future Opportunities
The Redesign Case Isn't Covered
Right now, the system only notices when someone directly changes the one thing a past decision was about. It doesn't catch a designer building something related nearby without touching that exact thing. That's a real gap. It gets named here instead of glossed over.
The Durable Fix Is Out of Scope
Two designers suggested the more durable fix: bake the constraint into the component so the disallowed option never appears. That's a design-system project. It's out of scope here, and it's the right long-term move.
Credits
Independent project, July–Aug 2026. Design and research original; conversations conducted with real engineering managers, engineers, and product designers.