Free preview

Chapter 1, in full. Right here.

No paywall, no email gate. If the writing clicks, two more chapters are waiting in the reader.

Chapter 01Part 1

The Day Data Started Talking Back

11 min read

Story

Maya was a senior data engineer at a large retail company. Her pipelines were clean. Her dashboards were trusted. Every morning her data quality checks turned green before she finished her first cup of coffee. For five years, that was her measure of a good day.

Then the company launched its first AI agent. Leadership called it a productivity revolution. Store managers, finance, and supply chain could finally ask questions in plain English and get answers in seconds. A press release went out. A board meeting praised the rollout. Maya's name was somewhere on a slide deck nobody read.

On day three, three different people asked the same question: how much inventory do we have available? The agent gave three different numbers. None of them were wrong. None of them were right either. Store managers meant stock on the shelf. Finance meant unsold units on the balance sheet. Supply chain meant units not yet promised to a customer.

Maya pulled the agent's reasoning trace and stared at it for a long time. The model had done exactly what she would have done: it read the most relevant table, picked the most obvious column, and returned a number. The number was technically correct against the source. It was just the wrong number for that person's question.

Maya's pipelines were perfect. The model was state of the art. The data quality checks still passed. But for the first time, the data was talking back, and what it said depended entirely on who was asking. That was the day she realized her job had quietly changed shape.

The real problem

For twenty years, data teams optimized for one thing: get the right numbers to the right dashboard at the right time. Humans did the interpretation. A finance analyst knew that available inventory in their world meant something different from operations. The meaning lived in their heads, not in the system.

Agents do not have that shared context. They read whatever the table is called and assume the column name is the truth. When the meaning is missing, a clean pipeline becomes a confident lie.

The problem is not the model. The problem is that enterprise data was never designed to be self-explaining. We built it for an audience that brought meaning with them. That audience is no longer the only one reading.

The simple idea

Every number in a company has two parts. The value, and the meaning behind the value. Dashboards only needed the value because a human supplied the meaning. Agents need both.

In simple terms, an agent is only as smart as the context it is given. In technical terms, this is the difference between a data layer and a semantic layer, between a catalog and a knowledge graph, between retrieval and reasoning.

But you do not need the jargon to get the point. A model without meaning is a smart visitor in a strange city with no map. It will confidently take you somewhere. It will not be where you wanted to go.

From the field

Six months after Maya's first agent went live, the retailer ran an internal review. The team pulled three months of agent conversations and tagged every answer where a human had to correct the agent or override the result.

Eighty-one percent of the corrections were not model errors. They were definition errors. The agent had used the wrong meaning of customer, the wrong meaning of revenue, the wrong meaning of in stock. The remaining nineteen percent were genuine reasoning mistakes or stale data — the things people had assumed would dominate.

The team had been about to spend a quarter upgrading to a more capable model. Instead, they spent that quarter writing one definition file for the top forty business terms, signed off by the owning team, served from one place every agent had to consult. By the end of the quarter, corrections dropped by more than half. The model had not changed at all.

The leadership lesson stuck: when an agent looks dumb, suspect the meaning before you suspect the model. Most of the time, the meaning is what was missing.

Why this matters now

In the dashboard era, a wrong number cost you a meeting. In the agent era, a wrong number can cost you a customer refund, a wrong reorder, or a regulatory filing.

Agents act. That changes everything. The cost of misunderstood data is no longer a slow conversation. It is an action taken at machine speed, often before anyone sees it.

This is why the next wave of data work is not about more pipelines. It is about teaching systems what your business actually means, in a form they can read on every request, every time.

A real-world example

A large home goods retailer rolled out an AI assistant for store managers. The first week, the assistant told a store in Atlanta they had 240 units of a popular chair available. The store promised them to a corporate buyer. Two days later, 180 of those units were already promised to online orders. The assistant had read on_hand_qty without knowing what allocated meant.

The fix did not require a smarter model. It required one definition, agreed across teams, that available means on hand minus allocated minus reserved, and that this definition is the only one the agent is allowed to use.

After that change, the same model with the same data started giving the same answer to every team. Not because it got smarter. Because it finally had context.

Going deeper

Look closely at why one definition was enough to fix the agent, and a pattern emerges. The agent's behavior is shaped less by the model weights and more by what it reads at the start of each request. That reading is called grounding, and grounding is where most enterprise AI succeeds or fails.

