Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

Docs: add issue reporter credit guidelines to release skill

Maximilian Roos5392471c46f2
diff --git a/.claude/skills/release/SKILL.md b/.claude/skills/release/SKILL.md
index 9fa428bbf..0d61099a0 100644
--- a/.claude/skills/release/SKILL.md
+++ b/.claude/skills/release/SKILL.md
@@ -80,6 +80,30 @@ git log v<last-version>..HEAD --format="%an <%ae>" | sort -u
Then for each external contributor's commit, find their GitHub username from the commit (usually in the email or PR).
+### Credit Issue Reporters
+
+When a fix or feature addresses a user-reported issue *in this repo*, thank the reporter — not just the PR author. Users who take time to report bugs, request features, or provide reproduction steps deserve recognition. (Don't credit reporters from upstream/external repos — only issues filed here.)
+
+```markdown
+- **Feature name**: Description. ([#456](https://github.com/user/repo/pull/456), thanks @reporter for reporting)
+```
+
+For fixes that reference issues:
+
+```markdown
+- **Bug fix**: Description. Fixes [#123](https://github.com/user/repo/issues/123). (thanks @reporter)
+```
+
+**Finding reporters:** Check PR bodies for "Fixes #N", "Closes #N", or issue references. Then look up the issue author with `gh issue view N --json author`.
+
+**When to credit:**
+- Bug reports with clear reproduction steps
+- Feature requests that shaped the implementation
+- Performance reports with measurements (like "takes 15s")
+- Users who helped diagnose issues through discussion
+
+Skip credit for: issues opened by the repo owner, trivial reports, or issues that were substantially different from what was implemented.
+
### MANDATORY: Verify Each Changelog Entry
**After drafting changelog entries, you MUST spawn a subagent to verify each bullet point is accurate.** This is non-negotiable — changelog mistakes are a recurring problem.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4a8854609..673a566a0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,9 +4,9 @@
### Improved
-- **Nix flake for packaging**: New `flake.nix` for Nix users with crane for efficient Rust builds. ([#502](https://github.com/max-sixty/worktrunk/pull/502), thanks @marktoda)
-- **`sanitize_db` template filter**: New filter that transforms strings into database-safe identifiers with a 3-character hash suffix for collision/keyword safety.
-- **`wt select` performance**: 500ms timeout for git commands improves TUI responsiveness on large repos with many branches.
+- **Nix flake for packaging**: New `flake.nix` for Nix users with crane for efficient Rust builds. ([#502](https://github.com/max-sixty/worktrunk/pull/502), thanks @marktoda; thanks @Kabilan108 for requesting)
+- **`sanitize_db` template filter**: New filter that transforms strings into database-safe identifiers with a 3-character hash suffix for collision/keyword safety. ([#498](https://github.com/max-sixty/worktrunk/pull/498), thanks @hugobarauna for requesting)
+- **`wt select` performance**: 500ms timeout for git commands improves TUI responsiveness on large repos with many branches. (thanks @KidkArolis for reporting [#461](https://github.com/max-sixty/worktrunk/issues/461))
- **`wt select` stale branch handling**: Branches 50+ commits behind the default branch now skip expensive operations, showing `...` in the diff column. Improves performance on repos with many stale branches.
- **Global merge-base cache**: Cached merge-base results improve `wt list` performance by avoiding redundant git calls.
- **`wt config show` git version**: Now displays the git version alongside the worktrunk version.