@mmerterden/multi-agent-pipeline 8.6.1 → 10.0.6

package/pipeline/skills/figma-ios/figma-to-component/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: figma-to-component
-description: Figma-to-SwiftUI component implementation workflow. Takes a Figma URL and produces a production-ready SwiftUI component through 8 phases — data gathering, analysis, code generation, testing, Code Connect, and documentation.
+description: Figma-to-SwiftUI component implementation workflow. Takes a Figma URL and produces a production-ready SwiftUI component through 8 phases  -  data gathering, analysis, code generation, testing, Code Connect, and documentation.
 user-invocable: true
 argument-hint: <figma-url> | phase-<N> | status
 allowed-tools: Task, Read, Glob, Grep, Bash, Write, Edit, AskUserQuestion
@@ -8,7 +8,7 @@ status: wip-v5
 sourced-from: upstream/figma-to-swiftui
 ---
 
-# /figma — Figma-to-SwiftUI Workflow Orchestrator
+# /figma  -  Figma-to-SwiftUI Workflow Orchestrator
 
 ## Parse Arguments
 
@@ -50,7 +50,7 @@ These 6 rules govern orchestrator behavior. Violations have caused repeated fail
 0 (Init) → 1 (Gather) → 2A → 2B → 2C → 2D → 3 (Analysis) → 4 (Implementation) → 5A → 5B → 5C → 6 (Code Connect) → 7 (Wiki Markdown)
 ```
 
-This skill dispatches Phase 2 and Phase 5 sub-phases directly — no orchestrator subagent.
+This skill dispatches Phase 2 and Phase 5 sub-phases directly  -  no orchestrator subagent.
 
 When `phase-7` is invoked:
 1. Dispatch `phase-7a` (generate two wiki pages: main + iOS, plus assets into wiki submodule).
@@ -133,10 +133,10 @@ You are executing {Phase Name} of the Figma-to-SwiftUI workflow.
 - Artifact Path: {artifactPath}
 - Component Location: {componentLocation}
 - GitHub Issue: {issueNumber} (omit if not available)
-- Wiki Path: {wikiPath} (Phase 7 only — `{repos.wiki.path}`)
+- Wiki Path: {wikiPath} (Phase 7 only  -  `{repos.wiki.path}`)
 
 ## Tool Restrictions
-{from dispatch table — e.g., "Do NOT use the Edit tool."}
+{from dispatch table  -  e.g., "Do NOT use the Edit tool."}
 
 ## Your Instructions
 Read and STRICTLY FOLLOW your phase instructions gate-by-gate from this file:
@@ -149,18 +149,18 @@ Read the return protocol from:
 
 ## Specs (if present)
 - {artifactPath}/pass0/specs.md
-Read and incorporate specs alongside phase instructions. Both are inputs you must follow — phase instructions define methodology and coding standards, specs define acceptance criteria and design intent. Neither overrides the other.
+Read and incorporate specs alongside phase instructions. Both are inputs you must follow  -  phase instructions define methodology and coding standards, specs define acceptance criteria and design intent. Neither overrides the other.
 
 ## Reference Files (read during execution if needed)
 - .instructions/figma/figma-to-swiftui/{reference path}
 
 ## Previous Phase Artifacts (read in this order)
-{use the Read-Order Table below — list file PATHS only, do not embed content}
+{use the Read-Order Table below  -  list file PATHS only, do not embed content}
 ```
 
 ### 2. Dispatch
 
