docs: enforce changelog updates and /pr skill usage before PRs

Author: Chemaclass

.claude/CLAUDE.md

@@ -241,12 +241,14 @@ Complete end-to-end workflow from issue to PR:
 - Use speculative/unproven patterns
 - Commit without tests passing
 - Batch unrelated changes in one PR
+- Create a PR without using the `/pr` skill (even if user says "create pr")
 
 ### Always:
 - Write tests before implementation
 - Use existing patterns from `tests/**` and `src/**`
 - Minimal code in GREEN phase
 - Keep tests passing during REFACTOR
+- Update CHANGELOG.md before creating a PR (for user-facing changes)
 - Run quality checks before committing
 - Update CHANGELOG.md for user-visible changes
 - Maintain Bash 3.0+ compatibility

.claude/skills/pr/SKILL.md

@@ -11,6 +11,8 @@ allowed-tools: Bash, Read, Grep, Glob
 
 Push branch and create a PR with a concise, issue-linked description.
 
+> **IMPORTANT:** This skill MUST be used for ALL pull request creation — even when the user says "create pr" without `/pr`. Never create a PR without following these steps.
+
 ## Current Branch Context
 - Branch: !`git branch --show-current`
 - Commits: !`git log main..HEAD --oneline 2>/dev/null`
@@ -23,10 +25,13 @@ Push branch and create a PR with a concise, issue-linked description.
 
 1. **Review the branch context above** — the commits and changed files are already loaded.
 
-2. **Check CHANGELOG.md** — if it wasn't updated for these changes, update it now and commit:
-  ```bash
-  git add CHANGELOG.md && git commit -m "docs: update changelog"
-  ```
+2. **MANDATORY: Update CHANGELOG.md** — Read `CHANGELOG.md` and check the `## Unreleased` section. If the changes from this branch are NOT already listed there, you MUST update it before proceeding. **Do NOT skip this step. Do NOT proceed to push without verifying.**
+  - Add entries under the appropriate subsection (`### Added`, `### Changed`, `### Fixed`, etc.)
+  - Reference issue numbers where applicable (e.g., `(Issue #123)`)
+  - Commit the update:
+    ```bash
+    git add CHANGELOG.md && git commit -m "docs: update changelog"
+    ```
 
 3. **Push branch**:
   ```bash

CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+### Added
+- Add `assert_have_been_called_nth_with` assertion for verifying arguments on the Nth invocation of a spy (Issue #172)
+
+### Changed
+- Split Windows CI test jobs into parallel chunks to avoid timeouts
+
 ## [0.33.0](https://github.com/TypedDevs/bashunit/compare/0.32.0...0.33.0) - 2026-02-15
 
 ### Changed