cleanup structure

README.md

@@ -86,30 +86,30 @@ function backup_file(filename)
 end
 ```
 
-## Live Demos
+## 🎯 Examples
 
-Run these demos to see luash in action:
+Explore organized examples that demonstrate Luash features:
 
 ```bash
-# Basic features demo
-./luash demo_basic.luash
+# Start with the showcase for a complete overview
+./luash examples/09_showcase.luash
 
-# Quick comparison with bash
-./luash demo_quick_examples.luash
+# Learn step-by-step with numbered examples
+./luash examples/01_basic_features.luash
+./luash examples/02_quick_comparison.luash
+./luash examples/03_interpolation.luash
 
-# System administration tasks
-./luash demo_system_admin.luash
+# Try practical use cases
+./luash examples/04_system_admin.luash
+./luash examples/05_development.luash
+./luash examples/06_data_processing.luash
 
-# Development workflow automation
-./luash demo_development.luash
-
-# Data processing and analysis
-./luash demo_data_processing.luash
-
-# Interactive demo runner
-./luash run_demos.luash
+# Or use the interactive runner
+./luash run_examples.luash
 ```
 
+See [examples/README.md](examples/README.md) for the complete learning path.
+
 ### What You Get
 
 #### File System Operations
@@ -266,9 +266,12 @@ The interactive shell supports:
 - All luash preprocessing features
 - Multiline input for functions, loops, etc.
 - Command history with `.history`
+- Screen clearing with `.clear`
 - Special commands: `.help`, `.exit`, `.clear`
 - Real-time expression evaluation
 
+See [examples/08_repl_guide.luash](examples/08_repl_guide.luash) for a comprehensive guide.
+
 ### Debug Mode
 ```bash
 LUASH_DEBUG=1 ./luash script.luash