-**Phase 1 (script):** Run directly via Bash — no subagent needed:
+**Phase 1 (script):** Run directly via Bash  -  no subagent needed:
 
 ```bash
 python3 .instructions/figma/figma-to-swiftui/scripts/phase1-gather.py \
@@ -175,7 +175,7 @@ The script tries remote MCP first, falls back to local MCP automatically.
 
 **If `status` = `COMPLETE_WITH_DEFERRED`:**
 Design context was deferred (too many sublayers). All other artifacts are present.
-Do NOT ask the user — dispatch a **Phase 1 subagent** for deferred resolution:
+Do NOT ask the user  -  dispatch a **Phase 1 subagent** for deferred resolution:
 
 ```
 Agent(
@@ -230,13 +230,13 @@ After each phase completes, update IMPLEMENTATION_HISTORY.md with phase status,
 
 ---
 
-## Phase 2 Routing (inline — do NOT read phase-2-orchestrator.md)
+## Phase 2 Routing (inline  -  do NOT read phase-2-orchestrator.md)
 
 **Do NOT read `phase-2-orchestrator.md`. All routing logic is here. Subagents read their own docs.**
 
 1. **PRE-CHECK**: Read `IMPLEMENTATION_HISTORY.md` (already in context). Verify `pass1/_index.md` exists.
-2. **NORMALIZE**: Check `pass1/design_context_response.json` — if `sublayers: true` and no `response` field, concatenate `responses` values into `response` field and write back.
-3. **REGISTRY_LOOKUP**: `cd {repos.common.path} && .build/debug/FigmaRegistryUtility utility-lookup --node-id '{nodeId}'` — pass result as `registryData` context to subagents.
+2. **NORMALIZE**: Check `pass1/design_context_response.json`  -  if `sublayers: true` and no `response` field, concatenate `responses` values into `response` field and write back.
+3. **REGISTRY_LOOKUP**: `cd {repos.common.path} && .build/debug/FigmaRegistryUtility utility-lookup --node-id '{nodeId}'`  -  pass result as `registryData` context to subagents.
 4. **Wave 1 (parallel)**: Dispatch 2A + 2B + 2C as subagents (each reads its own instruction doc by path).
 5. **Wave 2**: Dispatch 2D as subagent (depends on 2A output).
 6. **FINALIZE (script)**:
@@ -250,7 +250,7 @@ After each phase completes, update IMPLEMENTATION_HISTORY.md with phase status,
 
 ---
 
-## Phase 3 Routing (inline — do NOT read phase-3-orchestrator.md)
+## Phase 3 Routing (inline  -  do NOT read phase-3-orchestrator.md)
 
 **Do NOT read `phase-3-orchestrator.md`. Subagents read their own docs. Scripts handle deterministic phases.**
 
@@ -260,14 +260,14 @@ After each phase completes, update IMPLEMENTATION_HISTORY.md with phase status,
    - **Scripts**: `python3 .instructions/figma/figma-to-swiftui/scripts/phase3-scripts.py wave1 --artifact-path '{artifactPath}'` (runs 3B+3E+3F, ~5s)
    - **Subagents**: 3A (`phase-3a-location.md`, sonnet, 20 turns), 3C (`phase-3c-nested.md`, sonnet, 20 turns), 3H (`phase-3h-variant-config.md`, opus, 25 turns)
 4. **MISSING TOKEN RESOLUTION**: After Wave 1, check `pass3/02_token_mapping.md` for missing tokens (lines with "⚠️ not found"). If any exist, dispatch a subagent:
-   - **Subagent** (`general-purpose`, opus, 25 turns) — reads `reference/missing-tokens.md` for procedure, resolves each missing token by:
+   - **Subagent** (`general-purpose`, opus, 25 turns)  -  reads `reference/missing-tokens.md` for procedure, resolves each missing token by:
      - **Typography**: Adding alias entries to `typography-registry.json` (match font size + weight to existing Swift tokens)
      - **Colors**: Adding to `Shared/UIAssets/Colors/*.json` (source), running `swift package plugin --allow-writing-to-package-directory generate-ui-assets`, adding to `ui-token-index.json`
      - **Variables**: Using `FigmaRegistryUtility ui-token-lookup` / `ui-token-index` to verify
    - Pass artifact path and token mapping path as context. Subagent updates token mapping after resolution.
    - If 0 missing tokens, skip this step entirely.
 5. **Wave 2 (parallel)**: Launch simultaneously:
-   - **Subagent**: 3D (`phase-3d-patterns.md`, opus, 30 turns) — reads 3H output (`pass3/04c_variant_config_analysis.json`)
+   - **Subagent**: 3D (`phase-3d-patterns.md`, opus, 30 turns)  -  reads 3H output (`pass3/04c_variant_config_analysis.json`)
 6. **Wave 3**: `python3 .instructions/figma/figma-to-swiftui/scripts/phase3-scripts.py 3g --artifact-path '{artifactPath}'` (depends on 3D JSON output)
 7. **COLLECT**: Verify 12 artifacts exist in `pass3/` (10 original + 2 from 3H).
 8. **SPEC (script)**: `python3 .instructions/figma/figma-to-swiftui/scripts/phase3-scripts.py spec --artifact-path '{artifactPath}'`
@@ -276,38 +276,38 @@ After each phase completes, update IMPLEMENTATION_HISTORY.md with phase status,
 
 ---
 
-## Phase 4 Routing (inline — do NOT read phase-4-orchestrator.md)
+## Phase 4 Routing (inline  -  do NOT read phase-4-orchestrator.md)
 
 **Do NOT read `phase-4-orchestrator.md`. Subagents read their own docs. Orchestrator stays lean.**
 
 1. **PRE-CHECK**: Verify `pass3/_index.md` exists.
-2. **LOAD_SPEC**: Read `pass3/07_implementation_spec.md` and `pass3/05_complexity.md` — extract `componentLocation`, `complexity` (SIMPLE/COMPLEX).
+2. **LOAD_SPEC**: Read `pass3/07_implementation_spec.md` and `pass3/05_complexity.md`  -  extract `componentLocation`, `complexity` (SIMPLE/COMPLEX).
 3. **PREPARE_DIRECTORY**: `mkdir -p {componentLocation}`. Get `gitUser` via `git config user.name`. Get `date` in DD.MM.YYYY format.
 4. **Wave 1 (parallel)**: Dispatch subagents:
-   - **4A** (`phase-4a-configuration.md`, opus, 30 turns) — **COMPLEX only** (skip if SIMPLE). Writes `{ComponentName}Configuration.swift`.
-   - **4B** (`phase-4b-view.md`, opus, 40 turns) — **ALWAYS**. Writes `{ComponentName}.swift`.
-   - **4C** (`phase-4c-documentation.md`, sonnet, 20 turns) — **ALWAYS**. Writes `FIGMA.md`.
-   - Pass to each: componentName, componentLocation, artifactPath, nodeId, fileKey, complexity, gitUser, date, issueNumber (from IMPLEMENTATION_HISTORY.md `GitHub Issue` field — extract the number after `#`).
+   - **4A** (`phase-4a-configuration.md`, opus, 30 turns)  -  **COMPLEX only** (skip if SIMPLE). Writes `{ComponentName}Configuration.swift`.
+   - **4B** (`phase-4b-view.md`, opus, 40 turns)  -  **ALWAYS**. Writes `{ComponentName}.swift`.
+   - **4C** (`phase-4c-documentation.md`, sonnet, 20 turns)  -  **ALWAYS**. Writes `FIGMA.md`.
+   - Pass to each: componentName, componentLocation, artifactPath, nodeId, fileKey, complexity, gitUser, date, issueNumber (from IMPLEMENTATION_HISTORY.md `GitHub Issue` field  -  extract the number after `#`).
 5. **Wave 2 (parallel)**: Dispatch subagents that depend on 4A+4B:
-   - **4D** (`phase-4d-preview.md`, sonnet, 20 turns) — appends Preview to `{ComponentName}.swift`.
-   - **4E** (`phase-4e-modifiers.md`, sonnet, 20 turns) — **COMPLEX only** (skip if SIMPLE). Writes `{ComponentName}+Modifiers.swift`.
+   - **4D** (`phase-4d-preview.md`, sonnet, 20 turns)  -  appends Preview to `{ComponentName}.swift`.
+   - **4E** (`phase-4e-modifiers.md`, sonnet, 20 turns)  -  **COMPLEX only** (skip if SIMPLE). Writes `{ComponentName}+Modifiers.swift`.
 6. **COLLECT**: Verify `{ComponentName}.swift`, `{ComponentName}Configuration.swift` (if COMPLEX), `{ComponentName}+Modifiers.swift` (if COMPLEX), `FIGMA.md` exist.
-7. **VALIDATE**: `bash .instructions/figma/figma-to-swiftui/scripts/validate-phase4.sh "{componentLocation}" "{ComponentName}" "{artifactPath}/pass3/00_property_coverage.json"` — fix violations if any.
-8. **BUILD**: `xcodebuild build -project "$(git rev-parse --show-toplevel)/{build.xcodeproj}" -scheme {build.scheme} -destination 'generic/platform=iOS' CODE_SIGNING_ALLOWED=NO -quiet` — fix compilation errors if any.
+7. **VALIDATE**: `bash .instructions/figma/figma-to-swiftui/scripts/validate-phase4.sh "{componentLocation}" "{ComponentName}" "{artifactPath}/pass3/00_property_coverage.json"`  -  fix violations if any.
+8. **BUILD**: `xcodebuild build -project "$(git rev-parse --show-toplevel)/{build.xcodeproj}" -scheme {build.scheme} -destination 'generic/platform=iOS' CODE_SIGNING_ALLOWED=NO -quiet`  -  fix compilation errors if any.
 9. **UPDATE HISTORY**: Append Phase 4 summary.
 
 ---
 
-## Phase 5 Routing (inline — do NOT read phase-5-orchestrator.md)
+## Phase 5 Routing (inline  -  do NOT read phase-5-orchestrator.md)
 
 **Do NOT read `phase-5-orchestrator.md`. Subagents read their own docs.**
 
 1. **PRE-CHECK**: Verify Phase 4 complete (component Swift file exists at `{componentLocation}`).
 2. **Wave 1 (parallel)**: Dispatch subagents:
-   - **5A** (`phase-5a-viewinspector.md`, sonnet, 40 turns) — ViewInspector structure + accessibility tests.
-   - **5B** (`phase-5b-snapshot.md`, sonnet, 40 turns) — Snapshot tests for all Figma variants.
-3. **Wave 2 (conditional)**: **5C** (`phase-5c-unit.md`, sonnet, 30 turns) — Unit tests. Only if component has ViewModel/model logic. N/A for pure View + Configuration.
-4. **TEST EXECUTION**: Run all tests via script — sequentially, NOT parallel (shared DerivedData lock):
+   - **5A** (`phase-5a-viewinspector.md`, sonnet, 40 turns)  -  ViewInspector structure + accessibility tests.
+   - **5B** (`phase-5b-snapshot.md`, sonnet, 40 turns)  -  Snapshot tests for all Figma variants.
+3. **Wave 2 (conditional)**: **5C** (`phase-5c-unit.md`, sonnet, 30 turns)  -  Unit tests. Only if component has ViewModel/model logic. N/A for pure View + Configuration.
+4. **TEST EXECUTION**: Run all tests via script  -  sequentially, NOT parallel (shared DerivedData lock):
    a. **Switch to local common dependency**: In `{repos.components.path}/Package.swift`, comment out the `.package(url: "...{project.slug}-common...", ...)` line and add `.package(path: "../{project.slug}-common"),` below it. This is needed because the SPM package resolves dependencies from remote git, but Phase 2 adds identifiers/keys to the local editable copy.
    b. **Run tests**:
       ```bash
@@ -323,7 +323,7 @@ After each phase completes, update IMPLEMENTATION_HISTORY.md with phase status,
 
 ## Phase 6 Routing
 
-Phase 6 is dispatched as a single subagent. After the subagent returns COMPLETE, run the finalization script as a safety net (idempotent — safe to run even if the subagent already ran it):
+Phase 6 is dispatched as a single subagent. After the subagent returns COMPLETE, run the finalization script as a safety net (idempotent  -  safe to run even if the subagent already ran it):
 
 ```bash
 python3 .instructions/figma/figma-to-swiftui/scripts/phase6-finalize.py \
@@ -341,24 +341,24 @@ Parse stdout JSON. Verify `"status": "ok"`. Update IMPLEMENTATION_HISTORY.md wit
 
 When building the `Previous Phase Artifacts` section of the dispatch prompt, list artifacts in this order. Compact artifacts go FIRST so the subagent establishes context before large files consume the context window.
 
-Every phase must be independently operable from a clean session — all artifacts remain accessible on disk. This table is a **read-ordering preference**, not a prohibition.
+Every phase must be independently operable from a clean session  -  all artifacts remain accessible on disk. This table is a **read-ordering preference**, not a prohibition.
 
 | Phase | Read FIRST (compact) | Read SECOND (if detail needed) |
 |-------|---------------------|-------------------------------|
 | 2A-2D | `pass1/component_summary.json` | `pass1/design_context_response.json`, `pass1/component_properties.json` |
-| 3A | `pass1/component_summary.json`, `IMPLEMENTATION_HISTORY.md` | — |
+| 3A | `pass1/component_summary.json`, `IMPLEMENTATION_HISTORY.md` |  -  |
 | 3B | `pass1/component_summary.json`, `pass1/variable_defs_response.json` | `pass1/design_context_response.json` (for binding context) |
-| 3C | `pass1/component_summary.json`, `pass1/code_connect_map_response.json` | — |
+| 3C | `pass1/component_summary.json`, `pass1/code_connect_map_response.json` |  -  |
 | 3D | `pass1/component_summary.json`, `pass1/component_properties.json` | `pass1/design_context_response.json`, `pass1/metadata_response.xml` |
-| 3E | `pass1/component_summary.json`, `pass1/design_context_assets.txt` | — |
+| 3E | `pass1/component_summary.json`, `pass1/design_context_assets.txt` |  -  |
 | 3F | `pass1/component_summary.json`, `pass2/utility_*.md` | `pass1/design_context_response.json` |
-| 3G | `pass1/component_summary.json`, `pass3/04b_component_architecture.md` | — |
+| 3G | `pass1/component_summary.json`, `pass3/04b_component_architecture.md` |  -  |
 | 4A | `pass3/04b_component_architecture.md`, `pass3/05_complexity.md`, `pass3/00_property_coverage.json` | `pass1/component_summary.json` |
 | 4B | `pass1/component_summary.json`, `pass3/00_property_coverage.json`, `pass3/07_implementation_spec.md`, `pass3/02_token_mapping.md`, `pass3/04b_component_architecture.md`, `pass3/04_patterns.md`, `pass3/03_nested_components.md`, `pass3/08_utility_integration.md`, `pass1/screenshot.png` | `pass1/design_context_response.json` (for complex layout detail) |
 | 4C | `pass3/07_implementation_spec.md`, `pass3/04b_component_architecture.md`, `pass3/00_property_coverage.json` | `pass1/component_summary.json` |
 | 4D | `{componentLocation}/{ComponentName}.swift`, `{componentLocation}/{ComponentName}Configuration.swift` (if exists) | `pass3/04_patterns.md` |
-| 4E | `{componentLocation}/{ComponentName}Configuration.swift`, `{componentLocation}/{ComponentName}.swift` | — |
-| 6 | `pass1/component_properties.json`, `{sourceLocation}/FIGMA.md`, `{sourceLocation}/{componentName}.swift` | — |
+| 4E | `{componentLocation}/{ComponentName}Configuration.swift`, `{componentLocation}/{ComponentName}.swift` |  -  |
+| 6 | `pass1/component_properties.json`, `{sourceLocation}/FIGMA.md`, `{sourceLocation}/{componentName}.swift` |  -  |
 
 ---
 

package/pipeline/skills/figma-ios/figma-to-component/halt-return-protocol.md

@@ -22,7 +22,7 @@ SUMMARY: {one-line description of what was accomplished}
 STATUS: HALT
 PHASE: phase-{N}
 GATE: {gate-id that failed}
-REASON: {exact reason — copy from instruction if applicable}
+REASON: {exact reason  -  copy from instruction if applicable}
 COMPLETED_GATES: [gates that passed before halt]
 ARTIFACTS_CREATED: [files written before halt, or "none"]
 USER_ACTION_REQUIRED: {what the user must fix before retry}
@@ -52,6 +52,6 @@ CONTEXT: {relevant data the user needs to make the decision}
 2. STOP after outputting the block. Do not call any more tools.
 3. Every gate you pass must appear in GATES_PASSED or COMPLETED_GATES.
 4. Every file you created must appear in ARTIFACTS_CREATED.
-5. Never output a STATUS block mid-execution — only at the very end.
+5. Never output a STATUS block mid-execution  -  only at the very end.
 6. If you encounter multiple failures, report the FIRST one.
 7. If a HALT condition says to check for USER_DECISION in the prompt first, do so before halting.

package/pipeline/skills/figma-ios/figma-to-component/phases/phase-0-init.md

@@ -1,4 +1,4 @@
-# PHASE 0 — Component Initialization
+# PHASE 0  -  Component Initialization
 
 Setup component context and create artifact directory before implementation.
 NEXT: Phase 1 (Data Gathering)
@@ -75,7 +75,7 @@ QUESTION: No node ID found in user input.
 OPTIONS:
   1) Provide Figma URL (format: https://figma.com/design/KEY/Name?node-id=X-Y)
   2) Provide node ID directly (format: X:Y)
