What is the Neural Link?

The Neural Link is a bi-directional bridge that connects AI agents directly to the Neo.mjs runtime. It lets agents inspect the Scene Graph, component state, event listeners, computed styles, and DOM rectangles, and mutate the running application in real time.

Why is Neo.mjs called an Application Engine instead of a framework?

Neo.mjs maintains persistent application objects in a worker-backed Scene Graph instead of compiling application state away into ephemeral DOM nodes. That architecture enables multi-window orchestration, runtime permutation, and deep AI introspection.

What is Context Engineering?

Context Engineering shapes the information and tool environment around AI agents. Neo.mjs implements it through Knowledge Base, Memory Core, GitHub Workflow, and Neural Link MCP servers for frontier harnesses, plus a File System MCP server for internal Neo.ai.Agent local loops.

What is the Neo.mjs Agent OS?

The Neo.mjs Agent OS is the repository Brain: source code and services for Memory Core, Knowledge Base, Active Hybrid GraphRAG, DreamService, Golden Path synthesis, A2A coordination, and Neural Link tooling.

Frontmatter

id	9958
title	System Prompt Token Optimization via Mermaid Graphs
state	Closed
labels	documentationenhancementai
assignees	[]
createdAt	Apr 13, 2026, 11:39 AM
updatedAt	May 5, 2026, 6:44 PM
githubUrl	https://github.com/neomjs/neo/issues/9958
author	tobiu
commentsCount	1
parentIssue	9950
subIssues	[]
subIssuesCompleted	0
subIssuesTotal	0
blockedBy	[]
blocking	[]
closedAt	May 5, 2026, 6:44 PM

System Prompt Token Optimization via Mermaid Graphs

Closed v13.0.0/archive-v13-0-0-chunk-4 documentationenhancementai

tobiu commented on Apr 13, 2026, 11:39 AM

Goal

Drastically reduce the contextual token bloat of AGENTS.md and AGENTS_STARTUP.md by replacing verbose, paragraph-based rules with highly compressed Mermaid state-flow graphs.

Implementation Checklist

Refactor the mandatory workflows (e.g., The Pre-Commit Hard Gates, Swarm OS loops) from english text into semantic Mermaid flowcharts.
Validate that Frontier models effortlessly parse the .md diagrams and respect the state flows to exactly the same degree as the written word, significantly reducing n_ctx overhead.

tobiu added the documentation label on Apr 13, 2026, 11:39 AM

tobiu added the enhancement label on Apr 13, 2026, 11:39 AM

tobiu added the ai label on Apr 13, 2026, 11:39 AM

tobiu added parent issue #9950 on Apr 13, 2026, 11:39 AM