@@ -0,0 +1,128 @@
+---
+name: pr-workflow
+description: Create pull requests for python-zeroconf/python-zeroconf. Use when creating PRs, submitting changes, or preparing contributions.
+allowed-tools: Read, Bash, Glob, Grep
+---
+
+# python-zeroconf PR Workflow
+
+When creating a pull request for `python-zeroconf/python-zeroconf`,
+follow these steps. Repo-wide conventions live in
+[CLAUDE.md](../../../CLAUDE.md); this skill summarises the parts
+that matter at PR-creation time.
+
+## 1. Create branch from origin/master
+
+The default branch is `master`, not `main`. `origin` already
+points at `python-zeroconf/python-zeroconf` — there is no fork in
+this workflow. Always re-fetch first so the branch is based on
+the latest `master`:
+
+```bash
+git fetch origin
+git checkout -b <branch-name> origin/master
+```
+
+If you accidentally branch from `main`, `gh pr create` will fail
+because the base branch does not exist.
+
+## 2. There is no PR template
+
+`python-zeroconf` does not ship a `.github/PULL_REQUEST_TEMPLATE.md`
+— PR bodies are free-form. Aim for a body that looks roughly like:
+
+```
+## Summary
+<1–3 sentence prose description of what changed and why>
+
+## Details
+<bullets explaining the non-obvious parts: RFC sections cited,
+performance characteristics measured, edge cases handled>
+
+## Test plan
+- [ ] <how you verified the change>
+- [ ] <new tests added under tests/ — point at the file>
+```
+
+Cite the relevant RFC section (RFC 6762 / RFC 6763) for any
+behaviour change that affects packet contents or timing —
+reviewers shouldn't have to reverse-engineer why a constant moved
+or a probe interval changed.
+
+## 3. Commit message conventions
+
+Commit messages are linted by `commitlint` with
+`@commitlint/config-conventional`, _and_ by `commitizen` in
+pre-commit (`stages: [commit-msg]`). Both must pass.
+
+- **Conventional Commits prefix is required.** Pick from:
+  `feat`, `fix`, `perf`, `refactor`, `docs`, `test`, `build`,
+  `ci`, `chore`, `style`, `revert`. The `feat`/`fix`/`perf`
+  prefixes show up in the release-notes; `chore*` and `ci*` are
+  excluded by semantic-release (`exclude_commit_patterns` in
+  `pyproject.toml`), so use those for housekeeping.
+- **Imperative-mood subject.** "fix: handle empty answer", not
+  "fix: handled empty answer".
+- **No header length cap.** The commitlint config sets
+  `header-max-length: [0, "always", Infinity]`, so a slightly
+  longer subject is fine if it earns the space; don't pad.
+- **No `Co-Authored-By` trailers from automated agents.**
+- **One logical change per commit.** Let pre-commit run (ruff
+  lint + format, mypy, flake8, codespell, cython-lint,
+  pyupgrade). If a hook auto-fixes something, re-stage and
+  re-commit; the commit-msg hook re-runs on the new commit.
+
+## 4. Cython / `.pxd` discipline
+
+If the PR touches any module listed in `TO_CYTHONIZE`
+(`build_ext.py`):
+
+- Update the sibling `.pxd` in the same commit if you changed a
+  `cdef class` layout or a `cpdef`/`cdef` signature.
+- Do not hand-edit the in-tree `.c` files; the build regenerates
+  them, and they're excluded from sdist (`exclude = ["**/*.c"]`
+  in `pyproject.toml`).
+- Verify the extension still builds locally:
+  `REQUIRE_CYTHON=1 poetry install` (re-installs in-place,
+  failing loudly if Cython rejects anything).
+- Verify it still works without the extension:
+  `SKIP_CYTHON=1 poetry install && poetry run pytest tests/`.
+
+## 5. Push and create the PR
+
+```bash
+git push -u origin <branch-name>
+gh pr create --repo python-zeroconf/python-zeroconf --base master \
+  --title "<conventional-commit subject>" \
+  --body-file /tmp/pr-body.md
+```
+
+Always pass the body via `--body-file`, never `--body "..."` with
+shell-escaping — Markdown backticks, asterisks, and angle
+brackets must pass through verbatim.
+
+The PR title should match the commit subject (same Conventional
+Commits prefix). If the PR ends up squash-merged, the title
+becomes the merged commit message, so it has to satisfy
+commitlint on its own.
+
+## 6. After the PR is open
+
+CI runs three jobs:
+
+- `lint` — `pre-commit/action`. If pre-commit passed locally
+  this passes too.
+- `commitlint` — `wagoid/commitlint-github-action`. Validates
+  every commit on the PR; if you amended after pushing, force-
+  push the branch so the rewritten commits get linted.
+- `test` — the full pytest matrix across CPython 3.9–3.14,
+  3.14t (free-threaded), and PyPy 3.9 / 3.10, on Linux + macOS +
+  Windows. The free-threaded entry is the canary for unguarded
+  shared-state bugs; failures there are often genuine even when
+  the GIL-enabled rows pass.
+
+CodSpeed also runs on PRs (`CodSpeedHQ/action`) and posts a
+benchmark delta as a check. A regression there is signal — if
+the PR is a perf change, the comment is the evidence; if not, a
+red CodSpeed check usually means the hot path picked up an extra
+Python-level branch and wants a second look.
@@ -69,8 +69,12 @@ jobs:
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v4
+      - name: Set up uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          enable-cache: true
       - name: Install poetry
