diff --git a/README.md b/README.md
index eacf8746..2347f6d8 100644
--- a/README.md
+++ b/README.md
@@ -204,37 +204,41 @@ claudeman web
## Architecture
-```
- CLAUDEMAN
- ┌────────────────────────────────────────────────────────┐
- │ │
- │ ┌─────────────┐ ┌─────────────┐ ┌────────────┐ │
- │ │ Web UI │ │ REST API │ │ SSE │ │
- │ │ xterm.js │◄──│ Fastify │──►│ Events │ │
- │ └─────────────┘ └──────┬──────┘ └────────────┘ │
- │ │ │
- │ ▼ │
- │ ┌────────────────────────────────────────────────┐ │
- │ │ Session Manager │ │
- │ │ │ │
- │ │ ┌──────────┐ ┌──────────┐ ┌─────────────┐ │ │
- │ │ │ Session │ │ Session │ │ Respawn │ │ │
- │ │ │ (PTY) │ │ (PTY) │ │ Controller │ │ │
- │ │ └────┬─────┘ └────┬─────┘ └─────────────┘ │ │
- │ └───────┼─────────────┼────────────────────────┬┘ │
- │ │ │ │ │
- │ ▼ ▼ ▼ │
- │ ┌────────────────────────────────────────────────┐ │
- │ │ GNU Screen Manager │ │
- │ │ (Persistence) │ │
- │ └────────────────────┬───────────────────────────┘ │
- │ │ │
- │ ▼ │
- │ ┌────────────────────────────────────────────────┐ │
- │ │ Claude CLI │ │
- │ └────────────────────────────────────────────────┘ │
- │ │
- └────────────────────────────────────────────────────────┘
+```mermaid
+flowchart TB
+ subgraph Claudeman["🖥️ CLAUDEMAN"]
+ subgraph Frontend["Frontend Layer"]
+ UI["Web UI
xterm.js"]
+ API["REST API
Fastify"]
+ SSE["SSE Events
/api/events"]
+ end
+
+ subgraph Core["Core Layer"]
+ SM["Session Manager"]
+ S1["Session (PTY)"]
+ S2["Session (PTY)"]
+ RC["Respawn Controller"]
+ end
+
+ subgraph Persistence["Persistence Layer"]
+ SCR["GNU Screen Manager"]
+ end
+
+ subgraph External["External"]
+ CLI["Claude CLI"]
+ end
+ end
+
+ UI <--> API
+ API <--> SSE
+ API --> SM
+ SM --> S1
+ SM --> S2
+ SM --> RC
+ S1 --> SCR
+ S2 --> SCR
+ RC --> SCR
+ SCR --> CLI
```
---