[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6X0SAX0EP6XJKFV5XB5Z92D":3,"skill-same:01M6X0SAX0EP6XJKFV5XB5Z92D":62},{"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":31,"linkOnly":32,"markdownContent":33,"markdownBody":34,"frontMatter":35,"refName":38,"commitSha":39,"skillDirectory":40,"forksCount":41,"repositoryHtmlUrl":42,"repositoryHomepageUrl":43,"ownerHtmlUrl":44,"ownerBlogUrl":45,"ownerDescription":46,"updatedAt":47,"install":48,"resources":61},"01M6X0SAX0EP6XJKFV5XB5Z92D","release-process",null,"Operate Squad's automated insider, preview, and stable release channels safely","github\u002Fsquad","github","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9919?v=4","01M6AC83DS133TPXFSP1DHNCC6","GitHub","01M6X0MZ6B0WYMMDPK3Q61KER6",3391,"MIT","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002F.copilot\u002Fskills\u002Frelease-process\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30],"release process","release","process","squad","team","decision","management","preview","channels","insider","operate","high","2026-11-10 10:12:30",false,"---\nname: \"release-process\"\ndescription: \"Operate Squad's automated insider, preview, and stable release channels safely\"\ndomain: \"release-management\"\nconfidence: \"high\"\nsource: \"team-decision\"\n---\n\n# Squad Release Process\n\nRead `.squad\u002Fskills\u002Frelease-process\u002FSKILL.md` for the canonical runbook and\nrecovery commands. The operational model is:\n\n| Release | Trigger | Required version | Result |\n|---------|---------|------------------|--------|\n| Insider | Manual `squad-insider-publish.yml` dispatch from `dev` | Generated `X.Y.Z-insider.N` | GitHub prerelease, npm `insider`, standalone archives, Homebrew, WinGet |\n| Preview | Manual `squad-release.yml` dispatch from `dev` | `X.Y.Z-preview.N` | GitHub prerelease, npm `preview`, standalone archives, Homebrew, WinGet |\n| Stable | Manual `squad-promote.yml` dispatch from `dev` | `X.Y.Z` | Sanitized promotion PR or legacy `main` push, then GitHub stable release, npm `latest`, standalone archives, Homebrew, WinGet |\n\nThere is no staging `preview` branch. Do not create tags or GitHub Releases\nmanually.\n\nHuman release-trigger boundary: use the canonical runbook for exact commands. Agents may prepare, validate, and present commands, but agents must never execute or dispatch any live publication, promotion, or recovery workflow: `squad-release.yml`, `squad-agents-ai-release.yml`, `squad-insider-publish.yml`, `squad-promote.yml` with `dry_run=false`, `squad-version-promote.yml`, `squad-npm-publish.yml`, or `squad-standalone-release.yml`. Treat `squad-promote.yml --ref dev -f dry_run=true` as human-only too: it has `actions: write` and `contents: write`, checks out `dev` with the workflow token, installs dependencies, and runs build and test steps. Do not describe any GitHub Actions release workflow as agent-safe once it has write-capable credentials or a dispatch path. Only a human executes those triggers; human approval alone does not authorize an agent to fire them.\n\n## Preconditions\n\nBefore either channel:\n\n```bash\ngit fetch origin dev main\ngit merge-base origin\u002Fdev origin\u002Fmain\ngrep '\"version\"' package.json packages\u002Fsquad-sdk\u002Fpackage.json packages\u002Fsquad-cli\u002Fpackage.json\nnode -p \"require('.\u002Fpackages\u002Fsquad-cli\u002Fpackage.json').dependencies['@bradygaster\u002Fsquad-sdk']\"\ngrep -F \"## [$VERSION]\" CHANGELOG.md\nSKIP_BUILD_BUMP=1 npm run build\nnpx vitest run\n```\n\nThe validation build must not mutate package versions or the lockfile; check\n`git diff -- package.json packages\u002Fsquad-sdk\u002Fpackage.json packages\u002Fsquad-cli\u002Fpackage.json\npackage-lock.json` afterward and stop if any version-only change appears.\n\nThe ancestry command must return a commit, all three versions must match, the\nCLI SDK dependency floor must be `>=VERSION`, and the changelog must contain\nthe exact release version.\n\nRequired Actions secrets:\n\n- `NPM_TOKEN`: automation-capable npm publish token.\n- `HOMEBREW_TAP_TOKEN`: classic PAT with `public_repo` from a collaborator with\n  write access to `bradygaster\u002Fhomebrew-squad`.\n- `WINGET_CREATE_GITHUB_TOKEN`: classic PAT with `public_repo` for\n  `tamirdresher\u002Fwinget-pkgs`.\n\n## Preview\n\nAfter a PR sets an immutable prerelease version on `dev` and CI passes:\n\nHuman-only reference command: this live publish workflow must be run by a human. Agents must stop, hand off, and not execute it directly.\n\n```bash\nVERSION=0.14.0-preview.1\ngh workflow run squad-release.yml --ref dev -f confirm_tag=\"v$VERSION\"\ngh run watch\n```\n\nThe release workflow rejects stable versions on manual dispatch, creates a\nGitHub prerelease, publishes npm `preview`, and uploads standalone bundles.\nIt also updates the `squad-preview` Homebrew cask and\n`bradygaster.Squad.Preview` WinGet package. Activation installs the latest stable\nGitHub Release; insider-tag promotion also remains stable-only.\n\n## Insider\n\nHuman-only reference command: this live publish workflow must be run by a human. Agents must stop, hand off, and not execute it directly.\n\n```bash\ngh workflow run squad-insider-publish.yml --ref dev -f dry_run=false\ngh run watch\n```\n\nThe workflow computes the next `X.Y.Z-insider.N` version, publishes npm\n`insider`, creates the GitHub prerelease and standalone archives, updates\n`squad-insider` in Homebrew, and opens or reuses the\n`bradygaster.Squad.Insider` WinGet PR.\n\n## Stable\n\nAfter a PR replaces the preview version with `X.Y.Z` on `dev` and CI passes:\n\nHuman-only validation dispatch: this workflow still checks out `dev` with repo\u002Fworkflow credentials and runs build and test logic. Agents must stop and hand off; only a human should fire it.\n\n```bash\ngh workflow run squad-promote.yml --ref dev -f dry_run=true\ngh run watch\n```\n\nHuman-only reference command: this live publish workflow must be run by a human. Agents must stop, hand off, and not execute it directly.\n\n```bash\ngh workflow run squad-promote.yml --ref dev -f dry_run=false\ngh run watch\n```\n\nWhen a validated sanitized promotion branch already exists in the upstream\nrepository, a human may instead have `github-actions[bot]` open the protected\n`main` PR:\n\n```bash\ngh workflow run squad-promote.yml --ref dev \\\n  -f dry_run=false \\\n  -f promotion_branch=chore\u002Fpromote-X.Y.Z\n```\n\nThe workflow revalidates the branch, builds it, runs the release-gate tests,\nand opens the PR with `GITHUB_TOKEN`. GitHub may hold the resulting\n`pull_request` workflow runs for maintainer approval; a maintainer with write\naccess must approve those runs, approve the PR, and merge it. The human merge\npushes `main`, which starts `squad-release.yml` normally.\n\nWithout `promotion_branch`, the legacy path merges `dev` directly into `main`,\nstrips internal team state, validates the release tree, builds it, runs tests,\nand pushes `main`. It then explicitly dispatches `squad-release.yml` because\n`GITHUB_TOKEN` pushes do not start another workflow. The release creates the\ntag and stable GitHub Release and directly invokes npm and standalone\npublication.\n\n## Verify\n\n```bash\nnpm view @bradygaster\u002Fsquad-sdk dist-tags.preview\nnpm view @bradygaster\u002Fsquad-cli dist-tags.preview\nnpm view @bradygaster\u002Fsquad-sdk dist-tags.latest\nnpm view @bradygaster\u002Fsquad-cli dist-tags.latest\ngh release view \"v$VERSION\"\n```\n\nUse the tag for the channel being released. Verify the GitHub Release contains\nall six OS\u002Farchitecture archives and `SHA256SUMS.txt`. Every release must update\nits channel-specific Homebrew cask and create or reuse a WinGet PR.\n\n## Recovery\n\nDo not recreate or overwrite the tag. Rerun a failed child job, or dispatch the\nreusable npm\u002Fstandalone workflow with `source_ref=v$VERSION`. Use `--ref dev`\nfor previews and `--ref main` for stable releases. The canonical runbook\ncontains the exact commands.\n\nAfter a stable release, prepare the next `X.Y.Z-preview.1` version in a normal\nPR to `dev`.\n","# Squad Release Process\n\nRead `.squad\u002Fskills\u002Frelease-process\u002FSKILL.md` for the canonical runbook and\nrecovery commands. The operational model is:\n\n| Release | Trigger | Required version | Result |\n|---------|---------|------------------|--------|\n| Insider | Manual `squad-insider-publish.yml` dispatch from `dev` | Generated `X.Y.Z-insider.N` | GitHub prerelease, npm `insider`, standalone archives, Homebrew, WinGet |\n| Preview | Manual `squad-release.yml` dispatch from `dev` | `X.Y.Z-preview.N` | GitHub prerelease, npm `preview`, standalone archives, Homebrew, WinGet |\n| Stable | Manual `squad-promote.yml` dispatch from `dev` | `X.Y.Z` | Sanitized promotion PR or legacy `main` push, then GitHub stable release, npm `latest`, standalone archives, Homebrew, WinGet |\n\nThere is no staging `preview` branch. Do not create tags or GitHub Releases\nmanually.\n\nHuman release-trigger boundary: use the canonical runbook for exact commands. Agents may prepare, validate, and present commands, but agents must never execute or dispatch any live publication, promotion, or recovery workflow: `squad-release.yml`, `squad-agents-ai-release.yml`, `squad-insider-publish.yml`, `squad-promote.yml` with `dry_run=false`, `squad-version-promote.yml`, `squad-npm-publish.yml`, or `squad-standalone-release.yml`. Treat `squad-promote.yml --ref dev -f dry_run=true` as human-only too: it has `actions: write` and `contents: write`, checks out `dev` with the workflow token, installs dependencies, and runs build and test steps. Do not describe any GitHub Actions release workflow as agent-safe once it has write-capable credentials or a dispatch path. Only a human executes those triggers; human approval alone does not authorize an agent to fire them.\n\n## Preconditions\n\nBefore either channel:\n\n```bash\ngit fetch origin dev main\ngit merge-base origin\u002Fdev origin\u002Fmain\ngrep '\"version\"' package.json packages\u002Fsquad-sdk\u002Fpackage.json packages\u002Fsquad-cli\u002Fpackage.json\nnode -p \"require('.\u002Fpackages\u002Fsquad-cli\u002Fpackage.json').dependencies['@bradygaster\u002Fsquad-sdk']\"\ngrep -F \"## [$VERSION]\" CHANGELOG.md\nSKIP_BUILD_BUMP=1 npm run build\nnpx vitest run\n```\n\nThe validation build must not mutate package versions or the lockfile; check\n`git diff -- package.json packages\u002Fsquad-sdk\u002Fpackage.json packages\u002Fsquad-cli\u002Fpackage.json\npackage-lock.json` afterward and stop if any version-only change appears.\n\nThe ancestry command must return a commit, all three versions must match, the\nCLI SDK dependency floor must be `>=VERSION`, and the changelog must contain\nthe exact release version.\n\nRequired Actions secrets:\n\n- `NPM_TOKEN`: automation-capable npm publish token.\n- `HOMEBREW_TAP_TOKEN`: classic PAT with `public_repo` from a collaborator with\n  write access to `bradygaster\u002Fhomebrew-squad`.\n- `WINGET_CREATE_GITHUB_TOKEN`: classic PAT with `public_repo` for\n  `tamirdresher\u002Fwinget-pkgs`.\n\n## Preview\n\nAfter a PR sets an immutable prerelease version on `dev` and CI passes:\n\nHuman-only reference command: this live publish workflow must be run by a human. Agents must stop, hand off, and not execute it directly.\n\n```bash\nVERSION=0.14.0-preview.1\ngh workflow run squad-release.yml --ref dev -f confirm_tag=\"v$VERSION\"\ngh run watch\n```\n\nThe release workflow rejects stable versions on manual dispatch, creates a\nGitHub prerelease, publishes npm `preview`, and uploads standalone bundles.\nIt also updates the `squad-preview` Homebrew cask and\n`bradygaster.Squad.Preview` WinGet package. Activation installs the latest stable\nGitHub Release; insider-tag promotion also remains stable-only.\n\n## Insider\n\nHuman-only reference command: this live publish workflow must be run by a human. Agents must stop, hand off, and not execute it directly.\n\n```bash\ngh workflow run squad-insider-publish.yml --ref dev -f dry_run=false\ngh run watch\n```\n\nThe workflow computes the next `X.Y.Z-insider.N` version, publishes npm\n`insider`, creates the GitHub prerelease and standalone archives, updates\n`squad-insider` in Homebrew, and opens or reuses the\n`bradygaster.Squad.Insider` WinGet PR.\n\n## Stable\n\nAfter a PR replaces the preview version with `X.Y.Z` on `dev` and CI passes:\n\nHuman-only validation dispatch: this workflow still checks out `dev` with repo\u002Fworkflow credentials and runs build and test logic. Agents must stop and hand off; only a human should fire it.\n\n```bash\ngh workflow run squad-promote.yml --ref dev -f dry_run=true\ngh run watch\n```\n\nHuman-only reference command: this live publish workflow must be run by a human. Agents must stop, hand off, and not execute it directly.\n\n```bash\ngh workflow run squad-promote.yml --ref dev -f dry_run=false\ngh run watch\n```\n\nWhen a validated sanitized promotion branch already exists in the upstream\nrepository, a human may instead have `github-actions[bot]` open the protected\n`main` PR:\n\n```bash\ngh workflow run squad-promote.yml --ref dev \\\n  -f dry_run=false \\\n  -f promotion_branch=chore\u002Fpromote-X.Y.Z\n```\n\nThe workflow revalidates the branch, builds it, runs the release-gate tests,\nand opens the PR with `GITHUB_TOKEN`. GitHub may hold the resulting\n`pull_request` workflow runs for maintainer approval; a maintainer with write\naccess must approve those runs, approve the PR, and merge it. The human merge\npushes `main`, which starts `squad-release.yml` normally.\n\nWithout `promotion_branch`, the legacy path merges `dev` directly into `main`,\nstrips internal team state, validates the release tree, builds it, runs tests,\nand pushes `main`. It then explicitly dispatches `squad-release.yml` because\n`GITHUB_TOKEN` pushes do not start another workflow. The release creates the\ntag and stable GitHub Release and directly invokes npm and standalone\npublication.\n\n## Verify\n\n```bash\nnpm view @bradygaster\u002Fsquad-sdk dist-tags.preview\nnpm view @bradygaster\u002Fsquad-cli dist-tags.preview\nnpm view @bradygaster\u002Fsquad-sdk dist-tags.latest\nnpm view @bradygaster\u002Fsquad-cli dist-tags.latest\ngh release view \"v$VERSION\"\n```\n\nUse the tag for the channel being released. Verify the GitHub Release contains\nall six OS\u002Farchitecture archives and `SHA256SUMS.txt`. Every release must update\nits channel-specific Homebrew cask and create or reuse a WinGet PR.\n\n## Recovery\n\nDo not recreate or overwrite the tag. Rerun a failed child job, or dispatch the\nreusable npm\u002Fstandalone workflow with `source_ref=v$VERSION`. Use `--ref dev`\nfor previews and `--ref main` for stable releases. The canonical runbook\ncontains the exact commands.\n\nAfter a stable release, prepare the next `X.Y.Z-preview.1` version in a normal\nPR to `dev`.\n",{"name":5,"domain":36,"source":37,"confidence":30,"description":7},"release-management","team-decision","dev","7b731ec97f35346bdc4fa87c3edaf16b808fc0ae",".copilot\u002Fskills\u002Frelease-process",520,"https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad","https:\u002F\u002Fgithub.github.io\u002Fsquad\u002F","https:\u002F\u002Fgithub.com\u002Fgithub","https:\u002F\u002Fgithub.com\u002Fabout","How people build software.","2026-11-15 02:13:59",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add github\u002Fsquad --skill release-process",{"tool":54,"command":55},"bunx","bunx skills add github\u002Fsquad --skill release-process",{"tool":57,"command":58},"pnpm","pnpm dlx skills add github\u002Fsquad --skill release-process","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002F.copilot\u002Fskills\u002Frelease-process\u002FSKILL.md",true,[],[63,71,78,85,92,98],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":70},"01M76752CVNE7K6NWD59CRAYNJ","windows-compatibility","Cross-platform path handling and command patterns","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Fwindows-compatibility\u002FSKILL.md",[],[],"2026-11-12 13:55:43",{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":70},"01M767508W8A4G83NX1FKEW5VN","versioning-policy","SemVer rules for Squad's stable, preview, insider, and local package versions","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Fversioning-policy\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":70},"01M7674X5JJKNJ74B3SS8PGXG2","tiered-memory","Three-tier agent memory model (hot\u002Fcold\u002Fwiki) for context reduction per spawn","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Ftiered-memory\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":70},"01M7674V3S9H03A76H75M1KSAF","test-discipline","Design assertions that prove the actual contract and fail on realistic regressions","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Ftest-discipline\u002FSKILL.md",[],[],{"skillNo":93,"name":22,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":70},"01M7674QB8CA61RNDX2Z0NAK71","Squad's command catalog and interactive menu. Invoke via \u002Fsquad (slash command) or natural language (\"squad commands\", \"what can squad do\", \"show me squad options\"). Presents categorized operations (Install & Upgrade, Team Management, Issues & PRs, Plugins & Skills, Model & Cost, Sessions & State) as an interactive picker. Routes to the right squad CLI command or the Squad coordinator agent.","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Fsquad\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":70},"01M7674KTQ632N30HQB1TP7TXH","squad-version-check","Internals of how @bradygaster\u002Fsquad-cli stamps its version, how `squad upgrade` works (what it preserves vs overwrites), and how to probe the npm registry for the latest version from a coordinator prompt.","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fsquad\u002Fblob\u002Fdev\u002Fplugins\u002Fsquad\u002Fskills\u002Fsquad-version-check\u002FSKILL.md",[],[]]