/describe_pr

Generate a pull request description that follows your repository’s standard template.

Usage

/describe_pr

Prerequisites

Create a PR description template at thoughts/shared/pr_description.md (git/obsidian) or a page/object titled PR Description Template (notion/anytype). The template defines the sections the agent fills out on every PR.

Process

1. Read template. Loads thoughts/shared/pr_description.md
2. Identify PR. Checks the current branch for an associated PR, or lists open PRs
3. Analyze changes. Reads the full diff, commit history, and referenced files
4. Verify. Lists the template’s automatable checks and asks whether to run them now; ticks only what passed
5. Generate. A herald sub-agent fills each section from the diff and commits
6. Persist. Saves the record to thoughts/shared/prs/{number}_description.md (git syncs, obsidian doesn’t) or as a PR #{number}: ... row on notion/anytype, with status tracking the PR’s open/merged/closed state
7. Update PR. Updates the PR description on GitHub via gh pr edit