bootstrap-xcode-workspacelisted
Install: claude install-skill gaelic-ghost/socket
# Bootstrap Xcode Workspace
## Purpose
Create the root composition for a modular Apple product without pretending that a
workspace, an Xcode project, an app target, and a Swift package are equivalent.
The workspace owns related Xcode projects and shared schemes. Each app project
owns its targets, build settings, and XcodeGen spec. Each package owns its
manifest and target graph.
Use `scripts/run_workflow.py` to normalize the workspace contract before
creating files. XcodeGen generates each app project; create the `.xcworkspace`
and add the generated projects through Xcode's documented workspace flow rather
than hand-writing workspace data.
## Compatibility
This is portable skill guidance and a local Python runner; it has no Codex-only
plugin hooks, MCP declarations, or custom-agent dependency. The Hermes tap
export decision is therefore **no export required**: Hermes can consume the
same authored `SKILL.md` directly, and no translation artifact is needed.
## Required Shape
```text
Product/
Product.xcworkspace/
Apps/
ProductiOS/
ProductMac/
Packages/
ProductCore/
Services/ # optional
```
- `Apps/` contains one or more independently generated Xcode app projects.
- `Packages/` contains standalone SwiftPM packages, each with `Package.swift`.
- `Services/` is optional and contains a server sibling, never an app target or
an implicit Apple build dependency.
## Workflow
1. Collect `name`, `destination`, `app_topology`, app platforms,