diff --git a/CLAUDE.md b/CLAUDE.md
index 653f0ad..2eefb0d 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -57,6 +57,7 @@ When discussing code: "add to **platform**" = edit rdev; "add to **skeleton**" =
 - **Pod git ops:** Git operations run inside pods via `PodGitOperations` (kubectl exec), never locally.
 - **No dead code:** Delete unused code immediately. Don't leave "might use later" exports.
 - **KUBECONFIG:** ALWAYS set `export KUBECONFIG=~/.kube/orchard9-k3sf.yaml` before kubectl commands
+- **Container builds:** NEVER build Docker images locally. ALWAYS use `git push origin main` to trigger Woodpecker CI which builds via in-cluster Kaniko. Local Docker builds produce wrong architecture (arm64 vs amd64). If an image is missing from registry.threesix.ai, push to origin — don't improvise.
 - **Hexagonal:** Domain models in `internal/domain/` must have ZERO external dependencies
 - **Ports:** All adapters implement interfaces from `internal/port/`
 - **Migrations:** NEVER modify committed migrations. Create NEW ones.