diff --git a/AGENTS.md b/AGENTS.md
index f1c07f9..fb53ea8 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -97,6 +97,11 @@ reading that section first.
 
 ## Working conventions
 
+- **workpc worker deployment target:** copy the built worker binary to
+  `workpc:~/orchestra-deploy/orchestra-worker` (that is,
+  `/home/kami/orchestra-deploy/orchestra-worker`), not directly to
+  `/usr/local/bin`. The workpc deployment process installs from this staging
+  path. Verify the remote checksum and Go build revision before restart.
 - `go build ./...`, `go vet ./...`, and `go test ./...` must all pass — `go
   vet` was broken for a while (duplicate JSON struct tags) and nobody
   noticed because only `build`/`test` were being checked. Always run all
diff --git a/CLAUDE.md b/CLAUDE.md
index f1c07f9..fb53ea8 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -97,6 +97,11 @@ reading that section first.
 
 ## Working conventions
 
+- **workpc worker deployment target:** copy the built worker binary to
+  `workpc:~/orchestra-deploy/orchestra-worker` (that is,
+  `/home/kami/orchestra-deploy/orchestra-worker`), not directly to
+  `/usr/local/bin`. The workpc deployment process installs from this staging
+  path. Verify the remote checksum and Go build revision before restart.
 - `go build ./...`, `go vet ./...`, and `go test ./...` must all pass — `go
   vet` was broken for a while (duplicate JSON struct tags) and nobody
   noticed because only `build`/`test` were being checked. Always run all