@mmerterden/multi-agent-pipeline 11.1.0 → 11.3.0

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

@@ -1,155 +0,0 @@
-# Confluence XHTML Storage Format Reference
-
-Phase 7 generates Confluence pages in XHTML storage format (`representation: "storage"`).
-
----
-
-## Content Format
-
-Confluence storage format uses XHTML with Atlassian-specific `ac:` and `ri:` namespaces.
-
-```
-POST /rest/api/content
-{
-  "type": "page",
-  "title": "PageTitle",
-  "space": { "key": "DK" },
-  "body": {
-    "storage": {
-      "value": "<XHTML content here>",
-      "representation": "storage"
-    }
-  }
-}
-```
-
----
-
-## Creating Sub-Pages
-
-Add `ancestors` array to make a page a child of another:
-
-```json
-{
-  "type": "page",
-  "title": "ComponentName - iOS",
-  "ancestors": [{ "id": "PARENT_PAGE_ID" }],
-  "space": { "key": "DK" },
-  "body": {
-    "storage": {
-      "value": "<XHTML content>",
-      "representation": "storage"
-    }
-  }
-}
-```
-
----
-
-## XHTML Macros
-
-### Table of Contents
-
-```xml
-<ac:structured-macro ac:name="toc">
-<ac:parameter ac:name="printable">true</ac:parameter>
-<ac:parameter ac:name="style">disc</ac:parameter>
-<ac:parameter ac:name="maxLevel">2</ac:parameter>
-<ac:parameter ac:name="minLevel">2</ac:parameter>
-</ac:structured-macro>
-```
-
-### Code Block
-
-```xml
-<ac:structured-macro ac:name="code">
-<ac:parameter ac:name="language">java</ac:parameter>
-<ac:plain-text-body><![CDATA[code here]]></ac:plain-text-body>
-</ac:structured-macro>
-```
-
-**Language:** Use `java` for Swift code. Confluence does not support `swift`.
-
-### Image (Attachment)
-
-```xml
-<ac:image ac:width="375"><ri:attachment ri:filename="screenshot.png"/></ac:image>
-```
-
-### Internal Page Link
-
-```xml
-<ac:link><ri:page ri:content-title="PageTitle"/><ac:plain-text-link-body><![CDATA[Display Text]]></ac:plain-text-link-body></ac:link>
-```
-
-### External Link
-
-```xml
-<a href="https://example.com">Link Text</a>
-```
-
-### Note Callout
-
-```xml
-<ac:structured-macro ac:name="note">
-<ac:rich-text-body><p>Note text here</p></ac:rich-text-body>
-</ac:structured-macro>
-```
-
-### Warning Callout
-
-```xml
-<ac:structured-macro ac:name="warning">
-<ac:rich-text-body><p>Warning text here</p></ac:rich-text-body>
-</ac:structured-macro>
-```
-
----
-
-## Common Patterns
-
-### Table with Header Row
-
-```xml
-<table><tbody>
-<tr><th>Column 1</th><th>Column 2</th></tr>
-<tr><td>value</td><td>value</td></tr>
-</tbody></table>
-```
-
-### Inline Code
-
-```xml
-<code>UITestingIdentifierKey.ComponentName.element</code>
-```
-
-### Section Separator
-
-```xml
-<hr/>
-```
-
-### Italic / Bold / Line Break
-
-```xml
-<em>italic text</em>
-<strong>bold text</strong>
-<br/>
-```
-
----
-
-## Escaping Rules
-
-| Character | Escape |
-|-----------|--------|
-| `"` | `&quot;` |
-| `>` | `&gt;` |
-| `<` | `&lt;` |
-| `&` | `&amp;` |
-
-Inside `<![CDATA[...]]>` blocks, no escaping is needed.
-
----
-
-**Last Updated:** 2026-02-25

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

