Glossary

Definitions for the terms Scrubby uses.

Blast radius

The other files and domains a change is likely to affect. Scrubby derives it from the domain network and co-change history, and surfaces it with scrubby_get_network.

Co-change

A file that appears in more than half of the commits that also touched the file you changed. Missing co-changes are the most reliable class of "files you may have forgotten." See Domain Connections.

Connection (domain connection)

A weighted link between two domains in the network. Weights are learned from cross-domain imports, co-change history, and reported findings. See Domain Connections.

Convention

A pattern Scrubby extracted from your codebase, such as how files are named, how errors are handled, or how tests are structured. Conventions are scoped to segments and carry a confidence score. See Repo Conventions.

Domain

An architectural area of your codebase, such as "Authentication" or "Billing", discovered automatically during indexing. See Domains.

Finding

A single piece of feedback from a review: a severity (error, warning, or info), a message, and optionally a domain and a line number. Findings can be reported back with scrubby_report_findings to refine connection weights.

Global domain

A predefined domain template (such as "Ruby", "React", or "Testing") that activates automatically when Scrubby detects the relevant technology. Global domains carry knowledge shared across repositories. See Domains.

Index / Indexing

Building Scrubby's understanding of a repository: scanning files, ingesting git history, classifying files into domains, discovering segments, and extracting conventions. See Indexing.

MCP (Model Context Protocol)

The open protocol Scrubby uses to expose its tools to AI editors. See MCP Tools for Scrubby's tools.

Network

The graph of domains connected by weighted edges. Higher weights mean stronger coupling. Surfaced with scrubby_get_network.

Repository-scoped domain

A domain unique to your repository, discovered during indexing. Contrast with a global domain.

Review

Used in two senses: scrubby_review, the MCP tool that returns codebase context for a single file; and a PR review, the automated changeset review the GitHub App posts on a pull request. See PR Reviews.

Segment

A cohesive cluster of related files within a domain. Conventions are scoped to segments. Surfaced with scrubby_get_segments.

Snapshot

A point-in-time record of a repository's index, including the head SHA and file counts. Each index run produces one, and incremental indexing works from the most recent.