Understand Repository Scan Results

Read category scores, browse open findings, and use the file scatter plot.

Once a repository scan completes, results appear on the Repositories tab and on the repository detail page. These reflect existing code — open quality issues across the full codebase, not just recent PR changes.

This guide covers how to read scores, triage findings, and spot hotspots.

Repositories overview

The Repositories tab lists every connected repository with a score in four categories:

• Maintainability — how easy the code is to change and extend
• Readability — clarity, naming, and structure
• Performance — efficiency and resource usage
• Reliability — correctness, error handling, and bug-prone patterns

Each cell shows a rating label, a color indicator, and a number. The label reflects the worst-severity open finding in that category; the number is the total count of open findings there.

The PR checks column shows whether PR checks are enabled for that repository (ON / OFF). PR checks cover new code on pull requests; repository scans cover existing code in the full repo. The two are independent — you can enable either or both.

Click a tracked repository to open its detail page.

Category ratings

Each category rating is based on the highest-severity open finding in that category, not the total issue count.

Rating	Condition
Excellent	Only low or informational findings (nothing medium or above)
Good	At least one medium finding, but no high or critical
Fair	At least one high finding, but no critical
Poor	At least one critical finding

Findings are grouped into categories based on the rule that triggered them — each default and custom check belongs to one of the four categories above. Low-severity findings don't affect the rating label, but they are included in the issue count.

Issues tab

The Issues tab on the repository detail page lists every open finding, grouped by rule. Each row shows:

• Type — the language of the affected file
• Name — the rule title and affected file(s)
• Severity — the highest severity in the group
• Location — file path(s) where the issue occurs
• Fix time — estimated effort to resolve

Click a row to open the detail sidebar. From there you can:

• Read the TL;DR and How do I fix it? guidance
• Browse Subissues with file names, line numbers, and code snippets
• Open View code analysis for a deeper look at a specific occurrence
• Ignore individual findings

Fix findings with AutoFix

Instead of fixing a finding by hand, you can let Aikido generate the change for you. AutoFix produces a fix for the finding and can open a pull request with the change, so you review and merge rather than write it yourself.

File scatter plot

Switch to the File Scatter Plot tab to visualize code quality hotspots — files that are both frequently changed and carry open quality debt.

Each dot represents one file in the repository:

• X-axis — number of PRs that touched the file in the last 3 months
• Y-axis — number of open code quality findings in that file

Files in the top-right of the chart are your hotspots: high activity combined with low quality. Prioritize these when planning refactors or cleanup work.

The scatter plot requires both modes enabled for the same repository: PR checks for new code activity data, and repository scans for existing code finding counts.