Correct the phase-build comments in script/lint and script/test (closes #141)

The comments said a phase that is not the last stage is built only when
--target names it. The canonical Dockerfile's last stage copies from both
phases, so a plain build builds them too. The comments now say what
--target does in every repository: it builds that phase and the stages
it depends on, nothing else. The headers no longer say each script
builds its phase alone, which is false wherever the phase depends on
another stage.

Model: opus-5-5

README.md

@@ -185,8 +185,13 @@ policies change.
 
 - **[template-app-go](https://git.eeqj.de/sneak/template-app-go)** — Go HTTP
   server template (Uber fx, chi, SQLite, session auth, Prometheus metrics)
-- **[go-template-repo](https://git.eeqj.de/clawbot/go-template-repo)** — Go HTTP
+- **[template-app-js](https://git.eeqj.de/sneak/template-app-js)** — JavaScript
-  service template, with a script that renames it for a new project
+  SPA template (Vite, Tailwind CSS v4, nginx Docker deployment)
+- **[template-app-python](https://git.eeqj.de/sneak/template-app-python)** —
+  Python web application template (FastAPI, uvicorn, pytest, black, ruff)
+
+When updating policies in this repo, also update the template repos to match
+(Makefile targets, Dockerfile conventions, CI workflows, required files, etc.).
 
 ## See Also
 

script/lint

@@ -1,11 +1,11 @@
 #!/bin/sh
 # script/lint: run the linter. Linting is a phase of the Dockerfile and
-# this builds that phase alone; the linter is never installed or run on
+# this builds that phase; the linter is never installed or run on
 # a developer host, where a shared result cache and a host-global lock
 # make its answer untrustworthy.
 #
-# The phase is not the last stage in the file, so it is built only when
+# --target builds the lint phase and the stages it depends on, nothing
-# --target names it. A new CACHEBUST value reruns every RUN step after
+# else. A new CACHEBUST value reruns every RUN step after
 # the ARG CACHEBUST line, since a cached lint layer is a lint that did
 # not run; unlike --no-cache, it keeps the layers above that line and
 # the cache mounts. This relies on every stage of the Dockerfile

script/test

@@ -1,8 +1,8 @@
 #!/bin/sh
 # script/test: run the test suite. Testing is a phase of the Dockerfile
-# and this builds that phase alone, on the same terms as script/lint:
+# and this builds that phase, on the same terms as script/lint:
-# --target because a phase that is not the last stage is built only when
+# --target so that only the test phase and the stages it depends on are
-# named, and a new CACHEBUST value because a cached test layer is a test
+# built, and a new CACHEBUST value because a cached test layer is a test
 # that did not run; unlike --no-cache, it keeps the layers above the ARG
 # CACHEBUST line and the cache mounts. This relies on every stage of the
 # Dockerfile declaring ARG CACHEBUST before every step that lints, tests