Skip to content
This repository was archived by the owner on May 7, 2026. It is now read-only.

Refactor README to use 'context engine' terminology #1463

Merged
goldmedal merged 3 commits into from
Mar 19, 2026
Merged

Refactor README to use 'context engine' terminology #1463

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
25ba370
Refactor README to use 'context engine' terminology
chilijung Mar 19, 2026
2451c7b
Update image in README.md for engine architecture
chilijung Mar 19, 2026
4ecad63
Update image in README for Wren Engine Challenge
chilijung Mar 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 9 additions & 6 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@
> Wren Engine is the open foundation behind Wren AI: a semantic, governed, agent-ready context layer for business data.

<p align="center">
<img width="1267" height="705" alt="with_wren_engine" src="https://github.com/user-attachments/assets/3a6531fe-4731-4f21-ae9a-786b219f3c0e" />
<img width="2194" height="1322" alt="engine-architecture" src="https://github.com/user-attachments/assets/acf06cf2-2428-423a-86d4-26efef31648e" />

@coderabbitai coderabbitai Bot Mar 19, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Use descriptive alt text for the new diagrams.

At Line 33 and Line 67, alt="engine-architecture" / alt="with_wren_engine" are filename-like. Please use human-readable descriptions so screen readers convey meaning.

Suggested update 
-  <img width="2194" height="1322" alt="engine-architecture" src="https://github.com/user-attachments/assets/acf06cf2-2428-423a-86d4-26efef31648e" />
+  <img width="2194" height="1322" alt="Wren Engine architecture overview showing context layer between agents and data sources" src="https://github.com/user-attachments/assets/acf06cf2-2428-423a-86d4-26efef31648e" />
-  <img width="1267" height="705" alt="with_wren_engine" src="https://github.com/user-attachments/assets/3a6531fe-4731-4f21-ae9a-786b219f3c0e" />
+  <img width="1267" height="705" alt="Workflow with Wren Engine providing business context for AI agents" src="https://github.com/user-attachments/assets/3a6531fe-4731-4f21-ae9a-786b219f3c0e" />

Also applies to: 67-67

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 33, Replace the terse filename-like alt text values in the
README image tags: change alt="engine-architecture" to a human-readable
description such as "Diagram of the engine architecture showing components and
their interactions" and change alt="with_wren_engine" to something like "Diagram
showing integration of the Wren engine with system components and data flow";
update the <img ... alt="engine-architecture" ... /> and <img ...
alt="with_wren_engine" ... /> tags in README.md accordingly so screen readers
get meaningful descriptions.

</p>

## Why Wren Engine
Expand All @@ -47,7 +47,7 @@ This is not just our thesis. In [Your Data Agents Need Context](https://a16z.com

Wren Engine exists to solve that gap.

It gives AI agents a semantic engine they can reason over, so they can:
It gives AI agents a context engine they can reason over, so they can:

- understand models instead of raw tables
- use trusted metrics instead of inventing SQL
Expand All @@ -63,6 +63,10 @@ We believe the future of AI is not tool calling alone. It is context-rich system

Wren Engine is our open source contribution to that future.

<p align="center">
<img width="1267" height="705" alt="with_wren_engine" src="https://github.com/user-attachments/assets/3a6531fe-4731-4f21-ae9a-786b219f3c0e" />
</p>

It is the semantic and execution foundation beneath Wren AI, and it is designed to be useful well beyond a single product:

- embedded in MCP servers and agent workflows
Expand Down Expand Up @@ -98,7 +102,7 @@ People often compare Wren Engine to catalog services like DataHub, raw database
The simple difference is:

- those tools usually help an agent find data or generate SQL
- Wren Engine helps an agent understand business meaning and produce the right query through a semantic engine
- Wren Engine helps an agent understand business meaning and produce the right query through a context engine

| Tool type | What it gives the agent | What Wren Engine adds |
| --- | --- | --- |
Expand Down Expand Up @@ -166,7 +170,7 @@ We want that context layer to be inspectable, composable, and community-owned, n
User / Agent
-> MCP Client or App (OpenClaw, Claude Code, VS Code, Claude Desktop, Cline, Cursor, etc.)
-> Wren MCP Server or HTTP API
-> Wren Engine semantic engine
-> Wren Engine context engine
-> Query planning and optimization
-> Your warehouse, database, or file-backed data source
```
Expand Down Expand Up @@ -272,7 +276,7 @@ cd mcp-server

## Project Status

Wren Engine is actively evolving in the open. The current focus is to make the semantic engine, execution path, and MCP integration stronger for real-world agent workflows.
Wren Engine is actively evolving in the open. The current focus is to make the context engine, execution path, and MCP integration stronger for real-world agent workflows.

If you are building with agents today, this is a great time to get involved.

Expand All @@ -281,7 +285,6 @@ If you are building with agents today, this is a great time to get involved.
- Join our [Discord community](https://discord.gg/5DvshJqG8Z)
- Open a [GitHub issue](https://github.com/Canner/wren-engine/issues)
- Explore [Wren AI](https://github.com/Canner/WrenAI) to see the broader product vision
- Read our mission piece: [Fueling the Next Wave of AI Agents](https://getwren.ai/post/fueling-the-next-wave-of-ai-agents-building-the-foundation-for-future-mcp-clients-and-enterprise-data-access)
- Read the market thesis from a16z: [Your Data Agents Need Context](https://a16z.com/your-data-agents-need-context/)

Wren Engine is for builders who believe AI needs better context, not just better prompts.
Loading