v0.3.0

[gringolito]

Highlights

Bug fixes

• Critical: silent item truncation in /execute-backlog-item (Fix gh project item-list truncation: missing --limit causes silent candidate drops #76, P0) — gh project item-list silently capped results at 30 items, causing the wrong item to be selected when the top candidate was ranked ≥31. All commands that call item-list now use --limit 200 and targeted --query filters.
• Invalid Issue Forms template from /initialize-backlog (Fix initialize-backlog: remove title field from backlog-item issue template #67, P1) — the generated backlog-item.yml failed GitHub's Issue Forms validation due to a stray title field. Removed.

New features

• /setup-permissions (Add /setup-permissions command and userConfig to streamline first-run permission setup #40) — first-run command that writes the gh/git allowlist block into your Claude Code settings file. Paired with a new userConfig.permission_mode field in plugin.json that prompts for your preference at install time (yolo / safe / off).
• SessionStart hook (Add SessionStart hook for early auth/scope and project-existence warning #39) — runs at the start of every Claude Code session in a backlog-managed repo. Warns early if gh auth is missing scopes or if no Backlog project is linked — before any command fails mid-run.
• /plan-release re-planning mode (Expand /plan-release to support interactive release re-planning mode #20) — pass an existing open milestone as argument to enter interactive re-planning: move unassigned items in, carry items out, or adjust the due date without losing milestone history.
• /backlog-health (Add /backlog-health command — strategic portfolio health report #21) — read-only strategic portfolio health report: distribution by type/priority/effort, age cohorts, overdue P0/P1 items, stale In-Progress, and metadata debt. Useful for leadership updates and retrospectives.
• Router skill architecture (Promote SKILL.md to skills/<name>/SKILL.md as a router skill #30) — SKILL.md promoted to skills/github-backlog-management/SKILL.md. Plugin-installed users now get a router-level skill Claude can dispatch without knowing individual command names.

Developer experience

• Plugin manifests tightened: $schema added, keywords expanded, redundant commands field dropped (Tighten plugin.json and marketplace.json ($schema, keywords, drop redundant commands field) #31)
• CI workflow added to validate plugin.json on every PR, blocking merge on validation failure (Add CI workflow to validate plugin manifest on every PR #33)
• CLAUDE.md documents the plugin.json:version cache-key policy — version bumps happen at release closure only, never in feature PRs (Document plugin.json:version cache-key behavior in CLAUDE.md #32)

---

What's Changed

• chore: add external-blocker issue forms template by @gringolito in chore: add external-blocker issue forms template #66
• fix: remove empty title field from backlog-item issue template by @gringolito in fix: remove empty title field from backlog-item issue template #68
• feat(plan-release): add interactive re-planning mode for existing milestones by @gringolito in feat(plan-release): add interactive re-planning mode for existing milestones #69
• feat: promote SKILL.md to skills/github-backlog-management/SKILL.md as router skill by @gringolito in feat: promote SKILL.md to skills/github-backlog-management/SKILL.md as router skill #70
• chore: tighten plugin manifest — $schema, keywords, drop redundant commands field by @gringolito in chore: tighten plugin manifest — $schema, keywords, drop redundant commands field #71
• chore: document plugin.json:version cache-key behavior in CLAUDE.md by @gringolito in chore: document plugin.json:version cache-key behavior in CLAUDE.md #72
• chore: add CI workflow to validate plugin manifest on every PR by @gringolito in chore: add CI workflow to validate plugin manifest on every PR #73
• feat: add /backlog-health command — strategic portfolio health report by @gringolito in feat: add /backlog-health command — strategic portfolio health report #74
• feat: add SessionStart hook for early auth/scope and project-existence warning by @gringolito in feat: add SessionStart hook for early auth/scope and project-existence warning #75
• fix: add --limit 200 and targeted --query filters to all gh project item-list calls by @gringolito in fix: add --limit 200 and targeted --query filters to all gh project item-list calls #77
• feat: add /setup-permissions command and userConfig (Add /setup-permissions command and userConfig to streamline first-run permission setup #40) by @gringolito in feat: add /setup-permissions command and userConfig (#40) #78
• fix: remove redundant gh issue list call from execute-backlog-item by @gringolito in fix: remove redundant gh issue list call from execute-backlog-item #79
• chore(release): prepare v0.3.0 by @gringolito in chore(release): prepare v0.3.0 #80

Full Changelog: v0.2.0...v0.3.0

---

This discussion was created from the release v0.3.0.