Announcing US$ 3.2M pre-seed round · OneVC · Maya · Norte Ventures Read →
Back to blog

Context graph:
what it is and why it records the why behind decisions

In short

A sales director approves, for a renewal, a discount above the ceiling set by the policy. The CRM starts showing the new amount. The reason stays in the approval conversation: the customer received a proposal from another vendor, and another account in the same sector had a similar deal months earlier. The context graph is the structure that records this why and links it to entities and to time. It extends the knowledge graph of the Company Brain, the layer that knows the company: what data exists, where it lives, how it connects and who may see what.

The context graph records the why behind decisions next to the current state

CRM, ERP and helpdesk are systems of record. They keep the state: the contract value, the payment terms, the credit limit, the ticket priority. Almost none of them keep why that value was accepted in that case.

Exceptions, approvals, precedents and the cross-checking of information between systems stay in conversations, emails and the memory of whoever decided.

In December 2025, Jaya Gupta and Ashu Garg, of the investment firm Foundation Capital, described decision traces as the layer that systems of record leave out. In the piece, they use the term context graph for the structure formed by these traces accumulated across entities and time.

Rules say what applies in general and traces record the specific case

A sales rule defines the maximum discount per contract band. A decision trace records what happened in one case: which policy applied, which exception was requested, who approved, based on which precedent and with which data in view. Some examples:

  • Exceptional discount: a director approves a discount above the ceiling and records the justification.
  • Extended terms: finance grants a customer longer payment terms because an earlier case, with the same late-payment profile, was handled that way.
  • Credit exception: an analyst releases an order above the limit because the open invoice is being disputed with the legal team.

Each trace links a decision to the entities it affected, to the moment it happened and to the information consulted. Accumulated, the traces form the context graph, and precedent becomes searchable: when a similar exception was granted, by whom and with what justification.

Anatomy of a decision trace in the context graph: policy, exception, data consulted and approver
Each trace in the context graph records the policy, the exception, the data consulted and who approved

The knowledge graph models the state and the context graph adds the decision

The knowledge graph represents the business entities and the current relationships between them: this customer signed this contract, which gave rise to these orders.

The context graph uses the same entities as anchors and adds one type of node, the decision. Each decision points to the entities it affected, to the rule in force, to the exception granted and to the person who approved. The two structures depend on each other, because a trace without the right entity can only be retrieved by text similarity.

AI agents need precedent to handle exceptions

An agent that works only with rules handles the typical case well. Faced with an exception, it applies the rule to the letter or fills the gap with the most likely continuation, and the result departs from the company's practice.

With access to the traces, the agent retrieves similar earlier cases and presents them to the person deciding, with the current policy and the data that supported each approval. The exception decision stays human. The agent prepares the case, the person approves, adjusts or declines, and the trace records who decided and why.

Only whoever takes part in the moment of decision captures the trace

The authors' central argument is about architecture. The trace exists at the moment the decision is made: which data was consulted, which policy was assessed, which exception was requested and who approved. Whoever sits in that execution path records the context graph while the decision happens.

A system that reads the data later, through ETL (periodic loads into the data warehouse), receives the final state. It sees the contract with a discount above the ceiling and does not see the conversation that justified the discount. The why is lost along the way.

Context graph captured in the execution path compared with a periodic load that receives only the final state
The context graph forms where the decision happens, and the later load receives only the result

Decision traces need access rules, retention and compliance with Brazil's data protection law (LGPD)

A credit exception trace can contain the customer's financial situation and excerpts of internal conversation, and it inherits the sensitivity of every source it consulted.

  • Permissions: the trace is returned only to people who could already see the data it cites.
  • Retention: the company defines how long each type of trace stays available as precedent and when it is archived.
  • Policy version: each trace keeps the rule in force on that date, so that the precedent is read against the rule of that moment.
  • LGPD: when the trace involves personal data, the principles of purpose and necessity apply, and an erasure request needs to locate every trace linked to the data subject.

A first context graph starts with a process full of exceptions

The recommended starting point is a process with repeated decisions and many exceptions, such as discount approval, credit release or extended payment terms. The first step is to map where approval happens today and which data the approver consults before deciding.

Next, the approval flow starts recording each decision with its justification, approver, policy and entities. Over the following weeks, the team checks whether the retrieved precedents help whoever decides the next exception.

Get the next articles on the Company Brain