-        run: pipx install poetry
+        run: uv tool install poetry
       - name: Set up Python
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v5
         with:
@@ -102,13 +106,18 @@ jobs:
         uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v5
         with:
           python-version: 3.13
-      - uses: snok/install-poetry@76e04a911780d5b312d89783f7b1cd627778900a # v1.4.1
+      - name: Set up uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          enable-cache: true
+      - name: Install poetry
+        run: uv tool install poetry
       - name: Install Dependencies
         run: |
           REQUIRE_CYTHON=1 poetry install --only=main,dev
         shell: bash
       - name: Run benchmarks
-        uses: CodSpeedHQ/action@d872884a306dd4853acf0f584f4b706cf0cc72a2 # v3
+        uses: CodSpeedHQ/action@3194d9a39c4d46684cb44bf7207fc56626aad8fd # v3
         with:
           token: ${{ secrets.CODSPEED_TOKEN }}
           run: poetry run pytest --no-cov -vvvvv --codspeed tests/benchmarks
@@ -135,7 +144,10 @@ jobs:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v4
         with:
           fetch-depth: 0
-          ref: ${{ github.head_ref || github.ref_name }}
+          ref: ${{ github.ref }}
+
+      - name: Create local branch name
+        run: git switch -C ${{ github.head_ref || github.ref_name }}
 
       # Do a dry run of PSR
       - name: Test release
@@ -153,7 +165,7 @@ jobs:
           github_token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Publish package distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # release/v1
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # release/v1
         if: steps.release.outputs.released == 'true'
 
       - name: Publish package distributions to GitHub Releases
@@ -301,14 +313,14 @@ jobs:
           fetch-depth: 0
 
       - name: Build wheels ${{ matrix.musl }} (${{ matrix.qemu }})
-        uses: pypa/cibuildwheel@ee02a1537ce3071a004a6b08c41e72f0fdc42d9a # v3.4.0
+        uses: pypa/cibuildwheel@8d2b08b68458a16aeb24b64e68a09ab1c8e82084 # v3.4.1
         # to supply options, put them in 'env', like:
         env:
           CIBW_SKIP: cp36-* cp37-* pp36-* pp37-* pp38-* cp38-* ${{ matrix.musl == 'musllinux' && '*manylinux*' || '*musllinux*' }}
           CIBW_BEFORE_ALL_LINUX: apt install -y gcc || yum install -y gcc || apk add gcc
           REQUIRE_CYTHON: 1
 
-      - uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v4
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v4
         with:
           path: ./wheelhouse/*.whl
           name: wheels-${{ matrix.os }}-${{ matrix.musl }}-${{ matrix.qemu }}-${{ matrix.pyver }}
@@ -330,4 +342,4 @@ jobs:
           merge-multiple: true
 
       - uses:
-          pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # v1.13.0
+          pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0
@@ -9,7 +9,7 @@ ci:
 
 repos:
   - repo: https://github.com/commitizen-tools/commitizen
-    rev: v4.13.10
+    rev: v4.15.1
     hooks:
       - id: commitizen
         stages: [commit-msg]
@@ -54,7 +54,7 @@ repos:
     hooks:
       - id: flake8
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.20.2
+    rev: v2.0.0
     hooks:
       - id: mypy
         additional_dependencies: [ifaddr]