📝 docs: add release skill #147

Merged
mat merged 2 commits from docs/release-skill into main 2026-10-22 16:02:51 +00:00
Owner

Summary

.agents/skills/release/
└── SKILL.md    # release process adapted from homeassistant-comwatt

Documents the full release flow for this repo: Forgejo-first sync, approval gate before any remote mutation, version bump in comwatt_client/__init__.py, annotated tag, GitHub release with generated notes plus manually added entries for Forgejo-merged PRs, and post-publish PyPI verification.

Evidence

  • Before: no documented release process (last release done ad hoc: tag 0.4.4, commit 38474b1, GitHub release 0.4.4).
    After: the skill encodes this repo's actual conventions extracted from its history (annotated tag Release v$version, commit 🔖 chore: release v$version, release title v$version, bare tag) — and the commands it mandates were executed in a fresh worktree: uv run --with-requirements requirements-dev.txt pytest (164 passed), uv build, uvx twine check dist/* (sdist + wheel PASSED).

Merge Danger

Door: two-way (delete the file to revert)

Blast Radius: none — documentation/process only, no runtime code touched.

## Summary ```text .agents/skills/release/ └── SKILL.md # release process adapted from homeassistant-comwatt ``` Documents the full release flow for this repo: Forgejo-first sync, approval gate before any remote mutation, version bump in `comwatt_client/__init__.py`, annotated tag, GitHub release with generated notes plus manually added entries for Forgejo-merged PRs, and post-publish PyPI verification. ## Evidence - **Before:** no documented release process (last release done ad hoc: tag `0.4.4`, commit `38474b1`, GitHub release `0.4.4`). **After:** the skill encodes this repo's actual conventions extracted from its history (annotated tag `Release v$version`, commit `🔖 chore: release v$version`, release title `v$version`, bare tag) — and the commands it mandates were executed in a fresh worktree: `uv run --with-requirements requirements-dev.txt pytest` (164 passed), `uv build`, `uvx twine check dist/*` (sdist + wheel PASSED). ## Merge Danger **Door:** two-way (delete the file to revert) **Blast Radius:** none — documentation/process only, no runtime code touched.
📝 docs: add release skill
Some checks failed
Tests / forgejo-pytest (push) Successful in 43s
Tests / forgejo-pytest (pull_request) Has been cancelled
c2347befdf
mat changed title from WIP: 📝 docs: add release skill to 📝 docs: add release skill 2026-10-22 16:02:03 +00:00
📝 docs: write release skill in English
All checks were successful
Tests / forgejo-pytest (push) Successful in 43s
Tests / forgejo-pytest (pull_request) Successful in 43s
38af904d44
mat merged commit 571608c51f into main 2026-10-22 16:02:51 +00:00
mat deleted branch docs/release-skill 2026-10-22 16:02:52 +00:00
mat referenced this pull request from a commit 2026-10-22 16:02:53 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
mat/python-comwatt-client!147
No description provided.