> ## Documentation Index
> Fetch the complete documentation index at: https://mrge.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Automated PR descriptions

cubic helps your team spend less time writing PR descriptions automatically by generating clear, concise summaries.

<img src="https://mintcdn.com/mrge/eXeDFdBNkZEWK3p-/code-review-platform/images/pr-description.png?fit=max&auto=format&n=eXeDFdBNkZEWK3p-&q=85&s=099cdf9bd26fa6a5e1d93b48f06d21af" alt="PR description" className="border border-zinc-800 rounded-lg" width="2170" height="1166" data-path="code-review-platform/images/pr-description.png" />

## Auto-generate PR descriptions

AI-generated PR descriptions summarize changes clearly, helping reviewers quickly understand the context and impact of your pull requests.

By default, cubic generates PR descriptions automatically whenever a new pull request is opened, provided that the setting is enabled for your repository.

To enable or disable auto-generated descriptions:

1. Navigate to the AI review settings for your repository
2. Toggle **AI-generated PR descriptions** on or off

<img src="https://mintcdn.com/mrge/eXeDFdBNkZEWK3p-/code-review-platform/images/ai-review-settings.png?fit=max&auto=format&n=eXeDFdBNkZEWK3p-&q=85&s=873bdd8729e0d25209cbd1b9e516b8c9" alt="AI review settings" className="border border-zinc-800 rounded-lg" width="2974" height="1750" data-path="code-review-platform/images/ai-review-settings.png" />

## Manual generation

You can manually trigger AI-generated descriptions at any time:

* Click the **AI button** located in the PR description editor

When manually triggering a description:

* If existing text is present, cubic considers this context and enhances it
* If the description field is empty, cubic creates a comprehensive summary from scratch

<img src="https://mintcdn.com/mrge/eXeDFdBNkZEWK3p-/code-review-platform/images/ai-pr-title.png?fit=max&auto=format&n=eXeDFdBNkZEWK3p-&q=85&s=f8ef70334430fd6137049ebd967388c3" alt="PR title" className="border border-zinc-800 rounded-lg" width="1512" height="398" data-path="code-review-platform/images/ai-pr-title.png" />

## Best practices

To get the most out of AI PR descriptions:

* Include brief context or bullet points before triggering manual generation
* Clearly mention acceptance criteria or key points you'd like highlighted

This ensures AI-generated content is precisely tailored to your team's needs.
