skills.rest
aicodepro
aicodeproOFFICIAL
Explore all skills by this author →
GitHub

ios-clean

Removes the DebugBridge SPM package and debug wiring from iOS apps.

Updated Jun 22, 2026
Search Tags:#cleanup#swift#ios#spm#gstack#release build#debugbridge
One-click install
npx skills add https://github.com/aicodepro/ai-agent-nexi --skill ios-clean-aicodepro
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ios-clean
Source: https://github.com/aicodepro/ai-agent-nexi/tree/main/agent/skills/gstack/ios-clean
Command: npx skills add https://github.com/aicodepro/ai-agent-nexi --skill ios-clean-aicodepro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debug instrumentation installed in an iOS app for QA (StateServer, DebugOverlay, accessor codegen output, and #if DEBUG hooks) must be fully stripped before release; doing this by hand is error-prone and easy to leave behind. ## Core Features & Use Cases - DebugBridge removal: Deletes the DebugBridge Swift Package Manager dependency and all app-side references. - Debug wiring cleanup: Removes #if DEBUG blocks, StateServer, DebugOverlay, and codegen artifacts installed by the /ios-qa skill. - Release safety guard: Relies on a Package.swift conditional plus a CI swift build -c release check as the structural safety net. - Use Case: After finishing a QA pass on an iOS build, ask the assistant to strip the gstack iOS instrumentation so the codebase is clean for a release build. ## Quick Start Ask the assistant to clean the iOS debug bridge and remove all DebugBridge instrumentation 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 debug instrumentation from an iOS app before release?▼

Run the ios-clean skill, which deletes the DebugBridge SPM package and strips all #if DEBUG wiring, StateServer, DebugOverlay, and codegen output installed during QA. A CI release-build check confirms nothing debug-related remains.

What is DebugBridge in a Swift Package Manager project?▼

DebugBridge is an SPM package added by the /ios-qa skill to expose app state for debugging, including a StateServer and DebugOverlay. It is intended only for debug builds and should be removed before shipping.

Does removing DebugBridge affect release builds?▼

No. The structural guard is a Package.swift conditional plus a CI `swift build -c release` check, so release builds compile without the debug bridge even before cleanup. ios-clean is a convenience wrapper that removes the leftover code.

Can I use ios-clean without having run ios-qa first?▼

It is designed as the cleanup counterpart to /ios-qa. If no DebugBridge instrumentation exists, there is nothing to remove, so it is only meaningful on projects previously instrumented by ios-qa.

Why does swift build -c release fail after removing debug code?▼

Failures usually mean leftover references to DebugBridge symbols outside #if DEBUG guards. Re-check imports and call sites, and rely on the CI release-build check to surface any missed references.

Related Skills

Explore More Software Engineering Skills→
abdulazeezojabdulazeezoj

ios-clean

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

Community
Intermediate
co-labs-coco-labs-co

ios-cicd-testflight

Automate iOS builds, versioning, and TestFlight deployment via GitHub Actions.

Official
Advanced
JonOlsenCaJonOlsenCa

freeze

Block Edit and Write operations outside a specified directory per session.

Community
Intermediate
bocanbocan
27

debug-menu

Generate a self-contained in-app debug menu for native iOS and macOS Swift apps.

Community
Advanced