Engineering Knowledge
Organizational Reorganizations and Codebase Knowledge Loss
Reorgs destroy codebase knowledge that lives only in engineers' minds, not in code.
Yuki Harashima · October 8, 2026 · 10 min read
Section
7 stories in Engineering Knowledge
Reorgs destroy codebase knowledge that lives only in engineers' minds, not in code.
Documentation of past decisions prevents costly repetition as engineering teams grow.
How knowledge concentration in teams creates hidden operational risk.
Engineers must provide organizational context that AI agents cannot derive from code alone.
Static documentation decays faster than code changes, making wikis unreliable for engineering teams.
When senior engineers leave, 80% of their knowledge walks out the door with them.
Structural repo boundaries quietly concentrate organizational knowledge in a few senior engineers.