diff --git a/readme.md b/readme.md
index 1cb36e6..b37ab8b 100644
--- a/readme.md
+++ b/readme.md
@@ -555,6 +555,12 @@ deno run --allow-all mod.ts help
 # Run tests
 deno task test
 
+# Run the main regression suite used during focused changes
+deno test --allow-all test/test.ts
+
+# Run the full suite, including focused seam tests
+deno test --allow-all test/
+
 # Type check
 deno task check
 
@@ -595,6 +601,14 @@ modelgrid/
 └── bin/                      # npm wrapper
 ```
 
+Focused seam tests live alongside `test/test.ts`:
+
+- `test/api-router_test.ts` covers routing, auth failures, and request-size handling
+- `test/api-server_test.ts` covers health, metrics, and authenticated model listing
+- `test/modelgrid-config_test.ts` covers config normalization and ignored-key warnings
+- `test/model-registry_test.ts` covers fallback and file-backed catalog loading
+- `test/cluster-manager-persistence_test.ts` covers persisted cluster state loading and pruning
+
 ## 🗑️ Uninstallation
 
 ```bash
diff --git a/readme.plan.md b/readme.plan.md
index 010fbe0..de3da73 100644
--- a/readme.plan.md
+++ b/readme.plan.md
@@ -61,7 +61,7 @@
 ### Pending Tasks
 
 - [ ] Integration testing with real GPUs
-- [ ] End-to-end API testing
+- [x] End-to-end API smoke testing for health, metrics, and authenticated model listings
 - [ ] Documentation improvements
 - [ ] First release (v1.0.0)
 
@@ -133,6 +133,17 @@ modelgrid/
 └── docs/                     # Documentation
 ```
 
+## Test Commands
+
+```bash
+deno task check
+deno test --allow-all test/test.ts
+deno test --allow-all test/
+```
+
+The focused seam tests currently cover API routing, API server endpoints, config normalization,
+model registry loading, and cluster state persistence.
+
 ---
 
 ## CLI Commands