update backlog

backlog/tasks/task-4 - Improve-Mermaid-diagrams-in-docs-for-readability.md

@@ -0,0 +1,30 @@
+---
+id: TASK-4
+title: Improve Mermaid diagrams in docs for readability
+status: Done
+assignee: []
+created_date: '2026-02-11 07:11'
+updated_date: '2026-02-11 07:11'
+labels: []
+dependencies: []
+priority: medium
+---
+
+## Description
+
+<!-- SECTION:DESCRIPTION:BEGIN -->
+Refine Mermaid charts in documentation (primarily architecture docs) to improve readability, grouping, and label clarity without changing system behavior.
+<!-- SECTION:DESCRIPTION:END -->
+
+## Acceptance Criteria
+<!-- AC:BEGIN -->
+- [x] #1 Mermaid diagrams render successfully in VitePress docs build
+- [x] #2 Diagrams have clearer grouping, edge labels, and flow direction
+- [x] #3 No broken markdown or Mermaid syntax in updated docs
+<!-- AC:END -->
+
+## Final Summary
+
+<!-- SECTION:FINAL_SUMMARY:BEGIN -->
+Improved Mermaid diagrams in docs/architecture.md by redesigning both flowcharts with clearer subgraphs, labeled edges, and consistent lifecycle/runtime separation. Verified successful rendering via `pnpm run docs:build` with no chunk-size warning regressions.
+<!-- SECTION:FINAL_SUMMARY:END -->