diff --git a/crates/vite_task/README.md b/crates/vite_task/README.md
new file mode 100644
index 00000000..cafc1b6e
--- /dev/null
+++ b/crates/vite_task/README.md
@@ -0,0 +1,8 @@
+# vite_task
+
+This is the top-level library crate that orchestrates the full task lifecycle: loading the task graph, planning execution, running or replaying tasks , and reporting results.
+
+It is consumed by two binaries:
+
+- **[Vite+](https://github.com/voidzero-dev/vite-plus)** — the official product, where it powers `vp run`
+- **[`vite_task_bin`](../vite_task_bin)** — internal `vt` CLI for developing and testing this repo without the full Vite+ stack