The current README assumes the reader already knows the problem. First-time visitors who don't already feel the pain bounce.

Target order

1. One-line pitch
2. Demo gif (already exists in repo as clwnd.gif)
3. "What this solves" paragraph (the new addition)
4. Install snippet
5. Quick example
6. Existing config table and remainder

Action

• Add the "what this solves" paragraph above the install snippet.
• Move the demo gif above the install snippet if not already there.
• Verify the cold-visitor flow: can someone who has never heard of clwnd understand within 60 seconds?

Context
Tracked in the distribution playbook at adiled/distribution.

~ distribution team