- Authors

- Name
- Baran Cezayirli
- Title
- Technologist
With 20+ years in tech, product innovation, and system design, I scale startups and build robust software, always pushing the boundaries of possibility.
- The Haystack Problem
- The Accumulation Trap
- What a Company Knowledge OS Looks Like
- The Onboarding and Bus Factor Dividend
- This Is a Team Design Problem
- The Substrate Scales
In The Age of the Personal OS, I argued that the scarce resource in an AI-augmented world is not the model — it is the substrate. The individual who has structured their expertise into something machine-consumable, opinionated, and navigable by an AI will compound over time. The individual who has not will use the same frontier model and get worse results. The model is identical; the substrate is not. That asymmetry is the point.
The same argument applies at company scale, and the failure mode at company scale is more expensive, more common, and more instructive. Every engineering leader I know is either deploying some form of AI knowledge retrieval or planning to. The near-universal instinct is to ingest everything — Confluence, Notion, Jira, Slack exports, code comments, runbooks, meeting transcripts — into a vector database and add a semantic search layer on top. That instinct is understandable. It is also precisely wrong. The difference between a company Knowledge OS and a company knowledge dump is not the retrieval technology. It is the discipline of curation.
The Haystack Problem
Vector databases and RAG architectures are genuinely powerful tools. The mistake is not reaching for them — it is thinking that ingesting more data into them solves a knowledge problem. It does not. It converts one problem into a harder one.
The core issue is that enterprise data is heterogeneous, noisy, and contextually entangled in ways that degrade retrieval quality at scale. A company's information landscape is not a clean corpus of well-formed documents. It is Slack threads where a decision was made in the middle of a tangential discussion, Confluence pages that were accurate at project launch and silently wrong six months later, Jira tickets where the real rationale lives in a comment chain, and ADRs that were written but never linked to anything. Chunk all of that into vectors and the retrieval system has a representational problem: the signal is in there somewhere, but it is surrounded by noise that is semantically adjacent to it. Cosine similarity cannot distinguish a current decision from a superseded one, a settled conviction from an abandoned hypothesis, or a rationale from a symptom.
Recent benchmarking makes the retrieval failure concrete. Testing agentic RAG systems against heterogeneous enterprise data, the best-performing methods achieved an average score of 32.96 on the benchmark — retrieval identified as the main bottleneck rather than the model (Zhang & others, 2025). The failure mode is not that the model gives a bad answer once it has the right context. It is that the retrieval step fails to produce the right context in the first place. More documents in the index does not improve this; it tends to worsen it, because every additional noisy document is another candidate the retrieval step might surface instead of the right one.
Consider the kind of question that actually matters in engineering: "Why did we choose Postgres over MongoDB for the billing service three years ago?" The answer to that question lives somewhere. Maybe in a half-finished ADR, maybe in a Slack thread from a Thursday standup, maybe in an engineer's head who has since left the company. A semantic search over the full ingested corpus will surface everything tangentially related to databases, billing, and infrastructure choices. Some of it will be relevant. None of it will be reliably the right answer. The model will synthesize a confident response from whatever the retrieval step returned, and nobody will know whether to trust it.
The Accumulation Trap
The root cause is not the retrieval technology. It is a prior assumption: that documentation is additive, and more documentation is always better than less. This assumption is wrong, and the cost of it compounds quietly for years.
Most enterprise knowledge infrastructure is optimized for writing, not for reading. Confluence makes it trivially easy to create a page. Notion makes nesting and sub-pages feel like organization. Jira makes adding comments frictionless. None of them impose any meaningful cost on adding noise. The result, after a few years, is the Confluence graveyard that every engineering organization has seen: thousands of pages, search that returns too many results, and institutional knowledge that lives not in the wiki but in the heads of the people who were there.
The productivity data is striking, even before AI enters the picture. Research on enterprise information-seeking shows that 21% of employee productivity is lost to locating and managing information, with managers spending an average of two hours per day in active information search (Cottrill, 2024). That is before AI retrieval added another layer of complexity. The information is present; the signal is buried. Adding a semantic search layer to a Confluence graveyard does not solve this. It gives the graveyard a more fluent voice.
The accumulation trap has a specific shape: low friction into the knowledge base means low signal density in the knowledge base. Every frictionless addition to the corpus is a vote for accumulation over curation. And unlike curation, which pays returns over time, accumulation pays returns immediately (the information is "saved") and costs returns over time (the information becomes noise). By the time the cost is visible, it is distributed across thousands of failed searches and two-hour information hunts that no one attributes to the root cause.
What a Company Knowledge OS Looks Like
The alternative to accumulation is curation — and curation is not a tool choice. It is a team practice, and it produces a fundamentally different kind of artifact.
The entry standard for a company Knowledge OS is not "is this a document?" It is a more demanding question: would a new engineer joining this team in six months need this to understand what we decided and why? That standard filters out implementation details that the code already expresses, status updates that became irrelevant when the project shipped, and exploratory notes that were useful during research and noise afterward. What remains is decision rationale, architectural tradeoffs, the lessons that cost something to learn, and the constraints that are non-obvious from reading the code.
The knowledge base grows organically because curation happens at the natural inflection points of engineering work, not as a separate documentation sprint. A sprint retrospective produces a knowledge entry when the team learned something that will change how they work. A postmortem produces an entry when the root cause reveals a constraint or assumption that applies beyond the incident. An architecture review produces an ADR that is not just a record of the decision but a record of the rejected alternatives and the reasoning behind the choice. None of this requires additional meeting time. It requires a team norm that treats knowledge capture as part of the work rather than a tax on it.
One structural detail matters more than it appears: confidence metadata. Not all knowledge is equal, and a knowledge base that treats every entry identically — a validated architectural decision filed the same way as an exploratory hypothesis from a hackathon — is not a knowledge base. It is noise with structure. The company Knowledge OS should reflect the epistemic status of each entry: this is a decision we have made and stand behind; this is a pattern we think applies but have not validated; this is speculation from a spike that did not make it to production. That distinction is what allows both humans and AI consumers to act differently on different entries — citing the confident ones, hedging on the partial ones, and declining to present the speculative ones as settled truth. The AI is only as trustworthy as the substrate it reads.
The Onboarding and Bus Factor Dividend
A well-maintained company Knowledge OS solves two problems that every engineering leader loses sleep over, simultaneously and from the same discipline.
The bus factor problem: organizational knowledge research consistently shows that tacit knowledge — the kind that lives in experience, judgment, and informal habits rather than documentation — represents the dominant share of what organizations actually know (Dalkir, 2017). A 2023 synthesis of the empirical literature put a number on the specific loss: roughly 42% of the expertise an employee uses in their role is known only to them and cannot be filled in by a replacement (Čabrilo & Ndou, 2023). That knowledge walks out the door on the last day of employment. The more senior the departure, the more expensive the loss — and the more invisible, because no one inherits a gap, they inherit silence.
The onboarding problem: new engineers spend weeks reconstructing context that already exists somewhere. They ask colleagues who were there, read code that does not explain its own constraints, and make decisions in ignorance of reasoning that was worked through before they joined. The institutional cost is not just the new hire's time — it is the senior engineer's time spent re-explaining the same decisions that were already made, and the decisions the new hire makes before the context catches up to them.
A curated company Knowledge OS changes both of these dynamics from the same direction. When a senior engineer leaves, their decisions, rationale, and hard-won lessons are in the OS — not as a sanitized summary in the onboarding handbook, but as the actual reasoning linked from the actual systems they designed. When a new engineer joins, they navigate structured context rather than conducting informational interviews. On day three they understand why the architecture is the way it is not because someone walked them through it, but because the reasoning is there, searchable, linked to the codebase. The departure is still a loss. It is no longer a catastrophic one.
This Is a Team Design Problem
The knowledge OS fails consistently when it is treated as an IT initiative. The platform gets deployed, a migration weekend moves the existing documentation, a slack message announces the new system, and within six months it is another graveyard. The platform is not the problem. The practice is the problem.
For a company Knowledge OS to work, it has to be embedded in how the team operates. Not as a separate obligation but as a natural output of the work that is already happening. The sprint retrospective ends with a check: did we learn something this sprint that changes how we would approach this problem? If yes, it goes in the OS. The postmortem ends with a check: does the root cause reveal a constraint that will matter the next time someone touches this system? If yes, it goes in the OS. The architectural decision review ends with a complete ADR — not just the decision, but the alternatives considered, the reasons they were rejected, and the assumptions the decision is contingent on. These are not additional steps. They are a slight shift in what the existing steps produce.
This means the knowledge OS is also a team design question — which I explored at length in We're Designing AI-Era Teams Without a Blueprint. Someone on the team needs the judgment to decide what earns a place in the OS and what does not. Not as a documentation role — that framing produces the wrong incentives, optimizing for volume rather than signal density — but as an operational discipline, the same way someone owns the incident response runbook or the on-call rotation. The right skills are the ones that complement each other: the engineers who make the decisions, and the people who have the judgment to recognize which decisions will matter to the team a year from now.
The compounding loop is the part worth sitting with. The time AI saves on mechanical knowledge work — drafting, summarizing, cross-referencing, retrieving — is not free margin. It is capital that should be reinvested into improving the substrate that makes future AI work better. A team that saves ten hours a week through AI assistance and spends one of those hours improving their knowledge OS will, over a year, have a materially better OS than they would have otherwise — which will produce better AI assistance — which will save more time. The loop is tight and the growth is real. The mistake is treating the time savings as throughput gain rather than substrate investment.
The Substrate Scales
Most of the strategic conversation about AI in companies is still about the model layer: which one, which provider, which context window, which fine-tuning approach. That conversation matters, and it is also the easy half of the question — increasingly commoditized, increasingly parallel across organizations. The harder half, and the part nobody else can do for you, is what you build underneath it.
The same principle I described at the individual level in The Age of the Personal OS applies at the organizational level: the model is the execution layer, and execution is becoming cheap. What does not become cheap is the substrate — the curated, team-maintained, confidence-tagged, AI-navigable record of what the organization actually knows and why. Every company will have access to the same foundation models at roughly the same price. The differentiator will not be which model they chose. It will be what they built for the model to work on.
The organizations that build the company Knowledge OS now — the ones that embed curation into their team practices, maintain signal density as the OS grows, and reinvest AI time savings into substrate quality — will compound over time. The same model will produce better answers in their systems than in their competitors', not because their model is better, but because their substrate is. The organizations that accumulate will have a very large haystack and a very capable needle that cannot find what it is looking for. At company scale, that is not a search problem. It is a strategy problem.