$ less ~/notes/treat-knowledge-like-code.md

Why 10x AI agents are a myth

6 min read AI AgentsRAGEngineering

I used to believe the “10x AI agent” story for like a full week. Not because I am naive, but because the demos are genuinely clean. You paste some internal docs, add RAG, glue a tool call or two, and suddenly the agent answers questions like it has been working at your company since before you were born. Then you ship it to real users, and in the first day it starts making confident decisions using half context, wrong terminology, and one random outdated PDF that was named “final_v7_real_final.pdf”.

That is when you learn the painful thing. Most “agent failures” are not model failures. They are knowledge failures. The model is doing exactly what you asked. You just asked it to reason inside a messy room, with no labels, lights off, and a fan running at full speed.

The real bottleneck for LLMs is not IQ. It is context. In small controlled settings, a model can read a single document and behave like a genius. In a real company setting, everything is fragmented. The terms are inconsistent, the rules live in someone’s head, and the “source of truth” is three different sources arguing with each other. When you dump all of that into a prompt, you are not giving the model knowledge. You are giving it anxiety.

This is also why the plug and play RAG fantasy breaks fast. People imagine retrieval as a magical step that always fetches the exact right thing. In reality, retrieval gives you a pile of text that is sometimes relevant, sometimes redundant, sometimes conflicting, and sometimes politely wrong. And when your context gets longer, models do not magically become more faithful. They can miss important pieces in the middle, over weight shiny recent chunks, or just pick the sentence that sounds most confident. So you end up building a fancy search assistant that can talk, but you still cannot trust it to act.

Now look at the places where agent like systems actually work today. Coding is the obvious one. It works because code is structured, and because feedback is immediate. If the agent writes nonsense, the compiler screams. If it breaks behavior, tests scream. Even if there are no tests, production will scream eventually, but we do not talk about that part.

Law is similar in a weird way. It looks unstructured from outside, but internally it is insanely structured. Cases, statutes, precedents, definitions, citations, and a whole culture built around “show me the source.” So when a model operates in that world, it has rails. It has a map. It has a way to justify claims.

Most business knowledge does not look like that. It looks like Slack threads, Google Docs, tribal rules, and one spreadsheet that is treated like a family heirloom. So when people say “just add your data to the model,” what they really mean is “please become an expert in our company by reading our chaos.” The model tries. But it cannot infer what is missing, what is outdated, what is unofficial, what is policy, and what is just some intern experimenting at 2 am.

If you want agents that actually work, treat knowledge like code. Not as a motivational quote. Literally like code. It needs ownership, structure, reviews, versioning, and boring discipline. The same stuff we hate in the moment but love when things break.

The first step is making your knowledge machine readable. This does not mean “write longer docs.” It means define schemas. If you have a process, express it as something the system can validate. If you have rules, express them as data with clear fields, constraints, and examples. If you have terms, define them once, and make everything reference that definition. The goal is not beauty. The goal is no ambiguity.

The second step is governance. Pick owners. Put it in version control. Add review flows. Track changes. Make updates part of the job, not an optional side quest. If a doc is outdated, that is not a doc problem. That is an ownership problem. And if you do not fix it, your agent will confidently inherit your org’s worst habit: being wrong with confidence.

The third step is feedback loops. In coding, we have tests. For knowledge, you need something similar. If the agent answers incorrectly, you need to trace where the wrong answer came from. Was it retrieval. Was it the source being wrong. Was it a missing rule. Was it two sources conflicting. Then you patch the knowledge base, not just the prompt. Over time, your knowledge starts behaving like a maintained system instead of a museum.

If this sounds like a lot of work, yes. That is the point. The 10x story is not “LLM + PDFs = autonomy.” The real story is “LLM + well structured knowledge + boring maintenance = reliability.” It is less sexy, but it scales. And it is the only version that survives real users who ask follow ups, change terms mid sentence, and casually mention edge cases like it is nothing.

If you want a pragmatic place to start, do not aim for autonomy first. Use RAG to improve discovery. Keep retrieval small. Re rank aggressively. Prefer trusted sources. Let the system say “I am not sure” instead of forcing an answer. Build dashboards for top failure patterns. Treat wrong answers like bugs. If you fix the knowledge, the agent improves in a way that feels unfair, like you upgraded the model without paying the model bill.

So yeah, 10x AI agents are a myth. Not because agents are useless. But because the myth skips the unglamorous part. The agent is not the product. The knowledge is the product. The agent is just the UI you wrap around it.

And if your knowledge is currently a random folder named “Docs,” do not worry. Most companies are in the same place. Just do not call it an agent yet. Call it a prototype. Your future self will thank you. Your users will also thank you, mostly by not roasting your bot in the group chat.

← All writing