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

# PR Summaries

> Automatic summaries for every pull request, grounded in codebase context and connected tools

Macroscope generates a summary for each pull request and suggests where reviewers should start. Summaries update automatically when new commits are pushed.

Connecting [integrations](/integrations) improves summary quality by giving Macroscope more context, especially [Jira](/integrations#jira) and [Linear](/integrations#linear) which provide ticket metadata and issue context.

<Note>
  You can toggle PR summaries on/off per repo in **Settings → Repos**.
</Note>

## Where Summaries Appear

* If the PR has no description, Macroscope adds its summary directly to the PR description.
* If the author already wrote a description, Macroscope posts its summary as a comment instead.

## Using PR Templates

Add these markers anywhere in your PR template to have Macroscope insert its summary in a specific location:

```
<!-- Macroscope's pull request summary starts here -->
<!-- Macroscope's pull request summary ends here -->
```

Macroscope replaces everything between the markers. The markers are invisible in GitHub's rendered markdown. If either marker is removed, Macroscope posts its summary as a separate comment.

Example template:

```
## Why are we making this change?
Explain the motivation here.

## Pull Request Summary
<!-- Macroscope's pull request summary starts here -->
<!-- Macroscope's pull request summary ends here -->

## Checklist
- [ ] Code compiles and passes tests
- [ ] Documentation updated
```