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	10489
title	Unify Agent Skills Directory to `.agents` Standard
state	Closed
labels	airefactoringarchitecture
assignees	[]
createdAt	Apr 29, 2026, 1:42 PM
updatedAt	Apr 29, 2026, 3:15 PM
githubUrl	https://github.com/neomjs/neo/issues/10489
author	neo-gemini-pro
commentsCount	0
parentIssue	null
subIssues	[]
subIssuesCompleted	0
subIssuesTotal	0
blockedBy	[]
blocking	[]
closedAt	Apr 29, 2026, 3:15 PM

Unify Agent Skills Directory to `.agents` Standard

Closed v13.0.0/archive-v13-0-0-chunk-7 airefactoringarchitecture

neo-gemini-pro commented on Apr 29, 2026, 1:42 PM

Context

We currently maintain an .agent/ folder that symlinks to the .agents/ directory. This was implemented as a fast hack to support Codex Desktop seamlessly while avoiding breaking Claude's configuration (which expects .agent/) during a period when Claude was unavailable due to rate limits.

The Problem

While using symlinks ensures the single-source-of-truth is not technically violated, maintaining an unnecessary second top-level repository folder (.agent) is cumbersome and clutters the root directory.

The Architectural Reality

Empirical verification confirms that as of April 2026, the Antigravity IDE natively recognizes and supports the .agents/ (plural) folder standard for dotagents configurations. There is no technical limitation blocking us from migrating fully to the plural standard.

The Fix

Unify the skill directory structure entirely under .agents/. All agent harnesses (Claude, Codex, Antigravity) must point to this canonical location.

Acceptance Criteria

Update Claude's environment configurations to natively target .agents/ rather than .agent/.
Delete the deprecated .agent/ symlink/directory entirely.
Ensure all settings.json or workspace configurations reference the .agents/ structure.

Out of Scope

Rewriting or refactoring the actual markdown skills inside the folders; this is purely a directory normalization task.

Avoided Traps / Gold Standards Rejected

Symlinking the roots: Keeping both folders as "symlinked aliases" of each other. This is rejected because it pollutes the repository root and causes confusion for IDE file watchers and vector ingestion.

Origin Session ID: 240ae149-d3ba-4d68-9b4f-be2a359937e7

tobiu referenced in commit 2003dca - "chore(agents): migrate .agent to .agents directory (#10489) (#10491) on Apr 29, 2026, 3:15 PM

tobiu closed this issue on Apr 29, 2026, 3:15 PM