Skip to content

Commit 302b55c

Browse files
docs(agents): defer the image-refs routing edit to its own PR
This reverts commit 2f87cdc. AGENTS.md sits at the repository root, where no scoped CODEOWNERS rule matches it, so it falls through to the `*` catch-all owned by @kvaps and @lllamnyp alone. Every other path this PR touches (/.github/, /docs/, /hack/) lists @lexfrei, whose review already satisfies them. That single file is the only reason this PR still gates on an architect review, which is exactly the deadlock hack/codeowners-invariant.bats was written to describe. No substance is lost. docs/agents/image-refs.md carries the full consumer table and the paragraph explaining why overlay-main-images.sh and promote-packages-artifact.sh both stand outside the shared enumeration, and it stays in this PR. What goes away is the one-line routing summary in AGENTS.md that points at that file. It leaves AGENTS.md briefly describing overlay-main-images.sh as "a fourth consumer" while the detail file lists five rows; the detail file is the authoritative one, and the summary is re-landed on its own branch where a catch-all review blocks nothing else. Assisted-By: Claude <[email protected]> Signed-off-by: Myasnikov Daniil <[email protected]>
1 parent 2f87cdc commit 302b55c

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, 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
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
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)