-SUGGESTED: Option 1 — paste the full Figma URL
+SUGGESTED: Option 1  -  paste the full Figma URL
 COMPLETED_GATES: [PRE_CHECK_SETUP]
 CONTEXT: A Figma URL or node ID is required to start implementation.
 ```
@@ -118,7 +118,7 @@ OPTIONS:
   1) Update registry first (run registry update command)
   2) Provide component name and location manually
   3) Check if node ID is correct
-SUGGESTED: Option 1 — registry may be outdated
+SUGGESTED: Option 1  -  registry may be outdated
 COMPLETED_GATES: [PRE_CHECK_SETUP, EXTRACT_NODE_ID]
 CONTEXT: The FigmaRegistryUtility lookup returned no results for node ID <NODE_ID>.
 ```
@@ -133,9 +133,9 @@ Resolve `componentName`, `componentLocation`, and `artifactPath` using this prio
 
 | Field | Priority 1 (highest) | Priority 2 | Priority 3 (lowest) |
 |-------|---------------------|------------|---------------------|
-| `componentName` | User-provided in prompt | Suggested by registry | HALT — ask user |
-| `componentLocation` | User-provided in prompt | `suggestedComponentLocation` from registry | HALT — ask user |
-| `artifactPath` | Derived from final `componentName` if name changed | `suggestedArtifactPath` from registry | HALT — ask user |
+| `componentName` | User-provided in prompt | Suggested by registry | HALT  -  ask user |
+| `componentLocation` | User-provided in prompt | `suggestedComponentLocation` from registry | HALT  -  ask user |
+| `artifactPath` | Derived from final `componentName` if name changed | `suggestedArtifactPath` from registry | HALT  -  ask user |
 
 **How to detect user overrides:** Scan the user's original prompt for explicit name or location mentions:
 - `"implement as PackageBadge"` → override componentName
