Now/Practices

How engineering teams lose institutional knowledge, and how to stop it

Fenlo Team

Institutional knowledge is everything a team knows that is not written down anywhere a new person could find it: why a service is built the way it is, which shortcut is safe to take, who to ask about the billing system. It leaks out constantly, and most teams do not notice until the person who held it leaves.

Where it goes

Slack threads that scroll away. A hard question gets answered well, once, in a channel. Two weeks later it is buried under a thousand other messages and effectively gone.

Wikis that drift out of date. Documentation requires someone to notice a change happened and go update a page about it. That step gets skipped constantly, so the wiki says one thing and the code does another.

Decisions that live only in someone’s head. Why the team chose Postgres over DynamoDB, why a particular endpoint is deprecated but not removed. If it was never written anywhere, it only exists as long as that person is in the room.

Turnover. Every departure takes undocumented context with it. The bigger the team, the more of this happens quietly, in the background, every quarter.

What it costs

The direct cost is repeated questions. The same thing gets asked and answered every few months because nobody could find the first answer. The bigger cost is slower onboarding: a new engineer’s ramp time is mostly a function of how much undocumented context they have to absorb by asking people instead of finding it themselves.

There is also a decision-quality cost. Teams that cannot find prior context re-litigate settled decisions or repeat mistakes that were already made and learned from once.

What does not fix it

Telling people to document more. This works for a few weeks after the reminder and then reverts, because writing documentation is optional and answering a question in Slack takes ten seconds less effort.

A better wiki tool. Migrating from one documentation tool to another does not change the underlying behavior. The information still only exists if someone chose to write it down in the new place.

A general-purpose chatbot. A model with no access to your actual tools can restate general knowledge, but it cannot answer “why did we deprecate the old auth service” because it never saw the ticket where that was decided.

What reduces it

Search instead of documentation-only. If the original Slack thread, pull request, and ticket are already searchable, nobody has to have summarized them somewhere else first. The source is the documentation. This is the core idea behind enterprise search.

Answers with the source attached. A person trusts an answer faster when they can click through and verify it, which means they stop re-asking the same question in a new channel to double check it. See how cited answers work.

Permission-aware by default. Knowledge only gets shared if people trust it will not leak to the wrong audience. A system that mirrors existing access controls removes that hesitation, so more of the org’s actual knowledge stays searchable instead of getting locked in private channels out of caution.

Agents for the repeatable questions. Some questions come up constantly with a well-defined answer: how to request access to a system, what the on-call escalation path is. A scoped agent can answer these consistently without a human repeating the same explanation every week.

None of this requires anyone to write more. It requires making what already exists findable. Read more about what Fenlo is or how Fenlo compares to Glean if you are evaluating a knowledge platform.