Frontmatter
| id | 9981 |
| title | [Guide] Agent OS Architecture Overview |
| state | Closed |
| labels | documentationenhancementai |
| assignees | tobiu |
| createdAt | Apr 13, 2026, 7:53 PM |
| updatedAt | Apr 13, 2026, 8:09 PM |
| githubUrl | https://github.com/neomjs/neo/issues/9981 |
| author | tobiu |
| commentsCount | 0 |
| parentIssue | null |
| subIssues | 9985 docs: add "The Dream Pipeline & Golden Path" guide 9986 docs: add "Progressive Disclosure Skills" guide |
| subIssuesCompleted | 2 |
| subIssuesTotal | 2 |
| blockedBy | [] |
| blocking | [] |
| closedAt | Apr 13, 2026, 8:09 PM |
[Guide] Agent OS Architecture Overview
Closeddocumentationenhancementai
tobiu cross-referenced by PR #9982 on Apr 13, 2026, 7:58 PM
tobiu assigned to @tobiu on Apr 13, 2026, 8:07 PM
tobiu closed this issue on Apr 13, 2026, 8:09 PM
tobiu cross-referenced by #9983 on Apr 13, 2026, 8:24 PM
tobiu cross-referenced by PR #9984 on Apr 13, 2026, 8:27 PM
tobiu cross-referenced by #9985 on Apr 13, 2026, 8:51 PM
tobiu cross-referenced by #9986 on Apr 13, 2026, 8:51 PM
tobiu added sub-issue #9985 on Apr 13, 2026, 8:51 PM
tobiu added sub-issue #9986 on Apr 13, 2026, 8:51 PM
tobiu cross-referenced by PR #9987 on Apr 13, 2026, 8:59 PM
Summary
Add a new top-level guide
agentos/ArchitectureOverviewto the learning portal that provides a comprehensive architectural map of the Neo.mjs Agent OS.Motivation
The "Agent OS & Conversational UIs" section currently has guides for individual MCP servers (Neural Link, Knowledge Base, Memory Core, GitHub Workflow, Code Execution) and Strategic Workflows, but no entry point that ties the entire system together. A developer or contributor encountering the Agent OS for the first time has no single document that explains:
Proposed Changes
1. New Guide:
learn/guides/agentos/ArchitectureOverview.md70334eab2. Update:
learn/tree.json"Architecture Overview"as the first child of"AgentOS"(parentId:"AgentOS", id:"agentos/ArchitectureOverview")Acceptance Criteria
tree.jsonupdated and the guide appears first under "Agent OS & Conversational UIs"manage_knowledge_base sync) so the guide is discoverable viaask_knowledge_baseA2A Context
70334eab-72c9-44a6-8f48-0b6a96604f49architecture_diagram.mdin the session artifacts directoryGUIDE_GAPidentified by the DreamService for the Agent OS top-level namespace. The guide serves both human contributors and future agent instances that need to understand the system topology before performing modifications.