@@ -143,14 +143,14 @@ Resolve `componentName`, `componentLocation`, and `artifactPath` using this prio
 - `"put it in Sources/UIComponents/Booking/"` → override componentLocation
 - Any PascalCase word the user associates with the component → override componentName
 
-If user provided an override in their prompt, use it directly — do NOT ask for confirmation.
-If user did NOT provide an override, use the registry suggestion — but check for vague names first.
+If user provided an override in their prompt, use it directly  -  do NOT ask for confirmation.
+If user did NOT provide an override, use the registry suggestion  -  but check for vague names first.
 
 ### 3.2 Vague name detection
 
 Registry names derived from Figma layer hierarchy can be too generic. Check if `suggestedComponentName` is vague:
 
-**Vague indicators** — single common word that doesn't describe the component's purpose:
+**Vague indicators**  -  single common word that doesn't describe the component's purpose:
 - Generic containers: `Package`, `Card`, `Item`, `Cell`, `Row`, `View`, `Container`, `Component`, `Element`, `Block`, `Section`, `Group`, `Box`, `Wrapper`
 - Generic actions: `Button`, `Label`, `Icon`, `Badge`, `Tag`, `Chip`, `Indicator`
 - Generic layout: `Header`, `Footer`, `Content`, `Body`, `Stack`, `List`
