docs: cut the /release skill down to cocode's specifics - #85
Merged
Merged
Conversation
The skill now points at the workspace release play for the procedure and declares only what is particular to this repo, under the six headings the play reads by name: what the push to main publishes (PyPI, the GitHub Release with its lightweight tag, the MkDocs site) and how the landing verifies it, the pyproject version with the uv.lock that follows it, the gates and the CI checks on a release pull request, the named file list of the release commit, and the particulars — no pre-release form, the Release/vX.Y.Z pull request title, the changelog heading the Release notes are sliced from, and the merge commit the back-merge leaves. Dropped everything the play does once for every repo: the pre-flight that read git status and offered to fold uncommitted or unpushed work into the release, the release branch created from the current HEAD instead of cut in _cocode--release by wt add, and the numbered restatement of the commit, push and pull request steps. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016F72qvy4QBZHe7XX24QmcT
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The repo's
/releaseskill now carries only what is specific ton8n-nodes-pipelex. Its opening paragraph names the workspace release play,docs/releasing.md, as the procedure to read first, and declares the three things the play needs from the repo: the repo keyn8n-nodes-pipelex, the basedev, and the pull request targetmain— whichguard-branches.yml'sgate-mainjob makes the only way in, since it refuses any head intomainthat is notrelease/vX.Y.Z. Everything the play already does once for every repo is gone: thegit statuspre-flight that offered to fold uncommitted or unpushed work into the release, the branch created in place from the current HEAD, the numbered restatement of the commit, push and pull request steps, and the closing comparison table against thepipelexPython skill. The file is 45 lines added against 164 removed.What it declares under each of the play's six headings:
publish.ymlon the push tomainthrough npm Trusted Publishing (which is what the job'sid-token: writepermission is for), with npm pinned to the 11 line because npm 12 refuses the job's Node 20 runner; the GitHub Release, thevX.Y.Ztag and thedistzip from the same workflow'sgithub-releasejob, which slices its notes out ofCHANGELOG.mdand warns rather than fails when it finds no heading; and the documentation site, deployed bydeploy-docs.ymlwithmkdocs gh-deploy. It gives the three landing verifications (the run keyed to the merge SHA,npm view n8n-nodes-pipelex version, the tag) and warns that a green publish run is not evidence the n8n scanner passed, becausemake check-publishedends in an|| echothat swallows the failure.package.json'sversionfield is the one and only place the number is written, read back with the samenode -pcommand CI uses; there is no lock step at all, becausepnpm-lock.yamlis gitignored and untracked; nothing else in the tree is stamped.make checkbefore the commit, which ispnpm run lint,build,scan:simulate,typecheck:testandtest, together with a note on the one hole where the combined ESLint config ignoresvitest.config.tsand CI's does not;make docs-check(mkdocs build --strict) conditionally, when the entry carries links ordocs/changed, sincedoc-check.ymlis path-keyed and the deploy onmainis not strict; and whymake check-distis deliberately excluded.package.jsonandCHANGELOG.md, staged by name, with nothing else to carry because no gate rewrites a tracked file.guard-branches.yml,version-check.yml(asserting both the bump overmainand the match with the branch name),changelog-check.yml, the five unfiltered checkslint.yml,n8n-check.yml,build.yml,n8n-scan.ymlandtest.yml, and the path-keyeddoc-check.yml— noting thatpublish.ymlanddeploy-docs.ymlare not pull-request checks.vand the entries use###section subheads; no pre-release form is possible, since bothgate-main's regex andchangelog-check.ymlrefuse one; the tags are lightweight, so reading them needs--tags; the repo declares neither.worktree.tomlnor.worktreeinclude, sowtprovisions through the Makefile'sinstalltarget; and the release arms no follow-ups.The ledger item's survey, taken on 2026-09-07, disagreed with the tree in four places, and the rewrite followed the tree in each. The survey described
pnpm-lock.yamlas being "for CI/dev install", where it is in fact named in.gitignoreand tracked by nothing, so the repo has no lock step rather than a light one. It gavemake checkaspnpm run lintpluspnpm run build, where the recipe also runsscan:simulate,typecheck:testandtest. It said the changelog uses plain bullets with no###subheads, whereCHANGELOG.mdis written with### Added/### Fixedsections and headings that carry thev. And it listedpublish.ymlamong the checks on the release pull request, where that workflow fires on the push tomain; the survey also omittedguard-branches.yml,n8n-check.yml,n8n-scan.ymlanddoc-check.yml, all of which do gate it.Closes L-260907-b1ecf7
🤖 Generated with Claude Code
https://claude.ai/code/session_016F72qvy4QBZHe7XX24QmcT
Summary by cubic
Rewrites the
/releaseskill to carry only cocode-specific details; the general procedure now lives in the workspace release playdocs/releasing.md, which the skill points at first. It then declares this repo's particulars under six headings: what a push tomainpublishes (PyPI, the GitHub Release with its lightweightvX.Y.Ztag, the MkDocs site) and how to verify it;pyproject.tomlas the single version source with the deriveduv.lock; themakegates; the named release commit; the CI checks on a release pull request; and quirks like theRelease/vX.Y.ZPR title, thev-prefixed changelog heading, and the absence of pre-release forms. The diff is 50 lines added against 152 removed.Removed
git statuspre-flight that offered to fold uncommitted or unpushed work into the release.Written for commit f88ad2e. Summary will update on new commits.