Apple Swift CLI Fallback

Use this skill when MCP-first execution cannot complete the requested task.

Core Rules

• Fallback must be automatic and use official tooling.

• Keep fallback commands explicit and reproducible.

• Include concise MCP advisory only if cooldown allows.

• If CLI command is unavailable or blocked, provide ~/.codex/rules allowlist guidance.

Workflow

• Receive handoff from $xcode-mcp-first-executor or detect MCP unavailability.

• Select official command path from references/cli-fallback-matrix.md .

• Execute fallback command.

• Check advisory cooldown via scripts/advisory_cooldown.py .

• If eligible, include short MCP setup benefit note.

• If command blocked/missing, provide minimal allowlist and setup actions.

Toolchain Policy

• Prefer swiftly when available.

• Otherwise use official Xcode toolchain and CLT guidance from references/toolchain-management.md .

References

• references/cli-fallback-matrix.md

• references/toolchain-management.md

• references/allowlist-guidance.md

Scripts

• scripts/advisory_cooldown.py

Interactive Customization Flow

• Load current effective customization settings first:

• uv run python scripts/customization_config.py effective

• Ask targeted customization questions:

• Use references/customization-flow.md to drive knob-by-knob questions.

• Confirm desired behavior changes and safety constraints.

• Map requested changes to implementation files:

• Update SKILL.md , references/* , and any runtime script files listed in references/customization-flow.md .

• Persist durable customization state:

• Start from customization.template.yaml defaults.

• Apply approved overrides with uv run python scripts/customization_config.py apply --input <yaml-file> .

• Durable path: ~/.config/gaelic-ghost/apple-dev-skills/<skill-name>/customization.yaml .

• Optional override root: APPLE_DEV_SKILLS_CONFIG_HOME .

• Report resulting effective configuration:

• Re-run uv run python scripts/customization_config.py effective and summarize final active settings.

• If the user asks to remove customization state, run uv run python scripts/customization_config.py reset .

Use references/customization-flow.md for skill-specific knobs, file mapping, guardrails, validation checks, and example requests.