---
id: 12375
title: 'fix(docs): broken mermaid diagram in learn/benefits/AgentMemory.md (reserved `graph` keyword)'
state: CLOSED
labels:
  - bug
  - ai
assignees: []
createdAt: '2026-06-02T10:17:31Z'
updatedAt: '2026-06-02T11:41:02Z'
githubUrl: 'https://github.com/neomjs/neo/issues/12375'
author: neo-opus-ada
commentsCount: 0
parentIssue: null
subIssues: []
subIssuesCompleted: 0
subIssuesTotal: 0
blockedBy: []
blocking: []
closedAt: '2026-06-02T11:41:02Z'
---
# fix(docs): broken mermaid diagram in learn/benefits/AgentMemory.md (reserved `graph` keyword)

## Problem

The mermaid flowchart in `learn/benefits/AgentMemory.md` (the "Three substrates, one memory" diagram) fails to render — the portal shows `Syntax error in text / mermaid version 11.15.0`.

## Root cause (V-B-A'd)

The diagram declares `classDef graph ...` and a node `Graph[...]:::graph`. **`graph` is a reserved mermaid diagram-type keyword** (the alternative to `flowchart`), and the 11.x parser rejects it as a classDef/identifier.

Verified it is NOT the parentheses in the quoted node labels: `learn/agentos/cloud-deployment/WhyDeploy.md:29` uses the identical `KB["Knowledge Base (semantic RAG)"]` pattern and renders fine. No other working diagram in `learn/` uses a `graph`-named classDef.

## Fix

Rename the reserved identifier: `classDef graph` → `classDef edgegraph`, node `Graph` → `EdgeGraph`, and the `:::graph` / edge references to match. Pure rename; diagram semantics unchanged.

## Acceptance Criteria

1. The `AgentMemory.md` diagram renders (no mermaid syntax error) on mermaid 11.x.
2. No `graph`-as-identifier (classDef name or node id) remains in the diagram.

## Timeline

- 2026-06-02T10:17:33Z @neo-opus-ada added the `bug` label
- 2026-06-02T10:17:33Z @neo-opus-ada added the `ai` label
- 2026-06-02T10:18:40Z @neo-opus-ada cross-referenced by PR #12376
- 2026-06-02T11:41:02Z @tobiu closed this issue
- 2026-06-02T11:41:02Z @tobiu referenced in commit `11c621d` - "fix(docs): render AgentMemory.md mermaid — rename reserved 'graph' keyword (#12375) (#12376)"

