ios-clean

Remove DebugBridge instrumentation and related wiring from iOS apps.

1|Updated May 27, 2026
One-click install
npx skills add https://github.com/mi179/claude-skills --skill ios-clean
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-clean
Source: https://github.com/mi179/claude-skills/tree/main/user/gstack/ios-clean
Command: npx skills add https://github.com/mi179/claude-skills --skill ios-clean

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Remove the Build-time DebugBridge instrumentation and related wiring from iOS apps to restore clean Release builds and reduce runtime overhead.

Core Features & Use Cases

  • Remove the DebugBridge SPM package and all #if DEBUG wiring from an iOS app.
  • Clean up StateServer, DebugOverlay, codegen output, and app-side hooks installed by ios-qa to produce a release-ready build.
  • Use when you need to strip gstack iOS instrumentation or revert to a standard Release configuration.

Quick Start

Run the ios-clean skill to apply a clean Release-build instrumentation removal on your iOS project and verify the build.

Frequently Asked Questions about ios-clean

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

FAQPage Schema
How do I remove DebugBridge instrumentation from an iOS app for a Release build?

To remove DebugBridge instrumentation, you need to eliminate the SPM package and all related wiring. This skill automates the cleanup of StateServer, DebugOverlay, and codegen output to restore a clean Release build.

What is the safest way to strip iOS instrumentation from a gstack project?

Stripping iOS instrumentation safely requires removing app-side hooks installed by ios-qa. The process is guarded by preamble checks and CI to ensure a safe, Release-build-only operation without runtime overhead.

How do I clean up StateServer and DebugOverlay code from my iOS project?

Cleaning up StateServer and DebugOverlay involves removing the build-time wiring and codegen output injected by qa tools. This skill targets and removes those specific components to produce a release-ready build.

Can I use this instrumentation removal process on a standard iOS build configuration?

Yes, the process applies to iOS projects using gstack and ios-clean workflows. It reverts your app to a standard Release configuration by removing the DebugBridge SPM package and associated debug hooks.

Why does my iOS app still have DebugBridge hooks after switching to Release build?

DebugBridge hooks persist because manual configuration changes often miss deep codegen output or SPM package dependencies. This skill ensures complete removal of all #if DEBUG wiring and app-side hooks for a clean build.

Does removing iOS DebugBridge instrumentation affect my continuous integration checks?

No, the instrumentation removal is designed to work safely with CI checks. It is explicitly guarded by the preamble and CI to ensure the Release build remains stable and verified after stripping the debug wiring.