/describe_pr

Generate a comprehensive pull request description following your repository’s standard template.

Usage

/describe_pr

Prerequisites

Create a PR description template at thoughts/shared/pr_description.md. This template defines the sections that will be filled out for 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. Run verification — Executes any verification commands from the template (e.g., make check test)
5. Generate description — Fills out each section of the template
6. Save and sync — Writes to thoughts/shared/prs/{number}_description.md and syncs
7. Update PR — Updates the PR description on GitHub via gh pr edit

Variants

• /describe_pr_nt — Skips thoughts directory integration
• /ci_describe_pr — CI-optimized version