Adopt scripts-to-rule-them-all: script/ entrypoints, Makefile shims

README.md

@@ -556,6 +556,35 @@ Do not commit directly to `main`. Do not skip steps.
 
 Repository policies for AI agents are in [`AGENTS.md`](AGENTS.md).
 
+## Entrypoints
+
+This repository adheres to the
+[Scripts to Rule Them All](https://github.com/github/scripts-to-rule-them-all)
+standard: normalized scripts in `script/` are the entrypoints for the
+development workflow, and the Makefile targets are thin shims that call
+them. We provide:
+
+* `script/bootstrap` — install all development dependencies (go,
+  golangci-lint, Go module download)
+* `script/setup` — make a fresh clone ready for development: runs
+  `script/bootstrap`, then `script/install-precommit`
+* `script/projectname` — print the project name (used for the Docker
+  image tag)
+* `script/test` — run the test suite (verbose rerun on failure)
+* `script/lint` — run `golangci-lint run ./...`
+* `script/fmt` — format all code (writes)
+* `script/fmt-check` — check formatting (read-only)
+* `script/check` — run `script/test`, `script/lint`, and
+  `script/fmt-check`
+* `script/docker` — build the Docker image tagged via
+  `script/projectname`
+* `script/cibuild` — CI entrypoint: `docker build .` (the Dockerfile
+  runs the checks)
+* `script/precommit` — pre-commit gate: `go mod tidy` + `go fmt` (must
+  not change files), then `script/check`
+* `script/install-precommit` — install the git pre-commit hook that
+  runs `script/precommit`
+
 ## license
 
 [MIT](https://opensource.org/license/mit/)