From 430ea8371e3c65234af4c958a2feda96887ac091 Mon Sep 17 00:00:00 2001
From: ZDDC <caseywitt@proton.me>
Date: Wed, 10 Jun 2026 10:23:38 -0500
Subject: [PATCH] docs(claude): flag that Go runs via the podman wrapper, not
 the host
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The "Most-used commands" block showed `(cd zddc && go test ./...)` with no
note that Go isn't installed on the host — that bare command fails. Point at
the localhost/zddc-go:1.24 container (canonical invocation + required
GOPROXY/GOPRIVATE env in AGENTS.md § Test).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 CLAUDE.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index ffdf827..9e545e9 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -65,8 +65,11 @@ npm test                             # all Playwright specs (build first!)
 npx playwright test <tool>           # one spec
 ./dev-server start  # stop           # cache-busting HTTP on :8000
 
-# zddc/ Go server (sub-project)
-(cd zddc && go test ./...)           # unit tests (Go 1.24+)
+# zddc/ Go server (sub-project). Go is NOT on the host — run go test/build
+# through the localhost/zddc-go:1.24 container (canonical wrapper, with the
+# GOPROXY/GOPRIVATE env it needs, in AGENTS.md § Test). The bare command
+# below fails on the host.
+(cd zddc && go test ./...)           # unit tests (Go 1.24+) — via the podman wrapper, not host
 ```
 
 No lint/typecheck/format commands exist for the HTML tools — vanilla JS + POSIX sh by design.