diff --git a/README.md b/README.md
index 7c888d8..68612eb 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # Dev Tool
 
-Simple development script runner that builds itself on first use.
+Simple script runner that organizes and executes your development scripts. Builds itself automatically.
 
 ## Quick Start
 
@@ -13,25 +13,28 @@ cd dev
 ## Usage
 
 ```bash
-./dev run              # Run all scripts
+./dev ls               # List all scripts
+./dev run base         # Run specific script
 ./dev run docker       # Run scripts matching "docker"
-./dev ls               # List available scripts
+./dev run base -- arg  # Pass arguments to script
 ./dev new backup       # Create new script template
-./dev push             # Git push with security scan
+./dev push             # Commit, scan, and push to git
+./dev deps             # Check dependencies
+./dev completion bash  # Generate shell completion
 ```
 
 ## How It Works
 
-The `./dev` script:
+1. Put executable scripts in `runs/`
+2. Run them with `./dev run <name>`
+3. Check logs in `logs/`
 
-1. Detects your Linux architecture (amd64/arm64)
-2. Builds `bin/dev-linux-{arch}` if needed
-3. Runs your command
+The `./dev` wrapper automatically builds the Go binary when needed.
 
 ## Requirements
 
-- Linux (any distro)
-- Go installed: `sudo pacman -S go` (or your distro's equivalent)
+- Linux
+- Go: `sudo pacman -S go` (or your distro's package manager)
 
 ## File Structure
 
@@ -39,10 +42,19 @@ The `./dev` script:
 project/
 ├── dev*           # Launcher script
 ├── main.go        # Source code
-├── Makefile       # Build helper
 ├── bin/           # Built binaries
-├── runs/          # Your scripts
+├── runs/          # Your scripts go here
 └── logs/          # Execution logs
 ```
 
+## Features
+
+- Auto-detects executable scripts in `runs/`
+- Tab completion for script names
+- Automatic logging to `logs/`
+- Git integration with security scanning (GitLeaks)
+- Dependency checking
+- Cross-platform binary building
+- Shell completion support
+
 That's it! Clone and run `./dev` to get started.
diff --git a/runs/test b/runs/test
deleted file mode 100755
index d50e865..0000000
--- a/runs/test
+++ /dev/null
@@ -1,8 +0,0 @@
-#!/usr/bin/env bash
-# NAME: Enable and configure system services
-
-set -euo pipefail
-
-echo "Enabling and configuring system services..."
-
-exit 0
diff --git a/runs/tools/dev.sh b/runs/tools/dev.sh
deleted file mode 100755
index 3954e4a..0000000
--- a/runs/tools/dev.sh
+++ /dev/null
@@ -1,10 +0,0 @@
-#!/usr/bin/env bash
-# NAME: tools/dev script
-
-echo "Running tools/dev.sh script..."
-
-echo $1 $2 $3
-
-# Add your commands here
-
-echo "✅ tools/dev completed successfully"