@@ -277,8 +277,8 @@ ls {artifactPath}/pass0/specs.md 2>/dev/null
 ```
 
 **If specs exist:** read the file and store as `implementationSpecs`. These specs will be passed to subsequent phases as additional context:
-- Phase 3 (Analysis) — informs pattern decisions
-- Phase 4 (Implementation) — constrains the init signature, defaults, and behavior
+- Phase 3 (Analysis)  -  informs pattern decisions
+- Phase 4 (Implementation)  -  constrains the init signature, defaults, and behavior
 
 Append to IMPLEMENTATION_HISTORY.md:
 ```markdown
@@ -287,7 +287,7 @@ Append to IMPLEMENTATION_HISTORY.md:
 - Loaded: <DATE>
 ```
 
-**If no specs file:** continue without. No error — specs are optional.
+**If no specs file:** continue without. No error  -  specs are optional.
 
 ---
 

package/pipeline/skills/figma-ios/figma-to-component/phases/phase-1-gathering.md

@@ -1,4 +1,4 @@
-# Phase 1 — Data Gathering
+# Phase 1  -  Data Gathering
 
 ## Overview
 
@@ -28,7 +28,7 @@ Phase 1 is done. All artifacts are in `pass1/`. Proceed to Phase 2.
 
 ### If `status` = `COMPLETE_WITH_DEFERRED`
 
-The script completed all data gathering **except** `get_design_context`, which was deferred because the component has too many sublayers (>20). Report status to orchestrator — it will dispatch a Phase 1 subagent for deferred resolution.
+The script completed all data gathering **except** `get_design_context`, which was deferred because the component has too many sublayers (>20). Report status to orchestrator  -  it will dispatch a Phase 1 subagent for deferred resolution.
 
 ---
 
@@ -52,9 +52,9 @@ Classify each variant axis:
 
 | Category | Examples | Action |
 |----------|----------|--------|
-| **Interaction** | `State` (Default/Hover/Pressed/Disabled), focus/hover variants | Fix to `Default` (only color/opacity changes — no structural difference) |
+| **Interaction** | `State` (Default/Hover/Pressed/Disabled), focus/hover variants | Fix to `Default` (only color/opacity changes  -  no structural difference) |
 | **Theme** | `Color`, `Theme`, `Mode` | Fix to first value (e.g., `Brand`) |
-| **Structural** | `Size`, `Style`, `IconDirection`, `Type`, `Layout`, everything else | **Vary** — these change layout/structure |
+| **Structural** | `Size`, `Style`, `IconDirection`, `Type`, `Layout`, everything else | **Vary**  -  these change layout/structure |
 
 Calculate structural combinations:
 - If <= 20: fetch all structural combinations (with interaction + theme fixed).
@@ -66,7 +66,7 @@ Each sublayer in Figma is a variant named like `Color=Brand, Size=Default, Style
 
 The `sublayerIds` list in `design_context_deferred.json` corresponds to the children of the component set. To map selected variant combinations to node IDs:
 
-1. Read `{artifactPath}/pass1/screenshots/variants.md` — it has a table of `Variant | Node ID | File`.
+1. Read `{artifactPath}/pass1/screenshots/variants.md`  -  it has a table of `Variant | Node ID | File`.
 2. Match your selected combinations against the variant names.
 3. Collect the node IDs for matched variants.
 

package/pipeline/skills/figma-ios/figma-to-component/phases/phase-1.5-existing-discovery.md

@@ -1,9 +1,9 @@
-# PHASE 1.5 — Existing Component Discovery
+# PHASE 1.5  -  Existing Component Discovery
 
 Detects whether the target component is already implemented in the codebase OR already mapped via Code Connect, BEFORE Phase 2 starts greenfield generation. Without this gate, the pipeline can silently overwrite existing implementations and re-publish duplicate Code Connect mappings.
 
 PREV: Phase 1 (Data Gathering)
