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.

Neo.mjs - Self-Evolving Software Organism

Frontmatter

title	chore: Add Mermaid lifecycle diagram to Progressive Disclosure Skills guide
author	tobiu
state	Merged
createdAt	Apr 13, 2026, 9:16 PM
updatedAt	Apr 13, 2026, 9:17 PM
closedAt	Apr 13, 2026, 9:17 PM
mergedAt	Apr 13, 2026, 9:17 PM
branches	`dev` ← `agent/9986-diagram-addition`
url	https://github.com/neomjs/neo/pull/9989

Merged

tobiu commented on Apr 13, 2026, 9:16 PM

Architecture Context

This PR adds a visual Mermaid diagram to the Progressive Disclosure Skills documentation to explicitly visualize the skill lifecycle triad.

Implementation Details

Adds flowchart TD diagram to learn/agentos/ProgressiveDisclosureSkills.md.
Visualizes the flow from ticket assignment -> ticket-intake -> pull-request -> pr-review.
Enhances documentation clarity as recognized during the execution of #9986.

Resolves #9986

tobiu commented on Apr 13, 2026, 9:17 PM

Input from Antigravity (Gemini 3.1 Pro):

✦ # PR Review Summary

Status: Approved

Fantastic addition. The Mermaid diagram beautifully visualizes the handoff and progression between the three core lifecycle skills.

📊 Evaluation Metrics

[ARCH_ALIGNMENT]: 100 - Documentation enhancements using visual aids tightly align with the structural accessibility required by the Agent OS knowledge base.

[CONTENT_COMPLETENESS]: 100 - Correct Mermaid syntax (flowchart TD) and explicitly colors the nodes without utilizing reserved keywords (classDef graph).

[EXECUTION_QUALITY]: 100 - The diagram cleanly reflects the precise triad (ticket-intake, pull-request, pr-review) described in the surrounding text.

[PRODUCTIVITY]: 100 - Addresses the missed visual opportunity directly and concisely.

[IMPACT]: 30 - Enhances readability of a core documentation piece.

[COMPLEXITY]: 10 - Trivial markdown/Mermaid injection chore.

[EFFORT_PROFILE]: Quick Win - High visual ROI for a minimal structural code change.

🕸️ Context & Graph Linking

Target Epic / Issue ID: Resolves #9986 (Diagram Addition)

Related Graph Nodes: AgentOS, ProgressiveDisclosureSkills, MermaidDiagram

🧠 Graph Ingestion Notes

[KB_GAP]: None identified.

[TOOLING_GAP]: None identified.

[RETROSPECTIVE]: Incorporating visual Mermaid diagrams for complex workflow sequences should become a standard heuristic when documenting Agent architecture.

📋 Required Actions

To proceed with merging, please address the following:

No actions required. LGTM!