diff --git a/cmd/atenet/readme.md b/cmd/atenet/readme.md
index 500cea3..b2bc833 100644
--- a/cmd/atenet/readme.md
+++ b/cmd/atenet/readme.md
@@ -38,5 +38,5 @@ RBAC permissions:
 
 ## testing
 
-hack/run-test.sh will execute a local smoke test with a fake ATE API server.
-This does not require any cluster and uses the fake ATE api server.
+Run the package tests with `go test ./cmd/atenet/...`. Cluster e2e
+tests use the shared `hack/run-e2e.sh` runner.
diff --git a/cmd/kubectl-ate/README.md b/cmd/kubectl-ate/README.md
index 025e671..c0e4bf3 100644
--- a/cmd/kubectl-ate/README.md
+++ b/cmd/kubectl-ate/README.md
@@ -114,7 +114,7 @@ Manage the execution state of your workloads.
 
 ```bash
 # Create a new actor deriving from a specific ActorTemplate
-kubectl ate create actor my-actor --template=ate-demo-counter/counter-template
+kubectl ate create actor my-actor --template=ate-demo-counter/counter
 
 # Resume an actor (assigns it to a free worker and restores its state)
 kubectl ate resume actor my-actor
diff --git a/internal/e2e/readme.md b/internal/e2e/readme.md
index 7bddd63..154fc7a 100644
--- a/internal/e2e/readme.md
+++ b/internal/e2e/readme.md
@@ -18,7 +18,9 @@ $ go test -v ./internal/e2e/suites/... -args -e2e
 
 ## Preconditions
 
-The e2e tests assume you have a cluster setup with `hack/install.sh`.
+The e2e tests assume you have a cluster set up with Agent Substrate installed,
+for example via `hack/install-ate.sh --deploy-ate-system` or
+`hack/install-ate-kind.sh --deploy-ate-system`.
 
 ## Creating a new test suite