diff --git a/DEVELOPER.md b/DEVELOPER.md
index 6e6138b..deef361 100644
--- a/DEVELOPER.md
+++ b/DEVELOPER.md
@@ -94,10 +94,13 @@ just build
 
 ### Adding a new package
 
-1. Create a new directory in `packages/`
-2. Initialize the package: `uv init packages/your-package-name`
-3. Update the package's `pyproject.toml` with appropriate metadata
-4. The package will automatically be included in the workspace
+1. Create the package directory in `packages/` and write its `pyproject.toml` before any source files.
+2. Register the package in the root `pyproject.toml`:
+   - Add `"packages/your-package-name"` to `[tool.uv.workspace] members`.
+   - Add `keycardai-your-package-name = { workspace = true }` under `[tool.uv.sources]`.
+3. Run `uv lock` to update the workspace lockfile.
+
+Workspace members are listed explicitly (no `packages/*` glob) so a half-bootstrapped or stray directory under `packages/` cannot accidentally enter the workspace.
 
 ## Package Structure
 
diff --git a/pyproject.toml b/pyproject.toml
index ba75b7b..9034cfe 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -49,12 +49,17 @@ Repository = "https://github.com/keycardai/python-sdk"
 Issues = "https://github.com/keycardai/python-sdk/issues"
 
 [tool.uv.workspace]
+# Listed explicitly so stray or half-bootstrapped dirs under packages/ cannot leak in.
 members = [
     ".",
-    "packages/*",
-    "packages/*/examples/*"
+    "packages/oauth",
+    "packages/starlette",
+    "packages/mcp",
+    "packages/mcp-fastmcp",
+    "packages/fastmcp",
+    "packages/a2a",
+    "packages/*/examples/*",
 ]
-# Exclude any packages that shouldn't be part of the workspace
 exclude = []
 
 [tool.uv.sources]