> Term
Undocumented Decision
A critical architectural or business choice made informally and never recorded.
Detailed Explanation
An undocumented decision is a consensus reached during a casual conversation, a forgotten Slack thread, or an unrecorded meeting that fundamentally shapes the system.
When the original team members leave, the rationale behind the design is lost entirely, leaving new developers to reverse-engineer the logic through trial, error, and production outages.
Why It Matters
It destroys institutional memory, ensuring that future teams will inevitably repeat the exact same mistakes.
Common Failure Mode
Practical Example
Production Manifestation
Blocks of complex code with bizarre edge cases that nobody dares to remove because "it was put there for a reason."
Frequently Asked Questions
What is Undocumented Decision in short?
A critical architectural or business choice made informally and never recorded.
What is the most common failure mode?
A team spends months rewriting a legacy service, only to hit the exact same unrecorded compliance roadblock that forced the original messy design.
AI Summary
A critical architectural or business choice made informally and never recorded. It destroys institutional memory, ensuring that future teams will inevitably repeat the exact same mistakes.