Glossary

A short glossary for Scrubby-specific terms. Terms appear in alphabetical order.

Blast radius

The scope of files, domains, or systems that may be affected by a given change. Scrubby computes blast radius from the domain network plus co-change history. Surfaced via scrubby_get_network.

Co-change

A pair of files that historically change together in more than 50% of commits where either appears. Scrubby flags missing co-changes as the most reliable class of “files you may have forgotten.” See Co-Change Analysis.

Connection (domain connection)

A weighted edge between two domains in the network. Weights are learned via Hebbian updates from cross-domain imports, co-change history, and findings.

Convention

A pattern Scrubby has extracted from your codebase — how files are named, how errors are handled, how tests are structured, etc. Conventions are scoped to segments and have a confidence score. See Conventions.

Domain

An architectural region of your codebase — “Authentication”, “Billing”, “Background Jobs”, etc. Discovered automatically during indexing. See Domains.

Finding

A single piece of feedback Scrubby produces during a review — severity (error/warning/info), a human-readable message, optionally a domain attribution and a line number. Findings can be reported back via scrubby_report_findings to refine connection weights.

Global domain

A pre-defined domain template (e.g. “Ruby”, “React”, “Testing”) that activates automatically when Scrubby detects relevant files (Gemfile, package.json with React, etc.). Global domains carry shared knowledge across many repos. See Domains.

Hebbian learning

The principle “neurons that fire together wire together.” Scrubby applies it to domain connections: useful cross-domain findings reinforce a connection; unproductive checks weaken it. See Findings & the Learning Loop.

Index / Indexing

The process of building Scrubby’s understanding of a repository: scanning files, ingesting git history, classifying files into domains, discovering segments, extracting conventions. See scrubby_index.

MCP (Model Context Protocol)

The open protocol Scrubby uses to expose its tools to AI editors. See modelcontextprotocol.io for the spec; see MCP Tools for Scrubby’s surface.

Network

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

Repository-scoped domain

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

Review

Used in two senses:

• scrubby_review — the MCP tool that returns codebase context for a single file.
• PR review — the automated changeset review the GitHub App posts on every PR. See Reviewing a Pull Request.

Segment

A fine-grained cluster of files within a domain — typically files that share imports and naming. Conventions are scoped to segments. Surfaced via scrubby_get_segments.

Snapshot

A point-in-time record of a repository’s index, including head SHA and file counts. Each scrubby_index call produces a snapshot. Used for incremental indexing.