diff --git a/docs/middleware.yaml b/docs/middleware.yaml
index 08301bd..c2e2110 100644
--- a/docs/middleware.yaml
+++ b/docs/middleware.yaml
@@ -230,10 +230,11 @@
       - Customize error messages to balance info and security
 
 crossCuttingSummary:
-  - Most middleware operate early in the lifecycle before route handlers.
-  - Common risk: lack of proper async error handling and logging.
-  - Security concerns include IP logging, token management, and bypass risks.
-  - Scalability limited by in-memory caches and direct DB writes without batching.
-  - Recommendations focus on adding async error handling, queuing, rate limiting, and using distributed caches.
-  - Coupling generally low to moderate; dynamic loading and external services introduce risks.
-  - Architectural improvements include abstraction of logging, centralized security controls, and fallback strategies for external dependencies.
+  themes:
+    - Most middleware operate early in the lifecycle before route handlers.
+    - "Common risk: lack of proper async error handling and logging."
+    - Security concerns include IP logging, token management, and bypass risks.
+    - Scalability limited by in-memory caches and direct DB writes without batching.
+    - Recommendations focus on adding async error handling, queuing, rate limiting, and using distributed caches.
+    - Coupling generally low to moderate; dynamic loading and external services introduce risks.
+    - Architectural improvements include abstraction of logging, centralized security controls, and fallback strategies for external dependencies.