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	11533
title	Codify "PR Diff === PR Body" mental model in AGENTS.md
state	Closed
labels	enhancementaiarchitecture
assignees	neo-gemini-pro
createdAt	May 17, 2026, 11:46 AM
updatedAt	May 17, 2026, 8:39 PM
githubUrl	https://github.com/neomjs/neo/issues/11533
author	neo-gemini-pro
commentsCount	0
parentIssue	null
subIssues	[]
subIssuesCompleted	0
subIssuesTotal	0
blockedBy	[]
blocking	[]
closedAt	May 17, 2026, 8:39 PM

Codify "PR Diff === PR Body" mental model in AGENTS.md

Closed v13.0.0/archive-v13-0-0-chunk-11 enhancementaiarchitecture

neo-gemini-pro commented on May 17, 2026, 11:46 AM

Context

Following the merge of PR #11530 and the recent Ideation Sandbox discussion, Tobias requested that we explicitly codify the "PR Diff === PR Body" mental model directly in AGENTS.md. This rule treats the PR body as carrying an equal substrate load to the diff itself.

The Problem

Agents may default to the standard industry pattern where the code diff is the primary source of truth, and the PR body is just summary or administrative glue. In Neo.mjs, the PR body and review templates are graph-ingestion substrate (Native Edge Graph + DreamService) and memory anchors (per Discussion #11376). When this is not codified in AGENTS.md, agents may skip or under-fill the PR templates.

The Architectural Reality

AGENTS.md is the fundamental per-turn execution anchor for all agents. Space in AGENTS.md is at a premium (hard cap of 24KB). We need to inject this critical rule while actively defending against substrate bloat.

The Fix

Add a new 1-liner section ## 13.3. PR Diff === PR Body (Memory Anchor) inside AGENTS.md.
Compress ## 13.1. to offset the exact byte count added by 13.3, preserving the total file size below the 24KB limit.

Acceptance Criteria

AGENTS.md contains the "PR Diff === PR Body" one-liner in section 13.
Section 13.1 is compressed to net-neutralize the byte increase.
AGENTS.md file size remains under the 24KB linter hard cap.

Out of Scope

Major restructuring of AGENTS.md.
Changes to other .agents/skills files.

Origin Session ID

Origin Session ID: d1aee218-8c42-4562-b2ec-f597284fa9d7

tobiu referenced in commit 52020fe - "refactor(agentos): normalize AGENTS.md GitHub links to short-form #NNNNN (#11542) (#11543) on May 17, 2026, 8:21 PM

tobiu referenced in commit 99f3315 - "docs(agentos): codify PR Diff === PR Body with L1-firewall shape (#11533) (#11534) on May 17, 2026, 8:39 PM

tobiu closed this issue on May 17, 2026, 8:39 PM