diff --git a/build/golden-image/README.md b/build/golden-image/README.md
index caeb453..aa758a9 100644
--- a/build/golden-image/README.md
+++ b/build/golden-image/README.md
@@ -6,13 +6,11 @@ at VM boot time.
 
 ## How It Works
 
-```
-blueprint.toml          image-builder          Containerfile
-  (packages)  ──────►  build qcow2  ──────►  FROM scratch
-                        (Fedora 42)           COPY qcow2 → /disk/
-                                                    │
-                                              containerdisk
-                                               OCI image
+```mermaid
+flowchart LR
+    BP["blueprint.toml<br/>(packages)"] --> IB["image-builder<br/>build qcow2<br/>(Fedora 42)"]
+    IB --> CF["Containerfile<br/>FROM scratch<br/>COPY qcow2 → /disk/"]
+    CF --> CD["containerdisk<br/>OCI image"]
 ```
 
 1. **`blueprint.toml`** — declarative package manifest consumed by osbuild.
diff --git a/catalog/redis-bench/README.md b/catalog/redis-bench/README.md
index 86e0bb2..411c503 100644
--- a/catalog/redis-bench/README.md
+++ b/catalog/redis-bench/README.md
@@ -7,27 +7,17 @@ latency percentiles.
 
 ## Architecture
 
+```mermaid
+flowchart TD
+    SVC["K8s Service<br/>virtwork-redis-bench:6379"] --> SRV
+    SRV["Server (1 VM)<br/>redis-server :6379<br/>/var/lib/redis"]
+    PV["10Gi persistent volume"] --> SRV
+    C0["Client 0<br/>redis-benchmark"] -->|DNS| SRV
+    C1["Client 1<br/>redis-benchmark"] -->|DNS| SRV
+    CN["Client N<br/>redis-benchmark"] -->|DNS| SRV
 ```
-                  ┌──────────────────────────────┐
-                  │ K8s Service                  │
-                  │ virtwork-redis-bench:6379     │
-                  └──────────┬───────────────────┘
-                             │
-                     ┌───────▼────────┐
-                     │  Server (1 VM) │
-                     │  redis-server  │
-                     │  :6379         │
-                     │  /var/lib/redis │◄── 10Gi persistent volume
-                     └───────▲────────┘
-                             │ DNS
-               ┌─────────────┼─────────────┐
-               │             │             │
-          ┌────┴───┐    ┌────┴───┐    ┌────┴───┐
-          │Client 0│    │Client 1│    │Client N│
-          │ bench  │    │ bench  │    │ bench  │
-          └────────┘    └────────┘    └────────┘
-                        (scale with --vm-count)
-```
+
+Scale clients with `--params workload.vm-count=N`
 
 ## Parameters