@mmerterden/multi-agent-pipeline 8.6.1 → 10.0.6

package/pipeline/skills/figma-ios/figma-to-component/phases/phase-6-code-connect.md

@@ -1,4 +1,4 @@
-# PHASE 6 — Code Connect Publish
+# PHASE 6  -  Code Connect Publish
 
 Publish Code Connect mapping to Figma so developers see live Swift snippets in Dev Mode.
 
@@ -13,12 +13,12 @@ REF: `reference/code-connect.md`
 | Condition | Action |
 |-----------|--------|
 | User requested "skip Code Connect" | SKIP → Output "Phase 6 skipped per user request" |
-| `agent-state.discovery.status === "ALREADY_MAPPED"` and `"Code Connect" not in discovery.gaps` | SKIP → Output "Phase 6 skipped — already published per Phase 1.5 discovery" |
-| `agent-state.discovery.status === "GAP_ANALYSIS"` and `"Code Connect" not in discovery.gaps` | SKIP — same as above |
-| `.figma.swift` already exists at the target component path AND `figma client status` reports it published | SKIP → Output "Phase 6 skipped — .figma.swift already published" |
+| `agent-state.discovery.status === "ALREADY_MAPPED"` and `"Code Connect" not in discovery.gaps` | SKIP → Output "Phase 6 skipped  -  already published per Phase 1.5 discovery" |
+| `agent-state.discovery.status === "GAP_ANALYSIS"` and `"Code Connect" not in discovery.gaps` | SKIP  -  same as above |
+| `.figma.swift` already exists at the target component path AND `figma client status` reports it published | SKIP → Output "Phase 6 skipped  -  .figma.swift already published" |
 | All other cases | EXECUTE |
 
-The discovery state is the primary signal; the local `.figma.swift` check is a secondary safety net for runs that bypassed Phase 1.5 (e.g. legacy resume from an older state file). Both checks default to EXECUTE when uncertain — duplicate publishes are idempotent on Figma's side.
+The discovery state is the primary signal; the local `.figma.swift` check is a secondary safety net for runs that bypassed Phase 1.5 (e.g. legacy resume from an older state file). Both checks default to EXECUTE when uncertain  -  duplicate publishes are idempotent on Figma's side.
 
 ---
 
@@ -54,7 +54,7 @@ TOKEN=$("$HOME/.claude/lib/credential-store.sh" get \1 2>/dev/null) && echo "OK"
 | `OK` | Verify prefix (see below) |
 | `MISSING` | HALT |
 
-**CRITICAL — Token prefix check:**
+**CRITICAL  -  Token prefix check:**
 
 ```bash
 TOKEN=$("$HOME/.claude/lib/credential-store.sh" get \1 2>/dev/null)
@@ -69,8 +69,8 @@ fi
 
 | Result | Action |
 |--------|--------|
-| `VALID_PAT` | Proceed — this is a Figma Personal Access Token |
-| `WRONG_TOKEN_TYPE` | **HALT** — `figu_` prefix = MCP OAuth token. This token does NOT work with Code Connect CLI (returns 403). The `FIGMA_ACCESS_TOKEN` keychain entry contains an MCP token instead of a PAT. User must save a valid PAT: `"$HOME/.claude/lib/credential-store.sh" set \1 \"\2\"` |
+| `VALID_PAT` | Proceed  -  this is a Figma Personal Access Token |
+| `WRONG_TOKEN_TYPE` | **HALT**  -  `figu_` prefix = MCP OAuth token. This token does NOT work with Code Connect CLI (returns 403). The `FIGMA_ACCESS_TOKEN` keychain entry contains an MCP token instead of a PAT. User must save a valid PAT: `"$HOME/.claude/lib/credential-store.sh" set \1 \"\2\"` |
 | `UNKNOWN_TOKEN` | Proceed with caution, verify publish output for 403 errors |
 
 **Do NOT use `FIGMA_MCP_TOKEN`** for Code Connect. MCP OAuth tokens (`figu_*`) lack the scopes needed by the Code Connect REST API.
@@ -123,7 +123,7 @@ ls {artifactPath}/pass1/component_properties.json
 | Source | Data |
 |--------|------|
 | `pass1/component_properties.json` | `isComponent`, `componentPropertyDefinitions` |
-| `pass3/04c_variant_config_analysis.json` | Boolean classifications and Swift types (from Phase 3H). Use to determine correct `@FigmaBoolean` mappings — e.g., `KNOWN_SUBCOMPONENT` → map to `nil`/default-config, `ICON_BOOLEAN_GATED` with `Optional3<Image>` → map to `.default`/`.none`. **No ternary expressions.** |
+| `pass3/04c_variant_config_analysis.json` | Boolean classifications and Swift types (from Phase 3H). Use to determine correct `@FigmaBoolean` mappings  -  e.g., `KNOWN_SUBCOMPONENT` → map to `nil`/default-config, `ICON_BOOLEAN_GATED` with `Optional3<Image>` → map to `.default`/`.none`. **No ternary expressions.** |
 | `{sourceLocation}/FIGMA.md` Variant Mapping | Figma Value → Swift enum mapping |
 | `{sourceLocation}/FIGMA.md` Usage | Default values, body template |
 
@@ -141,9 +141,9 @@ ls {artifactPath}/pass1/component_properties.json
 |------------|------------------|---------|
 | `TEXT` | `@FigmaString("Name")` | `@FigmaString("Label") var label: String = "Default"` |
 | `BOOLEAN` | `@FigmaBoolean("Name", hideDefault: true)` | `@FigmaBoolean("Disabled") var disabled: Bool = false` |
-| `BOOLEAN` (non-Bool type) | `@FigmaBoolean("Name", mapping: [...], hideDefault: true)` | `@FigmaBoolean("Left Icon", mapping: [true: Image(...), false: nil], hideDefault: true) var leftIcon: Image? = nil` — **hideDefault trap:** set default to the value you want HIDDEN (typically `nil`), NOT the `true` mapping value. See `reference/code-connect.md` §3 for details. |
-| `VARIANT` | `@FigmaEnum("Name", mapping: [...])` | `@FigmaEnum("Size", mapping: ["S": .small])` — MUST use implicit shorthand (`.small` NEVER `Type.small`) |
-| `INSTANCE_SWAP` | `@FigmaInstance("Name")` | `@FigmaInstance("Icon") var icon: AnyView?` — **no hideDefault support**, use `@FigmaBoolean` with mapping instead when controlled by a boolean toggle |
+| `BOOLEAN` (non-Bool type) | `@FigmaBoolean("Name", mapping: [...], hideDefault: true)` | `@FigmaBoolean("Left Icon", mapping: [true: Image(...), false: nil], hideDefault: true) var leftIcon: Image? = nil`  -  **hideDefault trap:** set default to the value you want HIDDEN (typically `nil`), NOT the `true` mapping value. See `reference/code-connect.md` section3 for details. |
+| `VARIANT` | `@FigmaEnum("Name", mapping: [...])` | `@FigmaEnum("Size", mapping: ["S": .small])`  -  MUST use implicit shorthand (`.small` NEVER `Type.small`) |
+| `INSTANCE_SWAP` | `@FigmaInstance("Name")` | `@FigmaInstance("Icon") var icon: AnyView?`  -  **no hideDefault support**, use `@FigmaBoolean` with mapping instead when controlled by a boolean toggle |
 
 ---
 
@@ -217,7 +217,7 @@ struct {componentName}FigmaConnect: FigmaConnect {
 }
 ```
 
-### 2.4 Multi-Variant (string enum — separate structs per variant)
+### 2.4 Multi-Variant (string enum  -  separate structs per variant)
 
 ```swift
 struct {componentName}PrimaryFigmaConnect: FigmaConnect {
@@ -228,18 +228,18 @@ struct {componentName}PrimaryFigmaConnect: FigmaConnect {
 }
 ```
 
-### 2.5 Multi-Variant (boolean gate — computed variant property)
+### 2.5 Multi-Variant (boolean gate  -  computed variant property)
 
 When a boolean toggle changes the component's form (e.g., "Label" on/off):
 ```swift
-// Default struct — no variant property (matches when boolean is true/default)
+// Default struct  -  no variant property (matches when boolean is true/default)
 struct {componentName}FigmaConnect: FigmaConnect {
     let component = {componentName}.self
     let figmaNodeUrl: String = "https://figma.com/design/{fileKey}/?node-id={nodeId}"
     var body: some View { ... }
 }
 
-// Alternative struct — matches when boolean is false
+// Alternative struct  -  matches when boolean is false
 struct {componentName}IconOnlyFigmaConnect: FigmaConnect {
     let component = {componentName}.self
     let figmaNodeUrl: String = "https://figma.com/design/{fileKey}/?node-id={nodeId}"
@@ -249,7 +249,7 @@ struct {componentName}IconOnlyFigmaConnect: FigmaConnect {
 ```
 Figma shows the most specific matching struct.
 
-### 2.6 Icon/Symbol (no component — for bulk icon Code Connect)
+### 2.6 Icon/Symbol (no component  -  for bulk icon Code Connect)
 
 For simple icon nodes without component properties:
 ```swift
@@ -262,10 +262,10 @@ No `let component`, no property wrappers. Generated in bulk via `generate_icons.
 
 Use `FIGMA.md` Variant Mapping section to build the `@FigmaEnum` mappings.
 
-**CRITICAL — Implicit Enum Shorthand:**
+**CRITICAL  -  Implicit Enum Shorthand:**
 - ALL enum values in `@FigmaEnum` mappings MUST use implicit shorthand: `.large` NOT `AvatarPassengers.Size.large`
 - Variable types use the nested type path: `AvatarPassengers.Size` NOT the old top-level name
-- The `body` init call MUST also use implicit shorthand: `AvatarPassengers(size: size, loyaltyType: loyaltyType)` — the variable already carries the type
+- The `body` init call MUST also use implicit shorthand: `AvatarPassengers(size: size, loyaltyType: loyaltyType)`  -  the variable already carries the type
 
 ---
 
@@ -357,7 +357,7 @@ export FIGMA_ACCESS_TOKEN=$("$HOME/.claude/lib/credential-store.sh" get \1)
 
 ### 5.2 Publish via Wrapper Script
 
-**Always use the wrapper script** — it handles validation failures from other components automatically:
+**Always use the wrapper script**  -  it handles validation failures from other components automatically:
 
 ```bash
 bash .instructions/figma/figma-to-swiftui/scripts/code-connect-publish.sh
@@ -374,17 +374,17 @@ The wrapper script:
 3. Restores `figma.config.json` to original state via trap (crash-safe)
 4. Reports excluded components as warnings
 
-**CRITICAL — Check exit code.** `exit code 0` = components published. `exit code 1` = **NOTHING published** (entire batch rejected). The "Successfully connected component" lines in output mean **parse success**, NOT publish success.
+**CRITICAL  -  Check exit code.** `exit code 0` = components published. `exit code 1` = **NOTHING published** (entire batch rejected). The "Successfully connected component" lines in output mean **parse success**, NOT publish success.
 
 ### 5.3 Result Handling
 
 | Result | Action |
 |--------|--------|
 | Script exits 0 | Proceed to GATE 6 |
-| Script exits 0 with WARNING block | Proceed — stale components were auto-excluded and config restored. Note excluded components in IMPLEMENTATION_HISTORY. |
-| Script exits 1 with "403" | **HALT** — token invalid or wrong type. Check prefix: `figd_` = PAT (correct), `figu_` = MCP token (wrong). Re-read PRE-CHECK step 3 token prefix check. |
+| Script exits 0 with WARNING block | Proceed  -  stale components were auto-excluded and config restored. Note excluded components in IMPLEMENTATION_HISTORY. |
+| Script exits 1 with "403" | **HALT**  -  token invalid or wrong type. Check prefix: `figd_` = PAT (correct), `figu_` = MCP token (wrong). Re-read PRE-CHECK step 3 token prefix check. |
 | Script exits 1, validation failure on **current** component | Fix the `.figma.swift` mapping, retry |
-| Script exits 1, retry also failed | **HALT** — deeper issue. Check output for details. |
+| Script exits 1, retry also failed | **HALT**  -  deeper issue. Check output for details. |
 | Other error | HALT |
 
 ### 5.4 Fallback (manual publish)
@@ -417,7 +417,7 @@ USER_ACTION_REQUIRED: Options:
 
 ## GATE 5.5: BUILD_VERIFY
 
-Code Connect publish does NOT compile Swift — it only validates against the Figma API. A `.figma.swift` file with compile errors will publish successfully but break the project build. Verify compilation after publish:
+Code Connect publish does NOT compile Swift  -  it only validates against the Figma API. A `.figma.swift` file with compile errors will publish successfully but break the project build. Verify compilation after publish:
 
 ```bash
 xcodebuild build -project "$(git rev-parse --show-toplevel)/{build.xcodeproj}" \
@@ -429,13 +429,13 @@ xcodebuild build -project "$(git rev-parse --show-toplevel)/{build.xcodeproj}" \
 |--------|--------|
 | Build succeeds | Proceed to GATE 6 |
 | Build fails on `.figma.swift` | Fix compile errors, re-run build |
-| Build fails on unrelated file | Pre-existing error — proceed (note in history) |
+| Build fails on unrelated file | Pre-existing error  -  proceed (note in history) |
 
 **Common `.figma.swift` compile errors:**
 - Fully-qualified enum path: `ComponentName.EnumType.case` → change to `.case`
 - Wrong type: `var x: EnumType` → should be `ComponentName.EnumType`
 - Missing import: add `import Figma` and `import SwiftUI`
-- Stale property: component changed after Code Connect was written — update mapping
+- Stale property: component changed after Code Connect was written  -  update mapping
 
 ---
 
@@ -483,10 +483,10 @@ python3 .instructions/figma/figma-to-swiftui/scripts/phase6-finalize.py \
 
 | Result | Action |
 |--------|--------|
-| Exit 0, `"action": "updated"` | Registry updated — proceed |
-| Exit 0, `"action": "created"` | New registry file created — proceed |
-| Exit 0, `"action": "already_set"` | Already marked — proceed |
-| Exit 1 | HALT — registry update failed |
+| Exit 0, `"action": "updated"` | Registry updated  -  proceed |
+| Exit 0, `"action": "created"` | New registry file created  -  proceed |
+| Exit 0, `"action": "already_set"` | Already marked  -  proceed |
+| Exit 1 | HALT  -  registry update failed |
 
 **Why this matters:** The `confluence-component-status.py` dashboard reads `codeConnect.ios` from these registry files to determine if a component is "implemented". Without this update, the component won't appear as implemented in the status dashboard.
 

package/pipeline/skills/figma-ios/figma-to-component/phases/phase-7-wiki.md

@@ -1,4 +1,4 @@
-# Phase 7 — Wiki Documentation
+# Phase 7  -  Wiki Documentation
 
 Phase 7 generates markdown documentation for the GitHub Wiki.
 
@@ -11,9 +11,9 @@ See `phases/phase-7a-wiki-generate.md`.
 Generates **two separate pages** per component in the wiki submodule at:
 `{repos.wiki.path}/FigmaComponents/{category}/{componentName}/`
 
-- `{ComponentName}.md` — platform-agnostic main page (Variants, Overview, Testing IDs, Localization, Accessibility, Analytics, Sub-Components, Platform Implementations, Changelog)
-- `{ComponentName}-iOS.md` — iOS-specific sub-page (Initializer, Usage, iOS utility patterns, Code Connect, Snapshot Tests, Changelog)
-- `assets/` — screenshots (Figma + iOS snapshots)
+- `{ComponentName}.md`  -  platform-agnostic main page (Variants, Overview, Testing IDs, Localization, Accessibility, Analytics, Sub-Components, Platform Implementations, Changelog)
+- `{ComponentName}-iOS.md`  -  iOS-specific sub-page (Initializer, Usage, iOS utility patterns, Code Connect, Snapshot Tests, Changelog)
+- `assets/`  -  screenshots (Figma + iOS snapshots)
 
 This mirrors the old Confluence structure (main.html + ios.html) in wiki markdown format.
 
@@ -29,7 +29,7 @@ All images use GitHub Wiki double-bracket syntax with absolute paths from wiki r
 [[/FigmaComponents/{category}/{componentName}/assets/{filename}|{alt}]]
 ```
 
-Do NOT use `![alt](url)` markdown syntax or raw GitHub URLs — they do not render on GitHub Wiki.
+Do NOT use `![alt](url)` markdown syntax or raw GitHub URLs  -  they do not render on GitHub Wiki.
 
 ## Confluence Sync (Separate)
 

package/pipeline/skills/figma-ios/figma-to-component/phases/phase-7a-confluence-generate.md

@@ -1,4 +1,4 @@
-# PHASE 7A — Confluence Documentation: Generate XHTML
+# PHASE 7A  -  Confluence Documentation: Generate XHTML
 
 Generate platform-agnostic main page + iOS sub-page as XHTML artifacts.
 No network access required. Upload is handled by Phase 7B.
@@ -8,7 +8,7 @@ PREV: Phase 6 (Code Connect)
 NEXT: Phase 7B (Upload to Confluence, VPN required)
 TOOL RESTRICTIONS: No Edit
 
-> **VPN Note:** This phase generates XHTML locally — no VPN needed. Colleagues
+> **VPN Note:** This phase generates XHTML locally  -  no VPN needed. Colleagues
 > without VPN access can run this phase and commit the Confluence documentation directory.
 > A colleague with VPN then runs Phase 7B to upload.
 >
@@ -25,7 +25,7 @@ Read: {artifactPath}/IMPLEMENTATION_HISTORY.md
 Read: {componentLocation}/{componentName}.swift
 Read: {componentLocation}/FIGMA.md
 Read: {artifactPath}/pass1/screenshot.png (verify exists)
-Read: {artifactPath}/pass1/screenshots/variants.md (if exists — variant property values)
+Read: {artifactPath}/pass1/screenshots/variants.md (if exists  -  variant property values)
 Read: {artifactPath}/pass3/07_implementation_spec.md
 Read: {artifactPath}/pass3/08_utility_integration.md
 Read: {artifactPath}/pass3/03_nested_components.md
@@ -54,14 +54,14 @@ EXTRACT:
 - `componentLocation`, `artifactPath`, `confluencePath`
 - `complexity` (SIMPLE/COMPLEX from pass3/07)
 - `registryData` (testingIdentifiers, localizationKeys, accessibilityKeys, analyticsEvents)
-- `confluenceStatus` — from registry `confluence` field: `{ page, ios, android }` (null = not yet created)
+- `confluenceStatus`  -  from registry `confluence` field: `{ page, ios, android }` (null = not yet created)
 - Initializer signature (from FIGMA.md)
 - Usage examples (from FIGMA.md)
 - Nested components (from FIGMA.md / pass3/03)
 - Code Connect status (from FIGMA.md Code Connect section, if exists)
 - Description, screen, section, size (from pass3/07)
 
-If `confluence.page` is non-null, this is an **update** — note existing URLs in the output.
+If `confluence.page` is non-null, this is an **update**  -  note existing URLs in the output.
 If `confluence.page` is null, this is a **first-time creation**.
 
 If IMPLEMENTATION_HISTORY.md, the Swift file, or FIGMA.md is missing:
@@ -123,10 +123,10 @@ Write `{confluencePath}/main.html` using the template below.
 | `{FILE_KEY}`, `{NODE_ID}` | From context |
 | `{SCREEN}`, `{SECTION}`, `{SIZE}` | From pass3/07 metadata |
 | `{OVERVIEW_TEXT}` | 2-3 sentence description from pass3/07 |
-| Testing Identifiers table | `registryData.testingIdentifiers` — columns: Element (usage), Key, Value |
-| Localization Keys table | `registryData.localizationKeys` — columns: Element, Key, Default |
-| Accessibility tables | `registryData.accessibilityKeys` — Labels + Hints |
-| Analytics Events | `registryData.analyticsEvents` — element + event (markdown text) |
+| Testing Identifiers table | `registryData.testingIdentifiers`  -  columns: Element (usage), Key, Value |
+| Localization Keys table | `registryData.localizationKeys`  -  columns: Element, Key, Default |
+| Accessibility tables | `registryData.accessibilityKeys`  -  Labels + Hints |
+| Analytics Events | `registryData.analyticsEvents`  -  element + event (markdown text) |
 | Sub-Components | From FIGMA.md nested components / pass3/03 |
 | Platform links | `{ComponentName} - iOS`, `{ComponentName} - Android` |
 | Changelog | Current date + "Initial documentation" |
@@ -266,11 +266,11 @@ Write `{confluencePath}/main.html` using the template below.
 **IMPORTANT:** Replace all template variables with actual data. Remove HTML comments. The output must be valid XHTML.
 
 **XHTML Attribute Escaping:** All dynamic text inserted into XML attribute values (`ri:filename`, `ri:content-title`) MUST have these characters escaped:
-- `&` → `&` (e.g., `Miles&Smiles` → `Miles&Smiles`)
+- `&` → `&` (e.g., `R&D Center` → `R&D Center`)
 - `"` → `"`
 - `<` → `&lt;`, `>` → `&gt;`
 
-Text inside `<![CDATA[...]]>` blocks does NOT need escaping. Text inside element content (between tags) needs `&` and `<` escaped. Filenames on disk keep the original characters — the XML parser decodes `&amp;` back to `&` when resolving attachment references.
+Text inside `<![CDATA[...]]>` blocks does NOT need escaping. Text inside element content (between tags) needs `&` and `<` escaped. Filenames on disk keep the original characters  -  the XML parser decodes `&amp;` back to `&` when resolving attachment references.
 
 ---
 
@@ -417,7 +417,7 @@ Write `{confluencePath}/ios.html` using the template below.
 <hr/>
 <!-- END IF analytics -->
 
-<!-- Code Connect section: SKIP — decoupled from Confluence. Lives in Figma Dev Mode. -->
+<!-- Code Connect section: SKIP  -  decoupled from Confluence. Lives in Figma Dev Mode. -->
 <!-- If a .figma.swift file exists, optionally show a one-line "Code Connect: Published" badge. -->
 <!-- Otherwise omit entirely. -->
 
@@ -443,7 +443,7 @@ Write `{confluencePath}/ios.html` using the template below.
 <td><ac:image ac:width="{SNAPSHOT_WIDTH}"><ri:attachment ri:filename="ios_dark_{variant}.png"/></ac:image></td>
 </tr>
 
-<!-- IF COMPLEX component — check dependencies from component's init: -->
+<!-- IF COMPLEX component  -  check dependencies from component's init: -->
 <!-- No closure deps: ComponentName().modifier(value) -->
 <!-- With closure dep (trailing): ComponentName { action() }.modifier(value) -->
 <!-- With non-closure dep: ComponentName(dep: value).modifier(value) -->
@@ -529,7 +529,7 @@ Write `{confluencePath}/ios.html` using the template below.
 </tbody></table>
 ```
 
-**IMPORTANT:** Replace all template variables. Remove HTML comments. Output valid XHTML. Include only sections that have data — skip empty sections entirely (don't show "No X" on the iOS page, just omit the section).
+**IMPORTANT:** Replace all template variables. Remove HTML comments. Output valid XHTML. Include only sections that have data  -  skip empty sections entirely (don't show "No X" on the iOS page, just omit the section).
 
 ---
 
@@ -547,16 +547,16 @@ The script outputs JSON with `status`, `violations`, `warnings`, and `stats`.
 
 ### What the script checks
 
-**main.html — Structure:**
+**main.html  -  Structure:**
 - Required sections: Variants, Overview, Testing Identifiers, Localization Keys, Accessibility, Analytics Events, Sub-Components, Platform Implementations, Changelog
 - Placeholder text accepted for empty sections (e.g., "No testing identifiers")
 
-**ios.html — Structure:**
+**ios.html  -  Structure:**
 - Required sections: Initializer, Usage, Changelog
 - Back-link to main page present
 - Snapshot Tests section present if snapshot assets exist
 
-**Both files — Integrity:**
+**Both files  -  Integrity:**
 - No unreplaced template variables (`{ComponentName}`, `{DESCRIPTION}`, etc.)
 - No remaining template comments (`<!-- IF`, `<!-- END`, `<!-- ELSE`)
 - No unescaped `&` in XML attributes (`ri:filename`, `ri:content-title`)
@@ -580,7 +580,7 @@ The script outputs JSON with `status`, `violations`, `warnings`, and `stats`.
 | `PASS` | Proceed to GATE 5 |
 | `FAIL` | Fix violations, re-generate XHTML, re-run validation |
 
-`warnings` are informational (orphan assets, unreferenced variant screenshots) — do NOT block.
+`warnings` are informational (orphan assets, unreferenced variant screenshots)  -  do NOT block.
 `violations` are failures that MUST be fixed before proceeding.
 
 ### On failure

package/pipeline/skills/figma-ios/figma-to-component/phases/phase-7a-wiki-generate.md

@@ -1,10 +1,10 @@
-# PHASE 7A — Wiki Documentation: Generate Markdown
+# PHASE 7A  -  Wiki Documentation: Generate Markdown
 
 Generate a single-file markdown documentation page for the wiki submodule.
 No VPN required. No Confluence knowledge needed.
 
 PREV: Phase 6 (Code Connect)
-NEXT: Phase 7B (inline — commit + push wiki repo)
+NEXT: Phase 7B (inline  -  commit + push wiki repo)
 TOOL RESTRICTIONS: No Edit
 
 > **No VPN needed.** This phase writes to the local wiki submodule. The orchestrator
@@ -19,7 +19,7 @@ Read: {artifactPath}/IMPLEMENTATION_HISTORY.md
 Read: {componentLocation}/{componentName}.swift
 Read: {componentLocation}/FIGMA.md
 Read: {artifactPath}/pass1/screenshot.png (verify exists)
-Read: {artifactPath}/pass1/screenshots/variants.md (if exists — variant property values)
+Read: {artifactPath}/pass1/screenshots/variants.md (if exists  -  variant property values)
 Read: {artifactPath}/pass3/07_implementation_spec.md
 Read: {artifactPath}/pass3/08_utility_integration.md
 Read: {artifactPath}/pass3/03_nested_components.md
@@ -110,7 +110,7 @@ Write `{wikiComponentPath}/{ComponentName}.md` using the template below.
 **All images use wiki syntax:** `[[/{wikiCategory}/{componentName}/assets/{filename}]]`
 
 > **CRITICAL:** GitHub Wiki `[[image.png|alt]]` syntax uses `|` for alt text.
-> Inside markdown tables, `|` is the column separator — so `[[image.png|alt]]` breaks the table.
+> Inside markdown tables, `|` is the column separator  -  so `[[image.png|alt]]` breaks the table.
 > **Rule:** NEVER use `|alt` in image links inside tables. Use `[[image.png]]` only.
 > Outside tables (e.g., the hero screenshot at top), `[[image.png|alt]]` is safe.
 
@@ -122,10 +122,10 @@ Write `{wikiComponentPath}/{ComponentName}.md` using the template below.
 | `{FILE_KEY}`, `{NODE_ID}` | From context |
 | `{SCREEN}`, `{SECTION}`, `{SIZE}` | From pass3/07 metadata |
 | `{OVERVIEW_TEXT}` | 2-3 sentence description from pass3/07 |
-| Testing Identifiers table | `registryData.testingIdentifiers` — columns: Element (usage), Key, Value |
-| Localization Keys table | `registryData.localizationKeys` — columns: Element, Key, Default |
-| Accessibility tables | `registryData.accessibilityKeys` — Labels + Hints |
-| Analytics Events | `registryData.analyticsEvents` — element + event description |
+| Testing Identifiers table | `registryData.testingIdentifiers`  -  columns: Element (usage), Key, Value |
+| Localization Keys table | `registryData.localizationKeys`  -  columns: Element, Key, Default |
+| Accessibility tables | `registryData.accessibilityKeys`  -  Labels + Hints |
+| Analytics Events | `registryData.analyticsEvents`  -  element + event description |
 | Sub-Components | From FIGMA.md nested components / pass3/03 |
 | Changelog | Current date + "Initial documentation" |
 
@@ -392,7 +392,7 @@ import UIComponents
 **IMPORTANT:**
 - Replace ALL template variables with actual data.
 - Remove ALL HTML comments (<!-- ... -->) from final output.
-- Include only sections that have data — skip empty optional sections entirely.
+- Include only sections that have data  -  skip empty optional sections entirely.
 - The `## iOS Implementation` heading is the split marker. Everything above is shared/cross-platform, everything from `## iOS Implementation` onward is iOS-specific. The standalone `/figma-to-swift-ui-confluence` skill uses this marker to split into two Confluence XHTML files.
 
 ---
@@ -412,7 +412,7 @@ The script outputs JSON with `status`, `violations`, `warnings`, and `stats`.
 
 ### What the script checks in wiki mode
 
-**{ComponentName}.md — Structure:**
+**{ComponentName}.md  -  Structure:**
 - Required sections: `## Overview`, `## Testing Identifiers`, `## Localization Keys`, `## Accessibility`, `## Analytics Events`, `## Sub-Components`, `## Platform Implementations`, `## Changelog`
 - `## iOS Implementation` marker present
 - Under iOS: `### Initializer`, `### Usage`, `### Snapshot Tests` (if snapshot assets exist)
@@ -465,9 +465,9 @@ Run the generator:
 python3 .instructions/figma/figma-to-swiftui/scripts/sidebar-generator.py --wiki-root {wikiRoot}
 ```
 
-This script scans `DesignSystemCore/`, `MobileAppComponents/`, and `VisualAssets/` folders, then produces a sorted, idempotent `_Sidebar.md`. Every run with the same directory state produces identical output — eliminating merge conflicts.
+This script scans `DesignSystemCore/`, `MobileAppComponents/`, and `VisualAssets/` folders, then produces a sorted, idempotent `_Sidebar.md`. Every run with the same directory state produces identical output  -  eliminating merge conflicts.
 
-**Post-validation (HARD GATE — must pass to proceed)**:
+**Post-validation (HARD GATE  -  must pass to proceed)**:
 ```bash
 grep -q '\[\[{ComponentName}\]\]' {wikiRoot}/_Sidebar.md
 ```
@@ -508,10 +508,10 @@ python3 .instructions/figma/figma-to-swiftui/scripts/phase7-finalize.py \
 
 | Result | Action |
 |--------|--------|
-| Exit 0, `"action": "updated"` | `status.ios.wiki` set green, `against = implemented.version` — proceed |
-| Exit 0, `"action": "already_current"` | Already marked against current implemented.version — proceed |
-| Exit 0, `"action": "created"` | New registry file created — proceed |
-| Exit 1 | HALT — registry update failed |
+| Exit 0, `"action": "updated"` | `status.ios.wiki` set green, `against = implemented.version`  -  proceed |
+| Exit 0, `"action": "already_current"` | Already marked against current implemented.version  -  proceed |
+| Exit 0, `"action": "created"` | New registry file created  -  proceed |
+| Exit 1 | HALT  -  registry update failed |
 
 **Why this matters:** This is the single source of truth for `status.ios.wiki`. The script records `against = status.ios.implemented.version` so the flag automatically drops to yellow on the next Phase 4 version bump until wiki pages are refreshed. `figma-iteration-commit` reads this and syncs the GitHub issue via `update-issue-from-registry.py`.
 

package/pipeline/skills/figma-ios/figma-to-component/phases/phase-8-cleanup.md

@@ -1,4 +1,4 @@
-# PHASE 8 — Cleanup
+# PHASE 8  -  Cleanup
 
 Remove generated artifacts that are no longer needed after upload, to avoid bloating the codebase.
 PREV: Phase 7B (Confluence Upload)
@@ -21,7 +21,7 @@ If `{artifactPath}/confluence/` exists AND Phase 7B is complete:
 
 Delete `{artifactPath}/confluence/` (the entire directory including `assets/`, `main.html`, `ios.html`).
 
-These are local XHTML generation artifacts. The content is live on Confluence — the local copy is only needed during Phase 7A generation and 7B upload.
+These are local XHTML generation artifacts. The content is live on Confluence  -  the local copy is only needed during Phase 7A generation and 7B upload.
 
 If confluence directory does not exist → skip (already cleaned or never generated locally).
 

package/pipeline/skills/figma-ios/figma-to-component/reference/accessibility.md

@@ -110,7 +110,7 @@ ContentView()
 // → "bookingsummary_screen_turkishbutton_button"
 ```
 
-VoiceOver labels (`.accessibilityLabel`) do NOT cascade — use SwiftUI's
+VoiceOver labels (`.accessibilityLabel`) do NOT cascade  -  use SwiftUI's
 built-in grouping (`.accessibilityElement(children: .combine)`).
 
 ---