docs(workspace): document uv member workflows

README.md

@@ -21,6 +21,35 @@ contracts.
 - `runtime/`: planning and execution orchestration.
 - `api/`: REST/MCP transport adapters.
 - `storage/`: timeline, task, and device configuration persistence.
+- `packages/cloud-platform/`: cloud scheduling, device pooling, plugins, and
+  the Python cloud SDK as the `device-cloud-platform` workspace member.
+
+## Python Workspace
+
+The repository uses a uv workspace with one committed lockfile. From the
+repository root, synchronize every Python member with:
+
+```bash
+uv sync --locked --all-packages
+```
+
+Run the complete local test suite in a workspace environment:
+
+```bash
+uv run --all-packages pytest -m "not integration"
+```
+
+Select one member when running package-specific commands:
+
+```bash
+uv run --package device-agent-runtime python -c "import runtime"
+uv run --package device-cloud-platform python -c "import cloud"
+uv build --package device-agent-runtime
+uv build --package device-cloud-platform
+```
+
+The Vue/Vite application under `console/` remains an independent npm project;
+uv does not install or modify its JavaScript dependencies.
 
 ## Project Direction