@@ -1,196 +0,0 @@
-# FIGMA/CSS TO SWIFTUI EFFECTS CONVERSION
-
-When translating Figma design properties (which use CSS conventions) to SwiftUI, several values require conversion. Figma's generated code (React+Tailwind) uses CSS units and conventions  -  these do NOT map 1:1 to SwiftUI.
-
-Source: [Matching drop shadows across CSS, Android, iOS, Figma, and Sketch](https://bjango.com/articles/matchingdropshadows/)
-
----
-
-## 1. SHADOWS
-
-### Drop Shadow (box-shadow → .shadow)
-
-Figma/CSS `box-shadow` and SwiftUI `.shadow()` use **different blur algorithms**. iOS uses double the standard deviation of CSS, so the same numeric blur value produces a visually larger blur in SwiftUI.
-
-**Conversion formula:**
-```
-SwiftUI radius = Figma blur / 2
-```
-
-| Figma/CSS | SwiftUI | Example |
-|-----------|---------|---------|
-| `box-shadow: 0px 0px 8px 0px rgba(0,0,0,0.5)` | `.shadow(color: .black.opacity(0.5), radius: 4, x: 0, y: 0)` | Blur 8 → radius 4 |
-| `box-shadow: 0px 4px 16px 0px rgba(0,0,0,0.25)` | `.shadow(color: .black.opacity(0.25), radius: 8, x: 0, y: 4)` | Blur 16 → radius 8 |
-| `box-shadow: 0px 2px 4px 0px rgba(0,0,0,0.1)` | `.shadow(color: .black.opacity(0.1), radius: 2, x: 0, y: 2)` | Blur 4 → radius 2 |
-
-**When using design tokens:**
-```swift
-// Token .Effects.effect8 = 8 (Figma blur value)
-// WRONG  -  passes Figma blur directly
-.shadow(radius: .Effects.effect8)
-
-// CORRECT  -  divide by 2 for SwiftUI
-.shadow(radius: .Effects.effect8 / 2)
-```
-
-### Shadow spread
-SwiftUI `.shadow()` has NO spread parameter. CSS `box-shadow` spread expands/contracts the shadow shape.
-
-**Workaround for positive spread:** Add a slightly larger background layer behind the view:
-```swift
-ZStack {
-    RoundedRectangle(cornerRadius: radius)
-        .fill(shadowColor)
-        .padding(-spread) // negative padding = expand
-        .blur(radius: blurRadius / 2)
-    content
-}
-```
-
-For zero spread (the common case), no workaround needed  -  just omit.
-
-### Inner Shadow
-CSS `box-shadow: inset ...` → SwiftUI has no built-in inner shadow.
-
-**Workaround:**
-```swift
-.overlay(
-    RoundedRectangle(cornerRadius: radius)
-        .stroke(Color.black.opacity(0.1), lineWidth: 1)
-        .blur(radius: blurRadius / 2)
-        .mask(RoundedRectangle(cornerRadius: radius))
-)
-```
-
----
-
-## 2. BLUR EFFECTS
-
-### Background blur (backdrop-filter → .blur)
-```
-SwiftUI blur radius = CSS blur radius / 2
-```
-
-Same conversion factor as shadows  -  iOS uses double the standard deviation.
-
-```swift
-// Figma: backdrop-filter: blur(20px)
-.blur(radius: 10)
-```
-
-### Layer blur (filter: blur → .blur)
-Same conversion:
-```swift
-// Figma: filter: blur(8px)
-.blur(radius: 4)
-```
-
----
-
-## 3. OPACITY
-
-Opacity maps 1:1  -  no conversion needed.
-
-```swift
-// Figma: opacity: 0.5
-.opacity(0.5)
-```
-
-For color opacity (e.g., `rgba(0,0,0,0.5)`):
-```swift
-Color.black.opacity(0.5)
-```
-
-When using design tokens like `Color.Opacity.Black.opacity50`, verify the token already encodes the correct alpha  -  don't double-apply.
-
----
-
-## 4. BORDER / STROKE
-
-### Border width
-Maps 1:1, no conversion.
-
-```swift
-// Figma: border: 1px solid #color
-.overlay(
-    RoundedRectangle(cornerRadius: .Radius.radius8)
-        .stroke(Color.Border.borderSubtle, lineWidth: 1)
-)
-```
-
-### Border radius / Corner radius
-Maps 1:1 between Figma and SwiftUI.
-
-```swift
-// Figma: border-radius: 12px → token Radius/Radius12
-.clipShape(RoundedRectangle(cornerRadius: .Radius.radius12))
-// or
-.cornerRadius(.Radius.radius12)
-```
-
----
-
-## 5. GRADIENTS
-
-### Linear gradient
-Figma angle convention differs from SwiftUI:
-- Figma: 0° = top-to-bottom, 90° = left-to-right
-- SwiftUI: Uses `UnitPoint` start/end, not angles
-
-| Figma Angle | SwiftUI Start → End |
-|-------------|---------------------|
-| 0° | `.top` → `.bottom` |
-| 90° | `.leading` → `.trailing` |
-| 180° | `.bottom` → `.top` |
-| 270° | `.trailing` → `.leading` |
-| 45° | `.topLeading` → `.bottomTrailing` |
-
-```swift
-// Figma: linear-gradient(180deg, #000 0%, transparent 100%)
-LinearGradient(
-    colors: [.black, .clear],
-    startPoint: .bottom,
-    endPoint: .top
-)
-```
-
----
-
-## 6. TRANSITIONS / ANIMATIONS
-
-Figma prototype transitions don't export via API. Common Figma Smart Animate defaults:
-
-| Figma Setting | SwiftUI Equivalent |
-|---------------|-------------------|
-| Smart Animate, 300ms, Ease In And Out | `.animation(.easeInOut(duration: 0.3), value: state)` |
-| Smart Animate, 200ms, Ease Out | `.animation(.easeOut(duration: 0.2), value: state)` |
-| Dissolve, 300ms | `.transition(.opacity)` with `.animation(.easeInOut(duration: 0.3))` |
-| Move In/Out | `.transition(.move(edge: .bottom))` |
-
-### TimelineView for frame-based animations
-When Figma shows a component cycling between variant states (e.g., QR code glow pulse):
-```swift
-TimelineView(.periodic(from: .now, by: interval)) { context in
-    let state = deriveState(from: context.date)
-    content(for: state)
-        .animation(.easeInOut(duration: transitionDuration), value: state)
-}
-```
-Derive state from the timeline date  -  do NOT mutate `@State` inside the TimelineView closure.
-
----
-
-## QUICK REFERENCE TABLE
-
-| Property | Figma/CSS Value | SwiftUI Value | Conversion |
-|----------|----------------|---------------|------------|
-| Shadow blur | `8px` | `radius: 4` | ÷ 2 |
-| Shadow x/y offset | `4px` | `x: 4, y: 4` | 1:1 |
-| Shadow spread | `2px` | N/A | Workaround needed |
-| Shadow color | `rgba(0,0,0,0.5)` | `.black.opacity(0.5)` | 1:1 |
-| Blur | `20px` | `radius: 10` | ÷ 2 |
-| Opacity | `0.5` | `.opacity(0.5)` | 1:1 |
-| Border width | `1px` | `lineWidth: 1` | 1:1 |
-| Corner radius | `12px` | `.Radius.radius12` | 1:1 |
-| Gradient angle | CSS degrees | UnitPoint | See table |
-| Animation duration | ms | seconds | ÷ 1000 |

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

@@ -1,57 +0,0 @@
-# RETURN PROTOCOL
-
-When you complete this phase, output EXACTLY one of these blocks as your FINAL message.
-
----
-
-## On success:
-
-```
-STATUS: COMPLETE
-PHASE: phase-{N}
-GATES_PASSED: [list every gate ID that passed]
-ARTIFACTS_CREATED:
-  - {path}
-  - {path}
-SUMMARY: {one-line description of what was accomplished}
-```
-
-## On failure (tool error, missing file, validation fail):
-
-```
-STATUS: HALT
-PHASE: phase-{N}
-GATE: {gate-id that failed}
-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}
-```
-
-## On decision needed (user choice required):
-
-```
-STATUS: NEEDS_INPUT
-PHASE: phase-{N}
-GATE: {gate-id where decision is needed}
-QUESTION: {what needs to be decided}
-OPTIONS:
-  1) {choice}
-  2) {choice}
-  3) {choice}
-SUGGESTED: {your recommendation and why}
-COMPLETED_GATES: [gates passed so far]
-CONTEXT: {relevant data the user needs to make the decision}
-```
-
----
-
-## Rules
-
-1. Output EXACTLY ONE block as your FINAL message.
-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.
-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/reference/localization-naming.md

@@ -1,89 +0,0 @@
-# LOCALIZATION KEY NAMING
-
-Naming rules for UIComponents localization keys.
-
----
-
-## Format
-
-```
-<ComponentName>.<Element>
-```
-
----
-
-## Rules
-
-- PascalCase segments, dots as separators, max 5 levels
-- No suffix like `.Label`, `.Text`, `.Title` unless disambiguation needed
-
-| Suffix Needed | Example |
-|---------------|---------|
-| Same element, different contexts | `Packages.Economy.Title`, `Packages.Economy.Description` |
-| Action vs display | `Packages.Submit.Button`, `Packages.Submit.Confirmation` |
-
-| No Suffix Needed | Example |
-|------------------|---------|
-| Single text per element | `Packages.Ecofly` |
-| Context clear from hierarchy | `Packages.Upgraded` |
-
----
-
-## Text Extraction Rules
-
-### 1. Pattern Detection
-
-| Pattern | Detection | Action |
-|---------|-----------|--------|
-| Static text | Same text across variants | Single key, static value |
-| Dynamic placeholder | Single character varies (A, B, K, Y) | Format key with `%@` or `%1$@` |
-| Repeated structure | `{Type}, {Class} Sinifi` | Combined format key |
-
-### 2. Domain Context Deduction
-
-| Domain | Pattern | Enum |
-|--------|---------|------|
-| Booking class | Single letter (K, Y, J, C, B...) | `BookingClassCode` |
-| Cabin class | Economy, Business | `CabinClass` |
-| Package type | Ecofly, Extrafly, Primefly... | `PackageType` |
-
-### 3. Format Keys (dynamic parts)
-
-```
-Figma: "Ecofly, K Sinifi" (K varies)
-Key: Packages.PackageWithClass
-Value (TR): %1$@, %2$@ Sinifi
-Value (EN): %1$@, Class %2$@
-Runtime: String(format: key, "Ecofly", "K")
-```
-
-### 4. Static Keys (fixed text)
-
-```
-Figma: "Yukseltildi"
-Key: Packages.Upgraded
-Value: Yukseltildi / Upgraded
-```
-
-### 5. One key per unique pattern, shared texts get single key
-
----
-
-## Key Structure
-
-| Type | Format | Example |
-|------|--------|---------|
-| Simple | `Component.Element` | `Packages.Upgraded` |
-| With variants | `Component.VariantValue` | `Packages.Ecofly` |
-| Nested | `Component.Section.Element` | `FlightCard.Header.Title` |
-| Disambiguation | `Component.Element.Context` | `Booking.Date.Departure` |
-
----
-
-## Validation
-
-1. Key follows PascalCase.Dot.Notation
-2. No unnecessary suffixes
-3. Complete display-ready text (no concatenation)
-4. Unique key for each unique text
-5. Shared texts use single key