-NEXT: Phase 2 (Utility Integration) — only when status is `GREENFIELD_OK`
+NEXT: Phase 2 (Utility Integration)  -  only when status is `GREENFIELD_OK`
 REF: `phase-6-code-connect.md` (publish gate honors discovery output)
 
 ---
@@ -12,12 +12,12 @@ REF: `phase-6-code-connect.md` (publish gate honors discovery output)
 
 | Condition | Action |
 |---|---|
-| `pass1/code_connect_map_response.json` missing | HALT — Phase 1 didn't complete cleanly |
+| `pass1/code_connect_map_response.json` missing | HALT  -  Phase 1 didn't complete cleanly |
 | All other cases | EXECUTE |
 
 ---
 
-## STEP 1 — Inspect Code Connect map for self-reference
+## STEP 1  -  Inspect Code Connect map for self-reference
 
 INPUT: `{artifactPath}/pass1/code_connect_map_response.json`
 
@@ -26,7 +26,7 @@ The map is a `{ nodeId: { codeConnectSrc, codeConnectName } }` lookup. The curre
 ```python
 # Pseudocode
 target_node_id = state.issue.nodeId    # e.g. "7528:23317"
-target_name    = state.issue.componentName  # PascalCase, e.g. "MilesSmilesAccountSettingsAirlineProgramMembershipLayout"
+target_name    = state.issue.componentName  # PascalCase, e.g. "MyComponentSettingsLayout"
 
 cc_map = json.load(open(f"{artifactPath}/pass1/code_connect_map_response.json"))
 
@@ -42,7 +42,7 @@ If `ALREADY_MAPPED`: the target Figma node is already wired to a code component.
 
 ---
 
-## STEP 2 — Search the codebase for an existing source file
+## STEP 2  -  Search the codebase for an existing source file
 
 If Step 1 returned no match, look for a file that matches the target component name. Use the project's component root (resolved from `figma-config.json` → `componentRoot` if set, else `Sources/UIComponents/Components/`).
 
@@ -54,9 +54,9 @@ Three outcomes:
 
 | Files found | Status |
 |---|---|
-| 0 | `GREENFIELD_OK` — proceed to Phase 2 normally |
-| 1 | `EXISTING_SOURCE_NO_CC` — file exists but Code Connect mapping is missing |
-| 2+ | `AMBIGUOUS_SOURCE` — multiple files match; needs user disambiguation |
+| 0 | `GREENFIELD_OK`  -  proceed to Phase 2 normally |
+| 1 | `EXISTING_SOURCE_NO_CC`  -  file exists but Code Connect mapping is missing |
+| 2+ | `AMBIGUOUS_SOURCE`  -  multiple files match; needs user disambiguation |
 
 For `EXISTING_SOURCE_NO_CC`, also check whether a sibling `.figma.swift` exists:
 
@@ -70,7 +70,7 @@ If `.figma.swift` is absent → the source exists but is fully unconnected.
 
 ---
 
-## STEP 3 — User decision (only on non-greenfield)
+## STEP 3  -  User decision (only on non-greenfield)
 
 When the orchestrator sees status `ALREADY_MAPPED`, `EXISTING_SOURCE_NO_CC`, or `AMBIGUOUS_SOURCE`, emit a `STATUS: NEEDS_INPUT` block to the parent multi-agent pipeline.
 
@@ -83,9 +83,9 @@ GATE: ALREADY_MAPPED
 DETECTED: {sourcePath} (already mapped to Figma node {nodeId})
 QUESTION: This Figma node is already wired to a code component. What should the pipeline do?
 OPTIONS:
-  1. Run gap analysis only (FIGMA.md / tests / wiki — fill what's missing, do NOT touch the component source)
-  2. Force regenerate (DANGER — overwrites the existing source file; only choose this if the design has materially changed)
-  3. Cancel — abort this run, no edits
+  1. Run gap analysis only (FIGMA.md / tests / wiki  -  fill what's missing, do NOT touch the component source)
+  2. Force regenerate (DANGER  -  overwrites the existing source file; only choose this if the design has materially changed)
+  3. Cancel  -  abort this run, no edits
 DEFAULT: 1
 ```
 
@@ -101,9 +101,9 @@ DETECTED: {sourcePath} exists in the codebase but is not connected to the Figma
 SIBLING_FIGMA_SWIFT: {present | absent}
 QUESTION: Found an existing source file matching {target_name}. What should the pipeline do?
 OPTIONS:
-  1. Add Code Connect only — write {target_name}.figma.swift next to the source, publish it (recommended when sibling absent)
-  2. Publish-only — sibling .figma.swift already exists; just run `figma connect publish` (recommended when sibling present)
-  3. Force regenerate — overwrite the source file with a fresh greenfield generation
+  1. Add Code Connect only  -  write {target_name}.figma.swift next to the source, publish it (recommended when sibling absent)
+  2. Publish-only  -  sibling .figma.swift already exists; just run `figma connect publish` (recommended when sibling present)
+  3. Force regenerate  -  overwrite the source file with a fresh greenfield generation
   4. Cancel
 DEFAULT: 2 if sibling present, else 1
 ```
@@ -119,13 +119,13 @@ CANDIDATES: <bulleted list of paths>
 QUESTION: Pick the canonical source for this Figma node, or cancel.
 OPTIONS:
   <one option per candidate>
-  N+1. None of the above — treat as greenfield
+  N+1. None of the above  -  treat as greenfield
   N+2. Cancel
 ```
 
 ---
 
-## STEP 4 — Gap analysis (only on ALREADY_MAPPED + user picked option 1)
+## STEP 4  -  Gap analysis (only on ALREADY_MAPPED + user picked option 1)
 
 When the existing component is reused, the orchestrator still checks what's missing:
 
