Author SHA1 Message Date
sneak 29dcf38205 Remove the build-cache text from the policies (closes #179)
check / check (push) Successful in 14s
Cache busting was a one-time error, fixed; the policy no longer
mentions Docker's build cache for check builds. Removed from
REPO_POLICIES: the "Check builds use Docker's normal cache" rule with
its prune warning and its planted-defect rule (added after cache
busting began, inside that rule), the sentence on the image build
reusing the gate phases, and the comparison with Docker's layer cache
in the -count=1 passage. The README's cache paragraph and the
existing-repo checklist item on --no-cache and CACHEBUST are gone too.

Model: opus-5-5
2026-11-16 22:42:00 +00:00
3 changed files with 8 additions and 33 deletions

No files matched your search

-4
View File
@@ -144,10 +144,6 @@ alpine. We provide:
`make hooks` installs the pre-commit hook that runs `script/precommit`. `make hooks` installs the pre-commit hook that runs `script/precommit`.
The builds use Docker's normal cache: a step runs again only when its inputs
change. This repo's own `Dockerfile` installs git, make, node and yarn right
after `FROM` in every stage, so a change to `script/` keeps that layer.
## Rationale ## Rationale
LLM prompts, especially development policies, benefit from version control and a LLM prompts, especially development policies, benefit from version control and a
-3
View File
@@ -49,9 +49,6 @@ with your task.
`--target` names it, so a lost `COPY --from=` edge leaves `docker build .` `--target` names it, so a lost `COPY --from=` edge leaves `docker build .`
passing while the gate never runs. Confirm by planting a violation, not by passing while the gate never runs. Confirm by planting a violation, not by
reading the file. reading the file.
- [ ] No `docker build` in `script/` passes `--no-cache` or a cache-busting
build argument such as `CACHEBUST`, and no `Dockerfile` stage declares
`ARG CACHEBUST`.
- [ ] Go: each Go stage downloads the modules (`COPY go.mod go.sum ./`, - [ ] Go: each Go stage downloads the modules (`COPY go.mod go.sum ./`,
`RUN go mod download`) before `COPY . .`; the steps that compile `RUN go mod download`) before `COPY . .`; the steps that compile
(`golangci-lint run`, `go test`, `go build`) mount Go's build cache (`golangci-lint run`, `go test`, `go build`) mount Go's build cache
+8 -26
View File
@@ -297,23 +297,6 @@ style conventions are in separate documents:
- the settings - the settings
- the golangci-lint version - the golangci-lint version
- **Check builds use Docker's normal cache.** On an unchanged tree Docker reuses
each step's stored result, and it stores a result only for a step that
succeeded. A step runs again when one of these changes:
- the base image
- its own line or a line above it
- the files copied before it
Nothing needs to run again on an unchanged tree. Never prune the build cache
(`docker builder prune` and the like): it is shared with every other build
on the host. When a check is added or changed, prove it works:
- plant a defect it must catch
- watch the run fail on it
- revert the defect
A green run alone shows neither that the check ran nor that it covers what
it should.
- **The gate phases are separate stages, and the build stage depends on both.** - **The gate phases are separate stages, and the build stage depends on both.**
The lint phase is based on the `golangci/golangci-lint` image (pinned by The lint phase is based on the `golangci/golangci-lint` image (pinned by
hash), so lint failures surface in seconds rather than after a full compile. hash), so lint failures surface in seconds rather than after a full compile.
@@ -617,8 +600,7 @@ style conventions are in separate documents:
A new push then cancels the older run on the same branch, queued or running, A new push then cancels the older run on the same branch, queued or running,
and no other: runs for replaced commits do not hold up the shared runner. and no other: runs for replaced commits do not hold up the shared runner.
`script/cibuild` bootstraps, runs the gate phases, and then builds the image, `script/cibuild` bootstraps, runs the gate phases, and then builds the image,
so a successful run means every check passed. The image build reuses the gate so a successful run means every check passed. The `check` job sets
phases that the check has just built. The `check` job sets
`timeout-minutes: 20`, so a hung build frees the shared runner after 20 `timeout-minutes: 20`, so a hung build frees the shared runner after 20
minutes. That allows for the three Docker builds described above, each held to minutes. That allows for the three Docker builds described above, each held to
the 5-minute Docker build limit below, plus the bootstrap. Those builds are the 5-minute Docker build limit below, plus the bootstrap. Those builds are
@@ -732,13 +714,13 @@ style conventions are in separate documents:
tests. It leaves the build cache alone, so it costs the runtime of the suite tests. It leaves the build cache alone, so it costs the runtime of the suite
and no recompilation. and no recompilation.
That cache is Go's own, separate from Docker's layer cache. Go stores a That cache is Go's own. Go stores a passing result in its cache directory
passing result in its cache directory (`GOCACHE`). When the same tests run (`GOCACHE`). When the same tests run again on unchanged code, it prints that
again on unchanged code, it prints that result, marked `(cached)`, without result, marked `(cached)`, without running them. The directory lasts from
running them. The directory lasts from one run to the next on a developer's one run to the next on a developer's machine, where this target runs. The
machine, where this target runs. The directory also lasts in the `test` directory also lasts in the `test` phase of the `Dockerfile`, which mounts
phase of the `Dockerfile`, which mounts it to keep compiled packages between it to keep compiled packages between check builds, so the phase's `go test`
check builds, so the phase's `go test` runs carry `-count=1` too. runs carry `-count=1` too.
Python example: Python example: