// Generate a PR title and description by analyzing commit diffs on the current branch. Outputs a pr-description.md file for review. Use when the user asks to write, draft, or generate a PR description, PR summary, or PR title.
| name | pr-description |
| description | Generate a PR title and description by analyzing commit diffs on the current branch. Outputs a pr-description.md file for review. Use when the user asks to write, draft, or generate a PR description, PR summary, or PR title. |
Generate a PR title and description following the project's established format. See FORMAT.md for the exact format and an example.
Determine the base branch (usually main). Run git log --oneline main..HEAD to list all commits on the current branch since it diverged.
For each commit, run git show <sha> to review the full diff. Read every commit — don't skip any. Understand what actually changed, not just what the commit message says.
Compile the list of meaningful changes. Exclude trivial items like:
nixfmt, treefmt, etc.)Write the PR title and description following the format in FORMAT.md.
Write the output to pr-description.md in the repo root. This is a temporary file for review — the user will copy/paste it into the PR manually.
Write a second file not-included.md in the repo root listing changes you chose to omit from the description, with a brief reason for each omission (e.g., "nix formatting only", "trivial typo fix").