njdaniel/conch / .claude/skills/release
release
VerifiedThe gated release procedure — preconditions, version choice, CHANGELOG, Nick-signed tag, GitHub release via release.yml (a draft for a plain tag, a published pre-release for a -suffix tag). Use for any tagged release; releases are Tier-H (Nick signs off, per ADR-000).
release
Releases are Tier-H: Nick signs off, always (ADR-000). The tag push is the
sign-off act; release.yml turns a plain v* tag into a draft GitHub release, and a tag with a pre-release suffix (v0.1.0-alpha.1) into a published pre-release for testers.
Preconditions — all four, verified fresh, before any tag
- CI green on
main(gh run list --branch main), including the dogfood-check and p2-hardening-check jobs. go run ./e2e/p2-hardeningpasses locally against the release commit. It is the P2 exit gate (issue #81) and runs the P1 canary,e2e/dogfood, as its last step, so this one command is both. A release does not ship when it fails. What it proves and how to read a failure: the manual section "The P2 hardening gate" (docs/manual.md).- The latest principal-review report shows no unresolved invariant drift (open drift → fix or get Nick's explicit acceptance first).
- Nick's sign-off is recorded — on the release issue or in writing. Session-scoped authorization counts only if it explicitly names releasing.
Procedure
- Pick the version:
v0.x.ySemVer (session-1 decision — pre-1.0, tags only at Nick-gated releases). Minor for features, patch for fixes; pre-1.0 breaking changes ride minor bumps but must be called out in the CHANGELOG. - Update
CHANGELOG.md(Keep a Changelog format; create the file on the first release): move Unreleased into the new version section, dated. Land this via a normal PR before tagging — the tag points at a cleanmain. In the same PR, set the voice helper's version to the tag: the[workspace.package]versioninvoice/Cargo.toml(forv0.1.0-alpha.19,0.1.0-alpha.19). A desktop release build (CONCH_RELEASE_VERSION, #1596) checks the bundledconch-voice --versionagainst the tag and fails on a mismatch. A release build lists its own tag as a tested server by itself (scripts/desktop-version.sh, #1596). After the upgrade, also add the new tag todesktop/build/compat.json, the development builds' list, once the desktop app has been run against it. Unlisted, a development build refuses to sign in to that server with "server version not tested". The list sat at alpha.9 until alpha.18 because no step said so. - Tag: annotated, on the reviewed
maincommit —git tag -a vX.Y.Z -m "..."— pushed by Nick, or by the session only under his explicit, recorded authorization for this release. - Verify the
release.ymlrun:make check, dogfood-check and p2-hardening-check re-ran green, binaries built for all three platforms, thedesktop-debjob built the Linux desktop.deb(its first step,scripts/desktop-release-guard.sh, refuses unless the tag is the commit built, the tree is clean andvoice/Cargo.toml's version is the tag's), theattestjob wrotechecksums.txtand attested every file, and the release was created bypublish(a draft, or for a pre-release tag a published pre-release). If any of the first three jobs fails, no release exists: fix onmainand tag a new version, never move the tag. Never re-run a release (the run or a job of it): tag a new version.attestasserts the exact file set andpublishverifies every attestation before it creates the release. - Sanity-check the artifacts (download one,
--version, run against a temp db), note the dogfood-check run in the release notes, hand the draft to Nick to publish (a pre-release is already published: check its notes and tester checklist). - Verify the desktop
.debthe way a tester does, from a directory holding the release's files:sha256sum -c --ignore-missing checksums.txt(the onechecksums.txtcovers every file), thengh attestation verify conch-desktop_*_amd64.deb --repo njdaniel/conch --signer-workflow njdaniel/conch/.github/workflows/release.yml --source-ref refs/tags/<tag>. With the two pinning flags it checks that this repository'srelease.yml, run for that tag, signed the file;--repoalone accepts an attestation from any workflow on any ref.dpkg-deb -Ishows the package's Version (the tag with the first-as~). The.debis a technical preview until real-device acceptance is recorded (#1603), and the release notes say so. A green CI or release run, a CI artifact, a checksum or an attestation says the package was built from this tag by this workflow; it does not say the app works, and it is not approval or real-device acceptance. Only the acceptance record (#1603) is that.
Desktop release notes section
When the release ships the Linux desktop .deb, the CHANGELOG entry gets a
"Linux desktop app" section after the server notes. Fill it from recorded runs
only (the capability report and #1603's acceptance record); a row nobody has
run is "not tried", never "works". Link the user page,
docs/desktop/linux.md.
### Linux desktop app
- **Verified on:** <distribution and version, desktop and compositor, session
type, architecture, with the run that shows it (issue or record)>.
- **Experimental:** <what runs but has no recorded acceptance>.
- **Not supported:** <X11 screen share, ARM64, AppImage, Flatpak, RPM, and
anything else that does not work>.
- **Not tried:** <rows with no run yet>.
- **Known issues:** <issue links>.
- Verify the download with `docs/desktop/linux.md` (checksums, then
`gh attestation verify` for tag <tag>).
Never
- Tag on a failing or stale dogfood-check or p2-hardening-check.
- Tag without recorded sign-off, or move/delete a pushed tag, or re-run a release: tag a new version.
- Tag a commit that is not on
main: the guard refuses it, but that is only accident protection. The real control is av*tag ruleset on the repository (Nick's setting). - Edit a published release's artifacts — regressions get a new patch release.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 466k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 196k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |