docs: add motivation section explaining the problem gw solves

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

diff --git a/README.md b/README.md
index a26adc0eda3638f7344ae14d48041af404f61b28..c5e9b3ed32e4715a1f917e67fbf1070d073ed5ac 100644 (file)
--- a/README.md
+++ b/README.md
@@ -2,6 +2,14 @@
 
 Git worktree manager that mirrors branch names to directory paths.
 
 
 Git worktree manager that mirrors branch names to directory paths.
 

+## Why
+
+When switching between branches and features, getting pulled in different directions throughout the day, the constant `git stash`, `git checkout`, `git stash pop` cycle becomes tedious and error-prone. I needed a cleaner way to keep different workpaths separated so I could jump between tasks instantly.
+
+Git worktrees solve this perfectly: each branch lives in its own directory with its own working state. But setting them up cleanly is clunky - you end up with scattered directories and manual bookkeeping.
+
+`gw` aims to be that clean setup. It organizes worktrees into a predictable structure where branch names map directly to directory paths (`feature/auth` → `feature/auth/`), and switching is instant.
+

 ## Install
 
 ```bash
 ## Install
 
 ```bash