skills.rest
abdulazeezoj
abdulazeezojCOMMUNITY
Explore all skills by this author →
Website𝕏@abdulazeezojGitHub

ios-clean

Remove the DebugBridge SPM package and all #if DEBUG wiring from an iOS app.

Updated Sep 13, 2026
Search Tags:#debug#cleanup#swift#ios#instrumentation#spm#release build
One-click install
npx skills add https://github.com/abdulazeezoj/monovella-poc --skill ios-clean-abdulazeezoj
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ios-clean
Source: https://github.com/abdulazeezoj/monovella-poc/tree/main/.agents/skills/gstack/ios-clean
Command: npx skills add https://github.com/abdulazeezoj/monovella-poc --skill ios-clean-abdulazeezoj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debug instrumentation installed in an iOS app for QA (StateServer, DebugOverlay, accessor codegen output, app-side hooks) must be fully stripped before shipping, and manual removal is error-prone. This Skill removes the DebugBridge Swift Package and all #if DEBUG wiring so no debug instrumentation remains in the app. ## Core Features & Use Cases - DebugBridge removal: Uninstalls the DebugBridge SPM package and deletes its generated code and app-side hooks installed by /ios-qa. - Release-build safety verification: Works alongside the structural guard in Package.swift (.when(configuration: .debug)) and the CI check that runs swift build -c release and asserts the DebugBridge symbol is absent. - Use Case: After finishing a QA pass with the gstack iOS instrumentation, run this Skill to strip StateServer, DebugOverlay, and codegen output from the Xcode project before cutting a release build. ## Quick Start Ask the assistant to clean the iOS debug bridge and remove DebugBridge from this project.

Frequently Asked Questions about ios-clean

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I remove the DebugBridge package from an iOS app?▼

Run the ios-clean skill, which uninstalls the DebugBridge SPM package and deletes the StateServer, DebugOverlay, accessor codegen output, and app-side hooks installed by /ios-qa. It is a convenience wrapper around the structural Release-build guard.

What prevents debug instrumentation from shipping in an iOS Release build?▼

The structural guard is a `.when(configuration: .debug)` conditional in Package.swift plus a CI invariant test that runs `swift build -c release` and asserts the DebugBridge symbol is absent. The ios-clean skill is a convenience cleanup, not the safety mechanism.

Does ios-clean work on projects not instrumented by /ios-qa?▼

It is designed for apps instrumented by /ios-qa, since it targets the specific artifacts that skill installs: StateServer, DebugOverlay, codegen output, and hooks. Projects with manually added debug tooling may need manual cleanup instead.

When should I run ios-clean versus relying on the CI release check?▼

Run ios-clean when you want the debug code physically gone from the working tree, such as before a release cut or handoff. The CI `swift build -c release` check alone only guarantees the symbol is excluded from Release builds, not that the source is removed.

Related Skills

Explore More Software Engineering Skills→
cloudofgeorgecloudofgeorge

ios-clean

Remove DebugBridge dependencies and DEBUG wiring from Swift/Xcode projects.

Community
Intermediate
sadie100sadie100

ios-clean

Remove DebugBridge SPM package and #if DEBUG wiring from iOS apps.

Community
Advanced
mi179mi179
1

ios-clean

Remove DebugBridge instrumentation and related wiring from iOS apps.

Community
Advanced
terzigoluterzigolu
37

promote-feature

Promotes a gated FeatureFlag from Dogfood to Preview and Stable in warp_core and app.

Community
Advanced