[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EKEC3YAEXXEFEJSE6GP3J9":3,"skill-same:01M7EKEC3YAEXXEFEJSE6GP3J9":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7EKEC3YAEXXEFEJSE6GP3J9","release-check",null,"What must be true before tagging a Turnfleet release. Use when preparing a tag or when asked whether the repository is releasable.","Hazmi35\u002Fturnfleet","Hazmi35","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F32807631?v=4","01M7EKD5JD8P0491P8RHDSTZSF","hzmi","01M7EKD5K13ED85DGGNKGPX6KM",2,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Frelease-check\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: release-check\ndescription: What must be true before tagging a Turnfleet release. Use when preparing a tag or when asked whether the repository is releasable.\n---\n\n# Release check\n\nDo not create the release until every line below is true. Report the command\noutput as evidence for each one. \"looks fine\" is not evidence.\n\n## Required\n\n1. **Clean history on `main`**: no merge commits, Conventional Commits, every\n   commit signed off. `make dco` and `git log --oneline main`.\n2. **`make ci`** green on the exact commit being tagged: verify, helm-verify,\n   lint, test, vuln, licenses, dco.\n3. **`make test-e2e`** green: all three addressing modes, saturation, peer\n   policy, drain with an active allocation, and `turnfleet-probe` against a real\n   relay. **`make test-e2e-chart`** green too: the chart has to install the CRDs\n   and the controller and probe a relay from that install, which `make\n   helm-verify` does not exercise (it lints and compares renders, and installs\n   nothing).\n4. **`charts\u002Fturnfleet`'s `version` and `appVersion` are the release version**,\n   on the commit being released: `version` is the chart's semver (`X.Y.Z`) and\n   `appVersion` is the image tag the chart installs by default (`X.Y.Z`, the\n   number beside the git tag's `vX.Y.Z`). They are the same number on purpose.\n   Bumping either after the release leaves it carrying the previous one. The\n   Release workflow checks both against the release tag before it publishes the\n   chart, so a bump missed here fails the release instead of publishing a chart\n   the release does not carry.\n5. **Version pins agree**: each pin's copies in `go.mod`, `tools\u002Fgo.mod`, the\n   `Makefile`, `.custom-gcl.yml`, the Dockerfiles and the workflows hold the same\n   value. The held modules, vulnerability floors and the held cosign pin\n   described in `docs\u002Fversions.md` still describe what is in the tree. Diff them.\n6. **`docs\u002Fapi.md` and the CRDs** are regenerated from the tagged commit\n   (`make verify` is the check).\n7. **The docs reflect reality**: `docs\u002Farchitecture.md` and\n   `docs\u002Fcapacity-model.md` describe what the tree actually does,\n   `docs\u002Flimitations.md` lists what it does not, and no document claims a\n   feature that is not implemented. Anything that changed behaviour in this\n   release is described by the document that owns it.\n8. **Images build for both architectures** (`make docker-buildx` locally or the\n   `image.yaml` workflow on `main`), and both carry\n   `org.opencontainers.image.licenses=AGPL-3.0-only` and\n   `org.opencontainers.image.source`.\n9. **License obligations**: `make licenses` is green; `LICENSE` is the verbatim\n   AGPL-3.0 text; the coturn image is still the unmodified upstream image\n   (ADR 2).\n10. **The release is what starts the pipeline**: create it for the version being\n    released (`gh release create vX.Y.Z --title \"Turnfleet vX.Y.Z\" --notes …`),\n    which is also what creates the tag. `image.yaml` then builds and pushes both\n    images for that tag. `release.yaml` waits for their digests, signs them\n    keyless, attaches the SPDX SBOM and the SLSA provenance, publishes the chart\n    to `oci:\u002F\u002Fghcr.io\u002Fhazmi35\u002Fturnfleet-chart\u002Fturnfleet` at the release's\n    version and signs it at its own digest, and writes the release body\n    (ADR 16, ADR 17). A tag push with no release publishes nothing. Release notes\n    may claim the chart: it ships in this tree, and `make test-e2e-chart` proves\n    it installs.\n\n## After the release\n\n* Confirm the release body carries the digest of both published images and the\n  chart's version and digest.\n* Watch the Release workflow for the tag. It waits for the Image workflow to\n  publish `ghcr.io\u002Fhazmi35\u002Fturnfleet-{controller,probe}:\u003Ctag>`. It then signs\n  both index digests keyless, attaches an SPDX SBOM and SLSA provenance to each,\n  publishes and signs the chart at the digest its own push reported, verifies\n  all of it with the identity it records, and writes the release body from the\n  digests and the commands. It fails loudly if the digests never appear (look\n  at the Image run for the tag), if the tag resolves to an image built from\n  another commit (the check reads `org.opencontainers.image.revision` against\n  the tagged commit, so a tag still carrying a previous release's build fails\n  the run instead of being signed), if the chart's `version` or `appVersion`\n  is not the release version (nothing is pushed in that case), or if one of its\n  own verifications fails.\n* Check what it published rather than trusting it. The release notes carry the\n  digests, the certificate identity and the exact commands. `identity` is\n  `https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002F.github\u002Fworkflows\u002Frelease.yaml@refs\u002Ftags\u002F\u003Ctag>`:\n\n  ```sh\n  ref=\"ghcr.io\u002Fhazmi35\u002Fturnfleet-controller:\u003Ctag>@sha256:\u003Cdigest>\"\n  identity=\"https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002F.github\u002Fworkflows\u002Frelease.yaml@refs\u002Ftags\u002F\u003Ctag>\"\n  issuer=https:\u002F\u002Ftoken.actions.githubusercontent.com\n\n  cosign verify --certificate-identity \"$identity\" --certificate-oidc-issuer \"$issuer\" \"$ref\"\n  cosign verify-attestation --type slsaprovenance --certificate-identity \"$identity\" --certificate-oidc-issuer \"$issuer\" \"$ref\" |\n    jq -r .payload | base64 -d | jq -r .predicate.invocation.configSource.digest.sha1\n  cosign verify-attestation --type spdxjson --certificate-identity \"$identity\" --certificate-oidc-issuer \"$issuer\" \"$ref\" |\n    jq -r .payload | base64 -d | jq -r '.predicate.packages[] | select(.name == \"coturn\") | .versionInfo'\n  ```\n\n  The first command proves the signature, the second prints the commit the\n  provenance names (it must be the tagged commit) and the third prints the pinned\n  coturn digest. Repeat for `turnfleet-probe`. A consumer that holds a public key\n  instead of trusting the Fulcio identity would need `cosign verify --key\n  cosign.pub \u003Cref>`, which requires a key-based signature this repository does\n  not produce.\n* The chart was published with the same identity and verifies the same way, at\n  `oci:\u002F\u002Fghcr.io\u002Fhazmi35\u002Fturnfleet-chart\u002Fturnfleet`, version `\u003Ctag without its v>`.\n  Pull it and check its digest, which the release body records, rather than the\n  tag:\n\n  ```sh\n  helm pull oci:\u002F\u002Fghcr.io\u002Fhazmi35\u002Fturnfleet-chart\u002Fturnfleet --version \u003Ctag without v>\n  cosign verify --certificate-identity \"$identity\" --certificate-oidc-issuer \"$issuer\" \\\n    ghcr.io\u002Fhazmi35\u002Fturnfleet-chart\u002Fturnfleet@sha256:\u003Cchart digest>\n  ```\n\n  Its provenance and its SPDX document verify with the `slsaprovenance` and\n  `spdxjson` commands above, against the same reference. #39's acceptance,\n  installing from that published reference on a fresh cluster and probing a\n  relay, needs a release to have happened, the way the image digest checks above\n  do.\n* Re-run `make verify` on the tag: a tag is a commit, not a branch state.\n","# Release check\n\nDo not create the release until every line below is true. Report the command\noutput as evidence for each one. \"looks fine\" is not evidence.\n\n## Required\n\n1. **Clean history on `main`**: no merge commits, Conventional Commits, every\n   commit signed off. `make dco` and `git log --oneline main`.\n2. **`make ci`** green on the exact commit being tagged: verify, helm-verify,\n   lint, test, vuln, licenses, dco.\n3. **`make test-e2e`** green: all three addressing modes, saturation, peer\n   policy, drain with an active allocation, and `turnfleet-probe` against a real\n   relay. **`make test-e2e-chart`** green too: the chart has to install the CRDs\n   and the controller and probe a relay from that install, which `make\n   helm-verify` does not exercise (it lints and compares renders, and installs\n   nothing).\n4. **`charts\u002Fturnfleet`'s `version` and `appVersion` are the release version**,\n   on the commit being released: `version` is the chart's semver (`X.Y.Z`) and\n   `appVersion` is the image tag the chart installs by default (`X.Y.Z`, the\n   number beside the git tag's `vX.Y.Z`). They are the same number on purpose.\n   Bumping either after the release leaves it carrying the previous one. The\n   Release workflow checks both against the release tag before it publishes the\n   chart, so a bump missed here fails the release instead of publishing a chart\n   the release does not carry.\n5. **Version pins agree**: each pin's copies in `go.mod`, `tools\u002Fgo.mod`, the\n   `Makefile`, `.custom-gcl.yml`, the Dockerfiles and the workflows hold the same\n   value. The held modules, vulnerability floors and the held cosign pin\n   described in `docs\u002Fversions.md` still describe what is in the tree. Diff them.\n6. **`docs\u002Fapi.md` and the CRDs** are regenerated from the tagged commit\n   (`make verify` is the check).\n7. **The docs reflect reality**: `docs\u002Farchitecture.md` and\n   `docs\u002Fcapacity-model.md` describe what the tree actually does,\n   `docs\u002Flimitations.md` lists what it does not, and no document claims a\n   feature that is not implemented. Anything that changed behaviour in this\n   release is described by the document that owns it.\n8. **Images build for both architectures** (`make docker-buildx` locally or the\n   `image.yaml` workflow on `main`), and both carry\n   `org.opencontainers.image.licenses=AGPL-3.0-only` and\n   `org.opencontainers.image.source`.\n9. **License obligations**: `make licenses` is green; `LICENSE` is the verbatim\n   AGPL-3.0 text; the coturn image is still the unmodified upstream image\n   (ADR 2).\n10. **The release is what starts the pipeline**: create it for the version being\n    released (`gh release create vX.Y.Z --title \"Turnfleet vX.Y.Z\" --notes …`),\n    which is also what creates the tag. `image.yaml` then builds and pushes both\n    images for that tag. `release.yaml` waits for their digests, signs them\n    keyless, attaches the SPDX SBOM and the SLSA provenance, publishes the chart\n    to `oci:\u002F\u002Fghcr.io\u002Fhazmi35\u002Fturnfleet-chart\u002Fturnfleet` at the release's\n    version and signs it at its own digest, and writes the release body\n    (ADR 16, ADR 17). A tag push with no release publishes nothing. Release notes\n    may claim the chart: it ships in this tree, and `make test-e2e-chart` proves\n    it installs.\n\n## After the release\n\n* Confirm the release body carries the digest of both published images and the\n  chart's version and digest.\n* Watch the Release workflow for the tag. It waits for the Image workflow to\n  publish `ghcr.io\u002Fhazmi35\u002Fturnfleet-{controller,probe}:\u003Ctag>`. It then signs\n  both index digests keyless, attaches an SPDX SBOM and SLSA provenance to each,\n  publishes and signs the chart at the digest its own push reported, verifies\n  all of it with the identity it records, and writes the release body from the\n  digests and the commands. It fails loudly if the digests never appear (look\n  at the Image run for the tag), if the tag resolves to an image built from\n  another commit (the check reads `org.opencontainers.image.revision` against\n  the tagged commit, so a tag still carrying a previous release's build fails\n  the run instead of being signed), if the chart's `version` or `appVersion`\n  is not the release version (nothing is pushed in that case), or if one of its\n  own verifications fails.\n* Check what it published rather than trusting it. The release notes carry the\n  digests, the certificate identity and the exact commands. `identity` is\n  `https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002F.github\u002Fworkflows\u002Frelease.yaml@refs\u002Ftags\u002F\u003Ctag>`:\n\n  ```sh\n  ref=\"ghcr.io\u002Fhazmi35\u002Fturnfleet-controller:\u003Ctag>@sha256:\u003Cdigest>\"\n  identity=\"https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002F.github\u002Fworkflows\u002Frelease.yaml@refs\u002Ftags\u002F\u003Ctag>\"\n  issuer=https:\u002F\u002Ftoken.actions.githubusercontent.com\n\n  cosign verify --certificate-identity \"$identity\" --certificate-oidc-issuer \"$issuer\" \"$ref\"\n  cosign verify-attestation --type slsaprovenance --certificate-identity \"$identity\" --certificate-oidc-issuer \"$issuer\" \"$ref\" |\n    jq -r .payload | base64 -d | jq -r .predicate.invocation.configSource.digest.sha1\n  cosign verify-attestation --type spdxjson --certificate-identity \"$identity\" --certificate-oidc-issuer \"$issuer\" \"$ref\" |\n    jq -r .payload | base64 -d | jq -r '.predicate.packages[] | select(.name == \"coturn\") | .versionInfo'\n  ```\n\n  The first command proves the signature, the second prints the commit the\n  provenance names (it must be the tagged commit) and the third prints the pinned\n  coturn digest. Repeat for `turnfleet-probe`. A consumer that holds a public key\n  instead of trusting the Fulcio identity would need `cosign verify --key\n  cosign.pub \u003Cref>`, which requires a key-based signature this repository does\n  not produce.\n* The chart was published with the same identity and verifies the same way, at\n  `oci:\u002F\u002Fghcr.io\u002Fhazmi35\u002Fturnfleet-chart\u002Fturnfleet`, version `\u003Ctag without its v>`.\n  Pull it and check its digest, which the release body records, rather than the\n  tag:\n\n  ```sh\n  helm pull oci:\u002F\u002Fghcr.io\u002Fhazmi35\u002Fturnfleet-chart\u002Fturnfleet --version \u003Ctag without v>\n  cosign verify --certificate-identity \"$identity\" --certificate-oidc-issuer \"$issuer\" \\\n    ghcr.io\u002Fhazmi35\u002Fturnfleet-chart\u002Fturnfleet@sha256:\u003Cchart digest>\n  ```\n\n  Its provenance and its SPDX document verify with the `slsaprovenance` and\n  `spdxjson` commands above, against the same reference. #39's acceptance,\n  installing from that published reference on a fresh cluster and probing a\n  relay, needs a release to have happened, the way the image digest checks above\n  do.\n* Re-run `make verify` on the tag: a tag is a commit, not a branch state.\n",{"name":5,"description":7},"main","9544bc3bb9a017f646498013e8462e8269aa3357",".agents\u002Fskills\u002Frelease-check",0,"https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet","https:\u002F\u002Fgithub.com\u002FHazmi35","https:\u002F\u002Fhzmi.dev","2026-11-15 05:35:57",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add Hazmi35\u002Fturnfleet --skill release-check",{"tool":38,"command":39},"bunx","bunx skills add Hazmi35\u002Fturnfleet --skill release-check",{"tool":41,"command":42},"pnpm","pnpm dlx skills add Hazmi35\u002Fturnfleet --skill release-check","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Frelease-check\u002FSKILL.md",true,[],[47,53,59,65,71,77],{"skillNo":48,"name":49,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":19},"01M7EKGEH2RYAK4XSGG6QYMN26","writing-for-agents","https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M7EKGDCRT4TB799978RPTRD9","wayfinder","https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwayfinder\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7EKGC75FKAVQEXYWQQHWYF4","wait-what","https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwait-what\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7EKGANG5441YGY9B8RTE13F","triage","https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftriage\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7EKG7BN7EPEJC1WRGX8WPWD","to-tickets","https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fto-tickets\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M7EKG67Z1F9BG2JNYAYR32Z2","to-spec","https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fto-spec\u002FSKILL.md",[],[]]