A weak grounding setup gives the agent raw tables and lets the model guess at relationships. A strong grounding setup gives the agent a short, authoritative description of the business domain, a list of the metrics it is allowed to compute, and the formula behind each one. The model then has nothing to guess.

This is the quiet shift behind every well-behaved enterprise agent: the team moved from prompting tricks to grounding discipline. They stopped trying to coax the model into being smarter and started feeding it a better starting view of the world.

When you read about retrieval-augmented generation, semantic layers, ontologies, or context engineering, you are reading about different parts of the same idea: control the agent's input before you try to control its output.

What this means for data professionals

For data engineers, the job grows beyond moving and shaping data. You now help define what the data means in a way machines can use.

For analytics engineers, the metric definitions you write in dbt or LookML or a semantic layer become the brain of every agent that touches your business.

For BI developers, dashboards are no longer the final product. They are one of many surfaces that consume the same trusted meaning.

For architects and platform engineers, the new question is: where does business meaning live, and how does every agent get to it safely?

For governance teams and data leaders, this is the moment to make meaning a first-class asset, owned, versioned, and reviewed like code.

Architecture thinking

Think of the new flow in plain words.

A business question arrives. The agent does not run to the raw tables. It first looks up the meaning of the words in the question — what does available mean here, what does customer mean here, what time window is implied.

Only then does it choose the right metric, check what it is allowed to read, fetch the numbers, and return an answer with a trace of where each number came from.

The model is the engine. The context layer is the steering wheel. Without it, speed only makes the crash bigger.

Common mistake

The most common mistake teams make is to give the agent more data. More tables. More documents. More retrieval. They assume that if the agent only had more to read, it would finally understand.

It does not work. More data without more meaning just makes the confusion confident. The agent ends up with five definitions of customer instead of two, and picks the wrong one with even greater certainty.

Anti-patterns to watch for
  • The dictionary in a wiki

    A page of definitions nobody updates and no agent reads. Looks like context. Acts like nothing.

  • The 'just give it everything' retrieval setup

    Dump every table description into a vector store and hope the model picks the right one. It will sometimes. It will fail loudly when it does not.

  • Definitions owned by the data team alone

    If finance and operations did not sign the definition, it is not the definition of the business. It is a guess in a notebook.

  • Different agents, different meanings

    Each team builds its own agent with its own glossary. Six months later, the agents disagree with each other in front of customers.

  • Static definitions in a fast-moving business

    A definition with no review cadence drifts. The world changed. The agent did not.

A better way

Start with the ten or twenty terms your business argues about most often. Available inventory. Active customer. Revenue. Churn. Open ticket. On time delivery.

Write one definition for each. Get the owning team to sign off. Put those definitions into a place every agent must consult before it answers. Make the agent show its definition with every answer.

You will be surprised how many AI problems quietly disappear.

How you know it is working
Green flags
  • Every AI answer cites the definition it used.
  • Each top business term has one named owner and a review date.
  • Agents fetch definitions from a queryable system, not a document.
  • Definition changes are reviewed like code changes.
Red flags
  • Two agents give different numbers for the same question.
  • Definitions live in slide decks and team wikis.
  • Nobody can name the owner of the company's definition of revenue.
  • Agent reasoning traces show raw column names and no business terms.
A simple checklist
  • Do we have one written definition for our top business terms?
  • Does every definition have a named owner?
  • Can an agent retrieve the definition before it queries the data?
  • Does every AI answer show which definition it used?
  • Can a business user challenge a definition without filing a ticket?
Mental model

A catalog tells you where the data lives. Context tells you what it means.

Quotable line

AI does not become enterprise-ready when it gets smarter. It becomes enterprise-ready when it gets context.

The practical takeaway

Clean data is the floor, not the ceiling. The teams who win in the agent era are the ones who treat meaning as a product: defined, owned, versioned, and served on demand.

Your pipelines made data trustworthy. Your context will make agents trustworthy. That is the work for the next decade, and it starts with the first definition you commit to source control on Monday.

Reflection questions
  1. Which three business terms in your company are most often misunderstood across teams?
  2. Where does the meaning of those terms currently live — in heads, in wiki pages, or in code?
  3. If you launched an agent tomorrow, which term would cause the first painful mistake?
Saved on this device
Also free — open in the reader
Continue the journey

Ready for Part 2 and beyond?

Unlock the remaining 28 chapters, the bonus library, and every future edition with the $59 lifetime pass.

We'll send Chapter 1, Chapter 2, and a sample PDF. No spam. Unsubscribe anytime.