Skip to main content
Macroscope generates a summary for each pull request and suggests where reviewers should start. Summaries update automatically when new commits are pushed. Connecting an issue tracker improves summary quality by giving Macroscope access to ticket context and metadata.

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.

PR Template Integration

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