# /pr-description - Generate PR Descriptions from Your Diff

> Reads the diff against main and writes summary, risk, test plan and a screenshots checklist.

Canonical: https://www.agentickit.co/commands/pr-description
Last updated: 2026-11-18

Compares the current branch to main with git diff and writes a pull request description with a summary, grouped changes, ordered risks, a runnable test plan and a screenshots checklist. Includes a solo-founder variant that adds rollback and post-deploy watch items for merging straight to main.

**Usage:** `Use when the branch is ready and the PR description is empty or a one-liner, or when you merge to main alone and want a record of what shipped and what to watch.`

## Pipeline
1. Run git status, git log main..HEAD and git diff main...HEAD --stat; stop if the diff is empty
2. Read the files that carry the logic and skip lockfiles and generated output
3. Write Summary, Changes, Risk (migrations, auth, billing, env vars), Test plan and Screenshots sections
4. Save PR_DESCRIPTION.md and print it; offer gh pr create --body-file only when asked

## Output files
- `PR_DESCRIPTION.md`

**Claude Code frontmatter:** `argument-hint: [optional: base branch or solo-founder variant]` · `model: inherit`

## Related
- [technical-writer](https://www.agentickit.co/agents/technical-writer)
- [tech-lead](https://www.agentickit.co/agents/tech-lead)
- [technical-docs](https://www.agentickit.co/skills/technical-docs)
- [project-conventions](https://www.agentickit.co/skills/project-conventions)
