Closed
Copy link
Description
🤖 Generated with Claude Code in an interactive session with the maintainer.
Evidence
Codex flagged two stale parts of the catalogue's contributor guide on #243. Both came over unchanged from devantler-tech/actions:
- The action README template in
actions/CONTRIBUTING.mdtells consumers to use…@main, and several action READMEs repeat@mainor a version tag in their examples. - The guide says to add a standalone
.github/workflows/test-<action>.yaml. The catalogue instead requires a job inci.yamlwired into both sides ofci-required-checks, and a coverage-parity guard enforces it.
Problem
Every consumer repository is moving to required SHA pinning (#253), so a copied @main example is refused at job setup. A contributor who follows the test instructions fails the parity guard with no hint why.
Acceptance criteria
- The template and every action README use a full-commit-SHA placeholder with a version comment,
@<full-commit-sha> # vX.Y.Z. - The contributor guide describes the consolidated
ci.yamltest-job layout, and matches AGENTS.md. - No catalogue documentation example uses a branch or tag ref for an action.
Rough size: S.
Metadata
Metadata
Assignees
Labels
No labels
Type
Fields
No fields configured for Docs.
Projects
- StatusShow more project fields✅ Done
Activity
devantler commentedon Sep 25, 2026
Scope measured on #243's head (
c0d638f): 38uses:examples across the catalogue docs use@mainor a version tag, inactions/CONTRIBUTING.mdand 16 action READMEs. There are also 2 examples inaggregate-job-checks/README.mdthat pair the newdevantler-tech/.github/...path with a commit that exists only indevantler-tech/actions, so a copied example cannot resolve. All 40 should become@<full-commit-sha> # vX.Y.Z. Thesetup-copilot-skills→setup-agent-skillsrename diffs are operational migration notes: keep them, with the same placeholder.devantler commentedon Sep 25, 2026
One more family, from Codex on #243: several reusable-workflow usage examples in the catalogue README omit the caller-side
permissionsblock, so a consumer following the suite's deny-by-defaultpermissions: {}convention gets a startup failure. The examples affected are Pages (contents,pages,id-token), Publish .NET Library, Scan for TODO Comments and Template Sync. Add the grants each called job needs to its example.chore: agent-claim #257 nonce=4979765c8cae894a71b1997f7a65a152