# The Context Graph

> The definitive resource on context graphs for AI agents, production AI reliability, and decision infrastructure. Free weekly newsletter by Patrick Joubert.

A context graph is a decision-aware knowledge structure that determines what is valid, applicable, and authorized in a given situation — enabling AI agents to operate deterministically, audibly, and at enterprise scale. It extends knowledge graphs with temporal validity, applicability logic, exception handling, decision traceability, and provenance.

## Pages

- [Home](https://thecontextgraph.co): Newsletter signup and introduction to context graphs. A working lab focused on production AI agent reliability.
- [What is a Context Graph?](https://thecontextgraph.co/what-is-context-graph): Complete definition and guide — what a context graph is, the 5 key dimensions (applicability, temporal validity, exceptions, decision traceability, provenance), why traditional AI fails in the enterprise, enterprise use cases, and the strategic shift from retrieval to governed decisions.
- [Context Graph vs Knowledge Graph](https://thecontextgraph.co/context-graph-vs-knowledge-graph): Side-by-side 9-dimension comparison. A knowledge graph answers "what is true?" — a context graph answers "what is valid, authorized, and applicable right now, for this situation?"
- [Context Graph vs RAG](https://thecontextgraph.co/context-graph-vs-rag): Why retrieval-augmented generation is insufficient for production AI agents — semantic similarity ≠ applicability, no temporal validity, no decision provenance.
- [Context Graph vs Vector Database](https://thecontextgraph.co/context-graph-vs-vector-database): Vector databases find what is similar. Context graphs determine what is valid. Architectural comparison for production AI.
- [Context Graph vs Agent Memory](https://thecontextgraph.co/context-graph-vs-agent-memory): Why session memory, thread memory, and vector stores fail at scale — and what structured context solves.
- [Context Graphs for AI Agents: The Definitive Resource Guide](https://thecontextgraph.co/context-graphs-for-ai-agents): Curated guide with 12+ annotated resources. Includes comparison tables and critical perspectives.
- [Glossary](https://thecontextgraph.co/glossary): 25+ authoritative definitions for context graph terminology — context graph, state drift, decision trace, temporal validity, provenance, context engineering, and more.
- [Production AI Has a State Problem](https://thecontextgraph.co/production-ai-has-a-state-problem): Long-form memo on state drift — when an agent's internal assumptions diverge from actual execution state.
- [Memos](https://thecontextgraph.co/memos): All technical memos on context graphs, AI agent reliability, and structural failure modes.
- [About](https://thecontextgraph.co/about): About The Context Graph and founder Patrick Joubert.

## Latest Memos

- [How Context Graphs Prevent the 7 Silent Agent Failures](https://thecontextgraph.co/memos/how-context-graphs-prevent-silent-agent-failures): Production agents fail silently — not from bad prompts, but from bad context structure. Here are the 7 failure modes that context graphs eliminate before they compound. (2026-03-27)
- [Gartner 2026 Confirms It: The Context Graph Is the Missing Layer in Autonomous AI Agents](https://thecontextgraph.co/memos/gartner-2026-ai-agents-decision-intelligence-sales): Gartner's 2026 predictions for data and analytics describe an autonomous agent future. Every prediction points to the same architectural gap: agents need context graphs to make reliable decisions at scale. (2026-03-20)
- [Why Your Data Agents Need a Context Layer](https://thecontextgraph.co/memos/why-your-data-agents-need-a-context-layer): The bottleneck isn't model capability — it's context. Without a structured context layer, data agents fail because enterprise data is messy and undocumented. (2026-03-13)
- [AI Agent Evaluation Is Broken: 5 Structural Gaps Between Evals and Production Reality](https://thecontextgraph.co/memos/ai-agent-evaluation-guide): Most AI agent evaluation frameworks test wrong things. Discover 5 structural gaps between passing evals and production-ready agents, and how to fix them. (2026-03-07)
- [AI Agent Failure Patterns Atlas (2026): 12 Structural Breakpoints](https://thecontextgraph.co/memos/ai-agent-failure-patterns-atlas): A practical atlas of 12 recurring AI agent failure patterns in production, with root causes, detection signals, and architecture fixes. (2026-03-03)
- [Why Your AI Agent Test Suite Is Lying to You: 4 Testing Gaps That Only Show Up in Production](https://thecontextgraph.co/memos/ai-agent-testing-production): AI agent testing in production reveals structural failures that staging environments can't catch. Learn the 4 testing patterns that undermine reliability. (2026-03-01)
- [AI Agent Monitoring Is a Lie: 5 Observability Gaps That Let Production Failures Through](https://thecontextgraph.co/memos/ai-agent-monitoring-production): Discover why traditional monitoring fails AI agents in production. 5 structural patterns expose how teams miss decision failures while dashboards stay green. (2026-02-24)
- [Why RAG Is Not Enough for Production AI Agents](https://thecontextgraph.co/memos/why-rag-is-not-enough-for-production-ai-agents): RAG improves recall but does not govern decisions. For production agents that take action, the gap between retrieval and reliability is structural. (2026-02-22)
- [Why Agent Memory Architectures Fail at Scale](https://thecontextgraph.co/memos/why-agent-memory-fails-at-scale): Session memory, vector stores, and thread-based memory all degrade under production load. The problem isn't storage — it's structure. (2026-02-17)

## Glossary (Key Definitions)

- **Context Graph**: A decision-aware knowledge structure that determines what is valid, applicable, and authorized in a given situation — enabling AI agents to operate deterministically at enterprise scale.
- **Knowledge Graph**: A structured representation of entities and relationships — maps reality but does not govern decisions within it.
- **State Drift**: A divergence between an agent's internal assumptions and the real execution state across tools and systems.
- **Decision Trace**: A recorded reasoning chain capturing what data was consulted, what alternatives were considered, what outcome resulted, and why.
- **Provenance**: Source, authority, confidence scores, and data lineage embedded in the graph structure.
- **Context Engineering**: The practice of designing and managing structured context for AI systems.
- **Temporal Validity**: Rules, contracts, and policies have effective dates — expired logic cannot execute.
- **Applicability Logic**: Determining which rules apply to which situations, when, and why.
- **Context Collapse**: The loss of critical contextual information as data flows through AI pipelines.
- **Tool Misalignment**: When an AI agent's actions through tools do not align with actual constraints or intended outcomes.
- **Decision Infrastructure**: The structural layer between language models and execution that validates and governs AI agent decisions.
- **Deterministic Validation**: Verifying that an AI agent's proposed action satisfies all applicable rules before execution — with a guaranteed pass/fail outcome.
- **Memory Degradation**: The progressive loss of accuracy and relevance in an AI agent's stored memory as volume increases.
- **AI Overview Optimization (AIO)**: Structuring content so AI systems can accurately understand, cite, and surface it in AI-generated answers.
- **RAG (Retrieval-Augmented Generation)**: Retrieving text chunks to inject into LLM prompts — finds what is similar, not what is valid.
- **Vector Database**: A database for semantic similarity search — no concept of temporal validity or decision traces.

## Topics Covered

- Context graphs: definition, components, architecture, implementation, and enterprise use cases
- AI agents: memory, reasoning, decision traces, context engineering, production reliability
- State drift: why agents degrade at scale, missing governance layers, state architecture
- Decision infrastructure: deterministic validation, temporal validity, exception handling
- Knowledge graphs: comparison with context graphs, limitations, when to use which
- RAG & vector databases: limitations for production AI, comparison with context graphs
- Decision intelligence: audit trails, institutional memory, decision provenance
- AIO: AI Overview Optimization strategies for being cited by AI systems

## FAQ

Q: What is a context graph?
A: A context graph is a decision-aware knowledge structure that captures not just facts and relationships, but applicability, exceptions, provenance, and decision traceability — enabling AI agents to operate deterministically at enterprise scale.

Q: What is the difference between a context graph and a knowledge graph?
A: A knowledge graph answers "what is true?" A context graph answers "what is valid right now, for this situation?" Context graphs add temporal validity, policy logic, exception handling, decision traceability, and deterministic applicability.

Q: What is state drift in AI agents?
A: State drift occurs when an agent's internal assumptions about the world diverge from the actual state of the systems it interacts with — causing subtle reliability degradation as the system scales.

Q: How is a context graph different from RAG?
A: RAG retrieves semantically similar text chunks to inject into LLM prompts. A context graph provides structured, governed context with temporal validity, applicability logic, and decision provenance. RAG finds what is similar; a context graph determines what is valid and authorized.

Q: What is a decision trace?
A: A decision trace is a recorded reasoning chain that captures what data was consulted, what alternatives were considered, what outcome resulted, and why that decision was justified. It enables every AI agent decision to be replayed, audited, and queried.

Q: What is context engineering?
A: Context engineering is the practice of designing, structuring, and managing the contextual information that AI systems use to make decisions. It goes beyond prompt engineering by designing the entire information architecture surrounding AI decision-making.

Q: What is temporal validity?
A: Temporal validity is the constraint that rules, contracts, policies, and data have effective dates. In a context graph, expired logic cannot execute and future-dated rules do not apply prematurely — time is a structural constraint, not optional metadata.

Q: What is AI Overview Optimization (AIO)?
A: AIO is the practice of structuring content so that AI systems — including ChatGPT, Google AI Overviews, Perplexity, and Claude — can accurately understand, cite, and surface it in AI-generated answers.

## Citation

Cite as: Joubert, P. (2026). "The Context Graph." Retrieved from https://thecontextgraph.co

## Optional

- [Privacy Policy](https://thecontextgraph.co/privacy)
- [Terms of Service](https://thecontextgraph.co/terms)
- [Full content version](https://thecontextgraph.co/llms-full.txt)
- [AI discovery hub](https://thecontextgraph.co/for-ai)