pr-draft-summary

name	pr-draft-summary
description	Generate a PR-ready summary block with branch suggestion, title, and description. Use in the final handoff after moderate-or-larger code changes; skip for trivial or conversation-only tasks.

PR Draft Summary

Purpose

Produce the PR-ready summary after substantive code work: a concise summary plus a PR title and draft description. The block should be ready to paste into a PR.

When to Trigger

• The task is finished and it touched runtime code (src/), tests, docs with behavior impact, or build configuration.
• Default final handoff step for substantive code work.
• Skip for trivial or conversation-only tasks, or when the user says not to.

Inputs to Collect Automatically

• Current branch: git rev-parse --abbrev-ref HEAD
• Working tree: git status -sb
• Untracked files: git ls-files --others --exclude-standard
• Changed files: git diff --name-only and git diff --name-only --cached
• Latest release tag: git tag -l 'v*' --sort=-v:refname | head -n1
• Base reference: git rev-parse --abbrev-ref --symbolic-full-name @{upstream} 2>/dev/null || echo origin/main
• Commits ahead: git log --oneline --no-merges ${BASE_COMMIT}..HEAD

Workflow

1. Run the commands above without asking the user.
2. If no changes detected, say so and skip the block.
3. Classify as feature, fix, refactor, or docs and flag backward-compatibility risk against the latest release tag.
4. Summarize changes in 1-3 sentences using key paths and diff stats.
5. Choose the lead verb: feature → adds, fix → fixes, refactor → improves, docs → updates.
6. Suggest a branch name if on main: feat/<slug>, fix/<slug>, or docs/<slug>.
7. Draft using the template below.

Output Format

# Pull Request Draft

## Branch name suggestion

git checkout -b <kebab-case, e.g., feat/add-firewall-tools>

## Title

<single-line imperative title, e.g., "feat: add firewall management tools">

## Description

<Start with "This pull request adds/fixes/improves ...", explain the change, any behavior changes or considerations. No need to list tests.>