diff --git a/README.md b/README.md
index dd76554..fc8ee93 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,20 @@
-# vibe_projects
+# Project
 
+## Quickstart (Windows PowerShell)
+```powershell
+powershell -ExecutionPolicy Bypass -File scripts/bootstrap.ps1
+python scripts/contextpack.py
+powershell -ExecutionPolicy Bypass -File scripts/check.ps1
+```
+
+## Quickstart (Linux / WSL)
+```bash
+bash scripts/bootstrap.sh
+python scripts/contextpack.py
+bash scripts/check.sh
+```
+
+## GSD
+If using GSD:
+- Run `/gsd:new-project` to generate project truth docs and planning structure.
+- Use `/gsd:quick` for small tasks.