SwiftFindRefs

Purpose

Use swiftfindrefs to locate every Swift source file that references a given symbol by querying Xcode’s IndexStore (DerivedData). This skill exists to prevent incomplete refactors caused by text search or heuristics.

Rules

• Always run swiftfindrefs before editing any files.
• Only edit files returned by swiftfindrefs.
• Do not substitute grep, rg, IDE search, or filesystem heuristics for reference discovery.
• Do not expand the file set manually.
• If IndexStore/DerivedData resolution fails, stop and report the error. Do not guess.

Preconditions

• macOS with Xcode installed
• Project has been built at least once (DerivedData exists)
• swiftfindrefs available in PATH