diff --git a/.agents/skills/subminer-release/SKILL.md b/.agents/skills/subminer-release/SKILL.md new file mode 100644 index 00000000..89f68d71 --- /dev/null +++ b/.agents/skills/subminer-release/SKILL.md @@ -0,0 +1,34 @@ +--- +name: subminer-release +description: Prepare, cut, publish, or repair SubMiner stable and prerelease releases. Use for hands-on release work; do not use for general release questions. +--- + +# SubMiner release + +Carry out the requested release phase using the repository's current release process. + +## Source of truth + +Read `docs/RELEASING.md` completely before changing files or release state. Treat it as canonical. Read `changes/README.md` when the work touches change fragments or generated release notes. + +Do not copy release commands or policy into this skill. If this skill disagrees with the release guide, follow the guide and reconcile the skill before handoff. + +## Workflow + +1. Identify whether the request is for a stable release, prerelease, release preparation, publication, or repair. +2. Inspect the current branch, worktree status, package version, pending change fragments, relevant tags, and latest CI state before making changes. +3. Follow the matching procedure in `docs/RELEASING.md` in order. Review generated changelog and release-note Markdown before it can be committed or published. +4. Run every required gate for the requested release phase. Do not treat a cheaper test lane as a substitute for the documented release gate. +5. Before a stable tag, confirm the package and tag versions match and no pending `changes/*.md` fragments remain. Preserve fragments for prereleases as documented. +6. Report the resulting version, completed checks, local commit and tag state, remote publication state, skipped platform checks, and any remaining manual work. + +## Authorization boundaries + +- A request to prepare a release stops before commit, tag, push, or remote publication unless the user also authorizes those actions. +- A clear request to cut or publish a release includes the documented commit, tag, and push steps. Ask before the first remote mutation when the wording is ambiguous. +- Do not edit an existing GitHub release, publish to the AUR, change secrets, or alter signing configuration unless the user explicitly requests that operation. +- Do not switch branches without consent. + +## Stop conditions + +Stop and report the blocker when required CI or a release gate fails, authentication is missing, versions disagree, required artifacts are absent, or the worktree contains unexpected changes that overlap the release. Do not tag or publish a partially verified release. diff --git a/.gitignore b/.gitignore index 2f4cd81a..fbba9131 100644 --- a/.gitignore +++ b/.gitignore @@ -49,6 +49,7 @@ tests/* !.agents/skills/ .agents/skills/* !.agents/skills/subminer-change-verification/ +!.agents/skills/subminer-release/ !.agents/skills/subminer-scrum-master/ .agents/skills/subminer-change-verification/* !.agents/skills/subminer-change-verification/SKILL.md @@ -56,6 +57,8 @@ tests/* .agents/skills/subminer-change-verification/scripts/* !.agents/skills/subminer-change-verification/scripts/classify_subminer_diff.sh !.agents/skills/subminer-change-verification/scripts/verify_subminer_change.sh +.agents/skills/subminer-release/* +!.agents/skills/subminer-release/SKILL.md .agents/skills/subminer-scrum-master/* !.agents/skills/subminer-scrum-master/SKILL.md favicon.png diff --git a/docs/knowledge-base/catalog.md b/docs/knowledge-base/catalog.md index 352865b6..d0120cad 100644 --- a/docs/knowledge-base/catalog.md +++ b/docs/knowledge-base/catalog.md @@ -19,7 +19,7 @@ Read when: finding internal docs or checking verification status | Quality scorecard | `docs/knowledge-base/quality.md` | active | 2026-03-13 | quality grades and gaps | | Workflow index | `docs/workflow/README.md` | active | 2026-08-13 | execution map | | Planning guide | `docs/workflow/planning.md` | active | 2026-05-23 | lightweight vs execution plans | -| Agent skills | `docs/workflow/agent-skills.md` | active | 2026-08-13 | repo-local workflow skill ownership | +| Agent skills | `docs/workflow/agent-skills.md` | active | 2026-08-23 | repo-local workflow skill ownership | | Verification guide | `docs/workflow/verification.md` | active | 2026-08-13 | maintained verification lanes | | Release guide | `docs/RELEASING.md` | active | 2026-05-23 | release checklist | diff --git a/docs/workflow/agent-skills.md b/docs/workflow/agent-skills.md index 5d87ec2e..aed51d81 100644 --- a/docs/workflow/agent-skills.md +++ b/docs/workflow/agent-skills.md @@ -3,7 +3,7 @@ # Agent Skills Status: active -Last verified: 2026-08-13 +Last verified: 2026-08-23 Owner: Kyle Yasuda Read when: using, adding, or changing a repo-local agent workflow skill @@ -12,6 +12,9 @@ Read when: using, adding, or changing a repo-local agent workflow skill - `.agents/skills/subminer-change-verification/` - Selects the cheapest sufficient repo-native verification lane. - Defers command ownership to `package.json` and `docs/workflow/verification.md`. +- `.agents/skills/subminer-release/` + - Prepares, cuts, publishes, or repairs stable and prerelease releases. + - Defers release procedure and policy to `docs/RELEASING.md`. Repo-local workflows stay as standalone skills. Do not add plugin packaging, marketplace metadata, or compatibility shims unless the workflow is intentionally being distributed beyond this repository.