ios-workflow-claude

English · Português brasileiro

Reusable Claude Code slash-commands, skills, and workflows extracted from real iOS / backend projects. Packaged as three installable plugins - register the marketplace and /plugin install what you need.

No per-project setup: the commands resolve project-specific values (app scheme, Jira key, feature-flag files, …) at runtime by detecting them, inferring from git, or asking.

The GIF above is reproducible - see docs/assets/demo.tape. Install VHS (brew install vhs) and run vhs docs/assets/demo.tape.

Why this exists

There are good Claude Code kits for iOS, and good kits for workflow automation. There aren't any that do both.

Two things in here I couldn't find anywhere else public:

• A complete Swift 6 migration pipeline (/swift6-check → /swift6-fix one category at a time → /swift6-status). Most kits give you a Swift reviewer that flags issues; this one runs the loop until you're done.
• A generalizable SDK-removal pattern (/apollo-*). Five commands built for Apollo iOS removal, but the pattern - investigate one repo → migrate to a protocol-based replacement with mandatory tests → self-review → stacked PRs - maps to any SDK swap: Realm → SwiftData, Combine → async/await, custom networking → URLSession.

Zero per-project setup is also rare - instead of a template system you fork and edit by hand, every command resolves project-specific values (scheme, Jira key, flag files) at runtime by detecting them, inferring from git, or asking.

Not for you if: you're not on iOS, you don't use Jira, or your team doesn't ship through GitHub PRs reviewed via gh. The xcode-build-suite plugin is the most stack-portable piece - install just that one if Xcode optimization is all you want.

What's in here

commands/ - slash commands

skills/ - model-invoked skills

agents/ - specialized subagents

Drop into .claude/agents/ (or ~/.claude/agents/) and they become available via the Agent tool.

Third-party plugins (recommended - install via marketplace)

These ship as Claude Code plugins. Don't copy them here - install them so you get upstream updates. See docs/PLUGINS.md for one-command install steps.

• ios-swift-skills (Patrick Serrano, MIT) - SwiftUI performance audit, native app profiling via xctrace, Swift concurrency expert, SwiftUI view refactor, SwiftUI patterns, Liquid Glass (iOS 26+), iOS debugger agent, App Store release changelog, macOS SPM packaging
• memorydetective (Apache 2.0) - Disciplined iOS perf + leak investigation playbooks via MCP
• codex (OpenAI, Apache 2.0) - Delegate stuck/second-opinion tasks to Codex CLI (/codex:setup, /codex:rescue)
• code-review (official) - Generic code review command
• security-guidance (official) - /security-review for pending changes
• pr-review-toolkit (official) - /review PR + subagents (simplifier, comment-analyzer, type-design)

Built into Claude Code (no install needed)

Available out of the box - just invoke them. See docs/BUILTINS.md for short descriptions.

• /init - bootstrap CLAUDE.md from the current codebase
• /loop - run a prompt / slash command on an interval or self-paced
• /schedule - cron-style scheduled remote agents
• claude-api - build/debug Anthropic SDK apps (caching, model migration)
• Skills: update-config (hooks/permissions/env), keybindings-help, fewer-permission-prompts, simplify, init

Quickstart

# Inside Claude Code, one-time: register this repo as a marketplace
/plugin marketplace add carloshpdoc/ios-workflow-claude

# Then install whichever plugins you want
/plugin install xcode-build-suite@carloshpdoc-plugins   # Xcode build-time optimizer
/plugin install ios-workflow@carloshpdoc-plugins        # iOS commands + agents
/plugin install claude-utilities@carloshpdoc-plugins    # content, knowledge, create-tasks

New slash commands appear in Claude Code tab-completion immediately. There is no setup step - project-specific values (app scheme, Jira key, feature-flag files, …) are auto-detected from the project, inferred from git/the branch name, or asked at runtime.

Installation

Install via the plugin marketplace (recommended)

This repo is a Claude Code plugin marketplace (.claude-plugin/marketplace.json) shipping three independent plugins. Register it once, then install just the plugins you need:

/plugin marketplace add carloshpdoc/ios-workflow-claude
/plugin install xcode-build-suite@carloshpdoc-plugins
/plugin install ios-workflow@carloshpdoc-plugins
/plugin install claude-utilities@carloshpdoc-plugins

Run /plugin to see installed plugins. Restart Claude Code if new commands don't show up in tab-completion.

No per-project configuration

Earlier versions copied files into each project and substituted {{PLACEHOLDER}} tokens via a bootstrap.sh script. That step is gone - plugins can't template at install time, and they don't need to. The commands now resolve project-specific values at runtime:

Nothing to edit, nothing to re-run when values change.

Local fork (development)

To hack on the plugins, clone the repo and add it as a local marketplace:

/plugin marketplace add /path/to/ios-workflow-claude

The local-fast / local-smart skills and the bin/ wrapper scripts are not part of any plugin (they depend on a personal local-LLM runtime). Copy them into ~/.claude/ by hand if you want them - see the local-fast / local-smart section below.

Layout

ios-workflow-claude/
├── .claude-plugin/
│   └── marketplace.json     # marketplace manifest (3 plugins under ./plugins)
├── plugins/
│   ├── xcode-build-suite/
│   │   ├── .claude-plugin/plugin.json
│   │   └── skills/          # 6 Xcode build-optimization skills
│   ├── ios-workflow/
│   │   ├── .claude-plugin/plugin.json
│   │   ├── commands/        # slash commands (.md per command)
│   │   └── agents/          # specialized subagents (Agent tool)
│   └── claude-utilities/
│       ├── .claude-plugin/plugin.json
│       └── skills/          # content, knowledge, create-tasks
├── skills/                  # NOT plugins: local-fast / local-smart (personal runtime)
├── bin/                     # helper scripts for local-fast / local-smart
├── docs/
│   ├── PLUGINS.md           # third-party plugin install steps
│   └── BUILTINS.md          # Claude Code built-in commands cheat sheet
└── README.md

Setup for local-fast / local-smart (optional)

These two skills delegate to local LLMs via ollama. If you don't use them, skip this section.

# 1. Install ollama and pull the models referenced by the wrapper scripts
brew install ollama
ollama pull qwen3.5:35b-a3b-coding-nvfp4   # used by local-fast
ollama pull dots.llm1                       # used by local-smart

# 2. Drop the wrapper scripts into your project's .claude/bin/
mkdir -p .claude/bin
cp ~/Development/ios-workflow-claude/bin/*.sh .claude/bin/
chmod +x .claude/bin/*.sh

If you prefer different local models, edit the scripts in bin/ - they're 3-line wrappers around ollama run <model>.

License

The commands, skills, and agents in plugins/ are released under Apache 2.0 - see LICENSE.

Third-party plugins documented in docs/PLUGINS.md keep their own licenses (MIT for ios-swift-skills, Apache 2.0 for codex and memorydetective, Anthropic license for the official claude-plugins-official set).