Document Git LFS runtime bundle workflow

README.md

@@ -26,6 +26,28 @@ pyro mcp serve
 The public user-facing interface is `pyro` and `Pyro`.
 `Makefile` targets are contributor conveniences for this repository and are not the primary product UX.
 
+## Repository Storage
+
+This repository uses Git LFS for the packaged runtime images under
+`src/pyro_mcp/runtime_bundle/`.
+
+Fresh contributor setup:
+
+```bash
+git lfs install
+git clone <repo>
+cd pyro
+git lfs pull
+make setup
+```
+
+The large files tracked through LFS are:
+
+- `src/pyro_mcp/runtime_bundle/**/rootfs.ext4`
+- `src/pyro_mcp/runtime_bundle/**/vmlinux`
+
+If you are working from an older clone created before the LFS migration, reclone or realign your branch to the rewritten history before doing more work.
+
 ## Capabilities
 
 - Firecracker microVM execution with bundled runtime artifacts
@@ -198,3 +220,12 @@ Runtime build and validation helpers remain available through `make`, including:
 - `make runtime-materialize`
 - `make runtime-boot-check`
 - `make runtime-network-check`
+
+Space cleanup after runtime work:
+
+```bash
+rm -rf build
+git lfs prune
+```
+
+Recreating `.venv/` is also a straightforward way to reclaim local disk if needed.