@@ -136,7 +136,7 @@ SRC_DIR=$(dirname "$sourcePath")
 # Snapshot tests, ViewInspector tests, wiki MD, ...
 ```
 
-The gap list goes into `state.discovery.gaps[]`. Phases 2/3 are SKIPPED. Phase 4–7 run only the steps that target gaps:
+The gap list goes into `state.discovery.gaps[]`. Phases 2/3 are SKIPPED. Phase 4-7 run only the steps that target gaps:
 
 | Gap | Phase that fills it |
 |---|---|

package/pipeline/skills/figma-ios/figma-to-component/phases/phase-2-orchestrator.md

@@ -1,4 +1,4 @@
-# PHASE 2 — Utility Integration Orchestrator
+# PHASE 2  -  Utility Integration Orchestrator
 
 Orchestrates Phase 2 sub-phases: dispatches sub-agents, collects results, writes pass2/_index.md.
 PREV: Phase 1.5 (Existing Component Discovery)
@@ -6,18 +6,18 @@ NEXT: Phase 3 (Data Analysis)
 
 ---
 
-## ENTRY GATE — discovery status
+## ENTRY GATE  -  discovery status
 
 Phase 2 reads `agent-state.discovery.status` written by Phase 1.5:
 
 | `discovery.status` | Phase 2 action |
 |---|---|
-| `GREENFIELD_OK` (or absent for backward compat) | EXECUTE — run all sub-phases below |
-| `GAP_ANALYSIS` | SKIP — Phase 2 outputs are not needed; jump to Phase 4 (only run Documentation / Code Connect / tests / wiki sub-phases that target the gap list) |
-| `ALREADY_MAPPED` (no user override) | SKIP — same as `GAP_ANALYSIS` |
-| `EXISTING_SOURCE_NO_CC` (publish-only path picked) | SKIP — jump to Phase 6 |
+| `GREENFIELD_OK` (or absent for backward compat) | EXECUTE  -  run all sub-phases below |
+| `GAP_ANALYSIS` | SKIP  -  Phase 2 outputs are not needed; jump to Phase 4 (only run Documentation / Code Connect / tests / wiki sub-phases that target the gap list) |
+| `ALREADY_MAPPED` (no user override) | SKIP  -  same as `GAP_ANALYSIS` |
+| `EXISTING_SOURCE_NO_CC` (publish-only path picked) | SKIP  -  jump to Phase 6 |
 | `CANCELLED` | HALT |
-| Any other value | HALT — unknown discovery state, refuse to proceed |
+| Any other value | HALT  -  unknown discovery state, refuse to proceed |
 
 If `discovery` field is absent on `agent-state.json`, log a one-line warning ("phase-1.5 not run; assuming GREENFIELD_OK") and proceed. This preserves backward compatibility with runs started before the discovery gate existed.
 
@@ -35,7 +35,7 @@ import UIComponentUtilities
 |----------|-----------|-------|
 | Testing | `View.accessibilityIdentifier(_ key: UITestingIdentifierKey)` | `.accessibilityIdentifier(.ComponentName.element)` |
 | Localization | `Text(_ key: LocalizationStringKey)` | `Text(.ComponentName.title)` |
-| Accessibility | `View.accessibilityLabel(_ key: LocalizedAccessibilityStringKey)` | Only when SwiftUI can't read visible text — many components need NO accessibility modifiers |
+| Accessibility | `View.accessibilityLabel(_ key: LocalizedAccessibilityStringKey)` | Only when SwiftUI can't read visible text  -  many components need NO accessibility modifiers |
 | Analytics | `View.analyticsButton(id:label:type:)` | `.analyticsButton(id: "id", label: "Submit", type: .primary)` |
 
 SOURCE: `Sources/UIComponentUtilities/`
@@ -91,7 +91,7 @@ Check the JSON structure:
 
 | Format | Detection | Action |
 |--------|-----------|--------|
-| Normal | `sublayers` is `false` or absent | No action needed — `response` field exists |
+| Normal | `sublayers` is `false` or absent | No action needed  -  `response` field exists |
 | Sublayer | `sublayers` is `true` | Concatenate all `responses` values (see below) |
 
 ### Sublayer normalization
@@ -104,7 +104,7 @@ If `sublayers: true`:
 4. Keep the original `sublayers`, `sublayerNodeIds`, and `responses` fields intact (for traceability)
 5. Write the updated JSON back to `{artifactPath}/pass1/design_context_response.json`
 
-After normalization, all sub-phases read the `response` field as usual — no sublayer awareness needed.
+After normalization, all sub-phases read the `response` field as usual  -  no sublayer awareness needed.
 
 ```json
 {
@@ -162,14 +162,14 @@ REGISTRY_LOOKUP
 ┌───────────────────────────────────┐
 │  PARALLEL DISPATCH (sub-agents)   │
 │                                   │
-│   2A — Testing Identifiers        │  ← required
-│   2B — Localization Keys          │  ← if visible text
-│   2C — Accessibility Keys         │  ← required
+│   2A  -  Testing Identifiers        │  ← required
+│   2B  -  Localization Keys          │  ← if visible text
+│   2C  -  Accessibility Keys         │  ← required
 │                                   │
 └───────────────────────────────────┘
     ↓ wait for all to complete
     ↓
-    2D — Analytics Events              ← if interactive elements (depends on 2A output)
+    2D  -  Analytics Events              ← if interactive elements (depends on 2A output)
     ↓
 COLLECT RESULTS
     ↓
@@ -216,13 +216,13 @@ After all sub-phases complete, verify each produced its artifacts (both JSON sid
 
 ```
 [ ] pass2/utility_identifiers.md exists (Phase 2A)
-[ ] pass2/utility_identifiers.json exists (Phase 2A — JSON sidecar)
-[ ] pass2/utility_localization.md exists (Phase 2B — or skipped placeholder)
-[ ] pass2/utility_localization.json exists (Phase 2B — JSON sidecar)
+[ ] pass2/utility_identifiers.json exists (Phase 2A  -  JSON sidecar)
+[ ] pass2/utility_localization.md exists (Phase 2B  -  or skipped placeholder)
+[ ] pass2/utility_localization.json exists (Phase 2B  -  JSON sidecar)
 [ ] pass2/utility_accessibility.md exists (Phase 2C)
-[ ] pass2/utility_accessibility.json exists (Phase 2C — JSON sidecar)
-[ ] pass2/utility_analytics.md exists (Phase 2D — or skipped placeholder)
-[ ] pass2/utility_analytics.json exists (Phase 2D — JSON sidecar)
+[ ] pass2/utility_accessibility.json exists (Phase 2C  -  JSON sidecar)
+[ ] pass2/utility_analytics.md exists (Phase 2D  -  or skipped placeholder)
+[ ] pass2/utility_analytics.json exists (Phase 2D  -  JSON sidecar)
 ```
 
 ANY markdown missing →
@@ -235,7 +235,7 @@ MISSING: [list missing files]
 USER_ACTION_REQUIRED: Re-run the failed sub-phase.
 ```
 
-If a JSON sidecar is missing but the markdown exists, the finalize script will log a warning and use empty arrays — this is non-blocking.
+If a JSON sidecar is missing but the markdown exists, the finalize script will log a warning and use empty arrays  -  this is non-blocking.
 
 ---
 
@@ -293,10 +293,10 @@ Using the counts from the finalize script output, append to `{artifactPath}/IMPL
 [ ] design_context_response.json normalized (sublayer → flat response field)
 [ ] Registry lookup performed (utility-lookup)
 [ ] Pre-existing keys passed to sub-phases (if registry data found)
-[ ] Phase 2A completed — utility_identifiers.md + .json exists (required)
-[ ] Phase 2B completed — utility_localization.md + .json exists (or skipped with placeholder)
-[ ] Phase 2C completed — utility_accessibility.md + .json exists (required)
-[ ] Phase 2D completed — utility_analytics.md + .json exists (or skipped with placeholder)
+[ ] Phase 2A completed  -  utility_identifiers.md + .json exists (required)
+[ ] Phase 2B completed  -  utility_localization.md + .json exists (or skipped with placeholder)
+[ ] Phase 2C completed  -  utility_accessibility.md + .json exists (required)
+[ ] Phase 2D completed  -  utility_analytics.md + .json exists (or skipped with placeholder)
 [ ] phase2-finalize.py ran successfully (builds component-utilities.json, registers, writes _index.md)
 [ ] IMPLEMENTATION_HISTORY.md updated with Phase 2 summary (using script output counts)
 ```

package/pipeline/skills/figma-ios/figma-to-component/phases/phase-2a-testing-identifiers.md

@@ -1,9 +1,9 @@
-# PHASE 2A — Testing Identifiers
+# PHASE 2A  -  Testing Identifiers
 
 UI testing identifier integration.
 REF: `reference/testing-identifiers-naming.md`
 
-required — always execute this phase.
+required  -  always execute this phase.
 PARALLEL WITH: Phase 2B, Phase 2C (all read from pass1/_index.md independently)
 NEXT: Phase 2D (depends on this phase's output)
 
@@ -68,7 +68,7 @@ USER_ACTION_REQUIRED: Run Phase 1 first to gather Figma data.
 
 ## CONTEXT-AWARE IDENTIFIERS
 
-Components are reusable — the same `TurkishButton` appears in many screens.
+Components are reusable  -  the same `TurkishButton` appears in many screens.
 Testing identifiers cascade via `UIIdentifierContext` (SwiftUI EnvironmentKey).
 
 ### How It Works
@@ -76,7 +76,7 @@ Testing identifiers cascade via `UIIdentifierContext` (SwiftUI EnvironmentKey).
 Parent views set context using `UITestingIdentifierKey` or raw strings:
 
 ```swift
-// Type-safe (recommended) — uses key's identifier string as segment
+// Type-safe (recommended)  -  uses key's identifier string as segment
 PassengerListView()
     .identifierContext(.PassengerList.screen)
 
@@ -85,7 +85,7 @@ SearchSection()
     .identifierContext("search")
 ```
 
-Child components use standard `.accessibilityIdentifier(.Component.element)` —
+Child components use standard `.accessibilityIdentifier(.Component.element)`  - 
 the context is prepended automatically:
 
 ```
@@ -97,7 +97,7 @@ context = ["passenger_list", "search"]
 ### What Phase 2A Generates
 
 Phase 2A generates **component-level** identifiers only (e.g., `TurkishButton.button`).
-Context prefixes are NOT baked into component identifiers — they come from the
+Context prefixes are NOT baked into component identifiers  -  they come from the
 parent view hierarchy at runtime via `.identifierContext()`.
 
 ### Artifact Guidance
@@ -282,7 +282,7 @@ Write `{artifactPath}/pass2/utility_identifiers.json`:
 }
 ```
 
-This JSON is consumed by `phase2-finalize.py` to build `component-utilities.json`. The orchestrator reads ONLY this JSON — never the markdown.
+This JSON is consumed by `phase2-finalize.py` to build `component-utilities.json`. The orchestrator reads ONLY this JSON  -  never the markdown.
 
 ### Markdown Artifact (human-readable)