Skip to content

Commit 37b814e

Browse files
docs(agents): correct the image-refs consumer ordinal
The routing bullet called hack/overlay-main-images.sh "a fourth consumer" from a time when three scripts sourced the enumeration. Four do now, so the ordinal names the wrong thing in the file every agent reads first. State the distinction instead of a count: overlay is the exception because it reads refs and walks the tree itself, so a newly declared file never reaches it, while hack/promote-packages-artifact.sh sources nothing because it publishes the whole tree and consumes no refs. One clause each, with the existing pointer to docs/agents/image-refs.md carrying the rest. Assisted-By: Claude <[email protected]> Signed-off-by: Myasnikov Daniil <[email protected]>
1 parent 9516dd7 commit 37b814e

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

‎AGENTS.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ This file provides structured guidance for AI coding assistants and agents worki
2020

2121
- **Image references, tags and digests** (e.g., "why is this image tagged rc", "add an image to a package", "change how an image is stamped", "promotion/nightly missed an image", "where do image refs live")
2222
- Read: [`image-refs.md`](./docs/agents/image-refs.md)
23-
- Action: Read the entire file. Image refs live in three storage shapes and carry three classes of tag; a tool that knows only one shape skips images silently rather than failing. `hack/lib/image-refs.sh` is the enumeration shared by the promote, retag and mirror tooling — extend it there rather than teaching an individual script a new path. Note `hack/overlay-main-images.sh` is a fourth consumer that still walks the tree itself and does not source the library
23+
- Action: Read the entire file. Image refs live in three storage shapes and carry three classes of tag; a tool that knows only one shape skips images silently rather than failing. `hack/lib/image-refs.sh` is the enumeration shared by the promote, retag, mirror and candidate-verify tooling — extend it there rather than teaching an individual script a new path. The one exception is `hack/overlay-main-images.sh`, which reads refs but walks the tree itself, so a newly declared file does not reach it; `hack/promote-packages-artifact.sh` sources nothing because it publishes the whole tree and consumes no refs at all — the doc carries both cases
2424

2525
- **Project structure, conventions, code layout** (e.g., "where should I put X", "what's the convention for Y", "how is the project organized")
2626
- Read: [`overview.md`](./docs/agents/overview.md)

0 commit comments

Comments
 (0)