Add instruction to avoid excessive irrelevant analogies

Author: andrewjong

.agents/skills/write-mkdocs-documentation/SKILL.md

@@ -568,6 +568,7 @@ Each major section should have an `index.md` that:
 - **Present tense:** "The module subscribes to..." not "The module will subscribe to..."
 - **Second person:** "You can configure..." not "One can configure..."
 - **Imperative for instructions:** "Install the package" not "You should install the package"
+- **No unnecessary analogies:** Avoid analogies that don't add technical clarity. Explain things directly as they are rather than comparing them to unrelated concepts.
 
 ### Be Specific
 

docs/development/beginner/key_concepts.md

@@ -48,7 +48,7 @@ graph LR
 
 ## How AirStack is Composed
 
-Think of AirStack as a set of **Lego blocks** that snap together through Docker Compose:
+AirStack simulates multiple separate machines (e.g. robots, GCS) that communicate with each other through Docker Compose:
 
 ```mermaid
 graph TD