Skip to content

feat(grill-graph): replace live Mermaid with on-demand bilingual mindmap - #2

Merged
LeaYeh merged 1 commit into
mainfrom
feat/grill-graph-mindmap
Jun 5, 2026
Merged

LeaYeh merged 1 commit into
mainfrom
feat/grill-graph-mindmap

Conversation

@LeaYeh

@LeaYeh LeaYeh commented Jun 5, 2026

Copy link
Copy Markdown
Owner

The live embedded Mermaid graph TD became unreadable as the decision graph grew past a few cross-edges. Replace it with an on-demand, data-driven, bilingual HTML mindmap and keep structured Markdown as the only live artifact.

  • resources/node-template.md: fixed Markdown node schema (live SSOT), with optional *_zh bilingual fields; maps mechanically to the renderer GRAPH JSON.
  • resources/mindmap-template.html: self-contained data-driven renderer forked from the architecture-diagram design system (not invoked). L->R layered-tree auto-layout, SVG edge layer + HTML node layer, hover-to-expand rejected options, bilingual nodes, cross-edges routed through a right gutter so lines are never occluded by nodes. Verified via headless Chrome render.
  • SKILL.md: remove the live-Mermaid mandate; render on demand / at convergence from the bundled template; add a Resources section.

Record ADR-0005 (Accepted); supersedes the Visualization decision in ADR-0002.

The live embedded Mermaid graph TD became unreadable as the decision graph
grew past a few cross-edges. Replace it with an on-demand, data-driven,
bilingual HTML mindmap and keep structured Markdown as the only live artifact.

- resources/node-template.md: fixed Markdown node schema (live SSOT), with
  optional *_zh bilingual fields; maps mechanically to the renderer GRAPH JSON.
- resources/mindmap-template.html: self-contained data-driven renderer forked
  from the architecture-diagram design system (not invoked). L->R layered-tree
  auto-layout, SVG edge layer + HTML node layer, hover-to-expand rejected
  options, bilingual nodes, cross-edges routed through a right gutter so lines
  are never occluded by nodes. Verified via headless Chrome render.
- SKILL.md: remove the live-Mermaid mandate; render on demand / at convergence
  from the bundled template; add a Resources section.

Record ADR-0005 (Accepted); supersedes the Visualization decision in ADR-0002.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@LeaYeh
LeaYeh merged commit c4e75f0 into main Jun 5, 2026
3 checks passed
@LeaYeh
LeaYeh deleted the feat/grill-graph-mindmap branch June 5, 2026 21:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant