/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

What This Adds

By default, AI tools generate PR descriptions from scratch with whatever structure they choose. /describe_pr is instructed to follow your team’s template — it reads thoughts/shared/pr_description.md, fills out every section, and runs any verification commands specified in the template (like make check test). The result is saved to thoughts/shared/prs/ for team reference and applied to the PR via gh pr edit.

Every PR follows the same structure. The template is version-controlled and shared across the team.

Variants

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