Inspector Implementation

Inspector Implementation

Overview

Use this skill when the work is inside the Inspector repo, not in a consumer app. Typical tasks:

• changing runtime behavior in Sources/Inspector/
• adding or adjusting Inspector UI panels
• extending custom property/action flows
• changing macro-generated Inspector integration (@InspectorPanel, @InspectorProperty)
• dogfooding changes through the Example app

Fast architecture map

Start from these zones:

• Sources/Inspector/Manager/ — top-level orchestration and presentation flow
• Sources/Inspector/ViewHierarchy/ — live hierarchy capture and element references
• Sources/Inspector/ElementInspector/ — element panel UI and interactions
• Sources/Inspector/ElementLibraries/ — per-type property/section definitions
• Sources/Inspector/Bridge/ — Inspector MCP bridge/runtime semantic layer
• Sources/InspectorInterface/ — public macro declarations / debug-facing interface surface
• Sources/InspectorMacros/ — macro expansion logic
• Example/Example/ — dogfooding app and runtime verification target

When touching specific features

Runtime / bridge / semantic tooling

Look first in:

• Sources/Inspector/Bridge/
• Tests/InspectorTests/InspectorBridgeServiceTests.swift
• Tests/InspectorTests/InspectorMCPTransportTests.swift
• Tests/InspectorMCPServerTests/
• Tests/InspectorMCPWireTests/

Panel UI / element inspector behavior

Look first in:

• Sources/Inspector/ElementInspector/
• Sources/Inspector/CommonUI/
• Sources/Inspector/TransitionCoordinator/

Built-in editable properties / sections

Look first in:

• Sources/Inspector/ElementLibraries/Sections/
• Sources/Inspector/Extensions/InspectorElementViewModelProperty/

Customer-extensibility / macros

Look first in:

• Sources/InspectorInterface/
• Sources/InspectorMacros/
• Example/Example/PlaygroundViewController.swift
• Example/Example/RoundedButton.swift

Verification

SwiftPM/server-side verification

swift build --product InspectorMCPServer
swift build --target InspectorMCPWireTests
swift build --target InspectorMCPServerTests

Example app / iOS verification

xcodebuild test \
  -project Example/Example.xcodeproj \
  -scheme Example \
  -destination 'platform=iOS Simulator,name=iPhone 17 Pro,OS=26.4.1'

Prefer focused -only-testing: runs while iterating, then broaden when the slice stabilizes.

References

Read only when needed:

• references/architecture.md

Source: ipedro/Inspector — distributed by TomeVault.