@mmerterden/multi-agent-pipeline 11.2.0 → 11.3.0

package/pipeline/scripts/smoke-figma-cross-cli-inventory.sh

@@ -1,177 +0,0 @@
-#!/usr/bin/env bash
-# smoke-figma-cross-cli-inventory.sh  -  enforces the cross-CLI parity
-# inventory for the v5.0.0 figma-to-component skill set.
-#
-# Source-tree assertions (does not require install.js to have deployed
-# the skills). Complements smoke-cross-cli-behavior.sh (installed-tree)
-# and smoke-commands-skills-parity.sh (multi-agent commands).
-#
-# Contract source of truth: refs/cross-cli-contract.md section1.1.
-#
-# Verifies:
-#   1. Every platform-specific figma-android skill exists in figma-ios too.
-#   2. Every required figma-* skill from the contract table exists in figma-ios.
-#   3. Every SKILL.md that claims "platform: android" lives under figma-android/.
-#   4. Every SKILL.md that claims "platform: ios" lives under figma-ios/.
-#   5. No orphaned figma skill directories (not in the contract).
-#   6. Contract doc references both figma-ios and figma-android paths.
-
-set -euo pipefail
-
-HERE="$(cd "$(dirname "$0")" && pwd)"
-ROOT="$(cd "$HERE/../.." && pwd)"
-IOS_DIR="$ROOT/pipeline/skills/figma-ios"
-ANDROID_DIR="$ROOT/pipeline/skills/figma-android"
-COMMON_DIR="$ROOT/pipeline/skills/figma-common"
-CONTRACT="$ROOT/pipeline/commands/multi-agent/refs/cross-cli-contract.md"
-
-PASS=0
-FAIL=0
-pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
-fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
-
-for d in "$IOS_DIR" "$ANDROID_DIR" "$COMMON_DIR"; do
-  [ -d "$d" ] || { echo "error: $d missing" >&2; exit 1; }
-done
-[ -f "$CONTRACT" ] || { echo "error: $CONTRACT missing" >&2; exit 1; }
-
-# Platform-specific skills (required on BOTH sides per contract)
-PLATFORM_SPECIFIC=(
-  figma-to-component
-  figma-component-implement
-  figma-component-test
-  figma-component-code-connect
-  figma-component-wiki
-)
-
-# Platform-agnostic (required on at least iOS side today  -  WS-7b moves to figma-common/)
-COMMON_REQUIRED=(
-  figma-component-start
-  figma-component-confluence-sync
-  figma-component-status-update
-  figma-commit
-  figma-iteration-commit
-  figma-issue
-  figma-iterate
-  figma-cli-iterate
-  figma-cli-lean-iterate
-  figma-cli-iterate-mend
-  figma-cli-skip
-  figma-fix
-  figma-mend
-  figma-review
-  figma-validate
-  figma-setup
-  figma-remote-mcp-auth
-  figma-ui-patterns
-  figma-utility
-  figma-skip
-  figma-form-integration
-  figma-price-integration
-)
-
-echo "→ 1. Platform-specific skills exist on BOTH figma-ios and figma-android"
-for skill in "${PLATFORM_SPECIFIC[@]}"; do
-  ios_ok="false"
-  and_ok="false"
-  [ -f "$IOS_DIR/$skill/SKILL.md" ] && ios_ok="true"
-  [ -f "$ANDROID_DIR/$skill/SKILL.md" ] && and_ok="true"
-  if [ "$ios_ok" = "true" ] && [ "$and_ok" = "true" ]; then
-    pass "$skill present on both platforms"
-  else
-    fail "$skill parity broken (ios=$ios_ok android=$and_ok)"
-  fi
-done
-
-echo ""
-echo "→ 2. Platform-agnostic skills live in figma-common/ (WS-7b ✓)"
-for skill in "${COMMON_REQUIRED[@]}"; do
-  if [ -f "$COMMON_DIR/$skill/SKILL.md" ]; then
-    pass "$skill present in figma-common"
-  else
-    fail "$skill missing in figma-common"
-  fi
-done
-
-echo ""
-echo "→ 2b. Platform-agnostic skills are NOT duplicated under figma-ios"
-DUPES=0
-for skill in "${COMMON_REQUIRED[@]}"; do
-  if [ -d "$IOS_DIR/$skill" ]; then
-    fail "duplication: $skill exists in BOTH figma-ios/ and figma-common/"
-    DUPES=$((DUPES+1))
-  fi
-done
-[ "$DUPES" -eq 0 ] && pass "no common-skill duplication in figma-ios"
-
-echo ""
-echo "→ 3. figma-android SKILL.md files stamp platform: android"
-while IFS= read -r -d '' f; do
-  base=$(dirname "$f" | xargs basename)
-  if head -n 1 "$f" | grep -Fxq -- "---"; then
-    if awk '/^---$/{c++; next} c==1' "$f" | grep -Fq "platform: android"; then
-      pass "$base stamps platform: android"
-    else
-      fail "$base missing 'platform: android' stamp"
-    fi
-  fi
-done < <(find "$ANDROID_DIR" -maxdepth 2 -name SKILL.md -print0)
-
-echo ""
-echo "→ 4. figma-ios SKILL.md files do NOT claim platform: android (only ios or none)"
-while IFS= read -r -d '' f; do
-  if awk '/^---$/{c++; next} c==1' "$f" | grep -Fq "platform: android"; then
-    fail "$(dirname "$f" | xargs basename) claims platform: android but lives under figma-ios/"
-  fi
-done < <(find "$IOS_DIR" -maxdepth 2 -name SKILL.md -print0)
-pass "no cross-platform stamp leakage in figma-ios/"
-
-echo ""
-echo "→ 5. No orphaned figma-android directories (contract-table inventory)"
-EXPECTED_ANDROID=("${PLATFORM_SPECIFIC[@]}")
-ORPHANS=0
-for d in "$ANDROID_DIR"/*/; do
-  [ -d "$d" ] || continue
-  name=$(basename "$d")
-  case " ${EXPECTED_ANDROID[*]} " in
-    *" $name "*) ;;
-    *) fail "unexpected dir: figma-android/$name (not in contract)"; ORPHANS=$((ORPHANS+1)) ;;
-  esac
-done
-[ "$ORPHANS" -eq 0 ] && pass "no orphaned figma-android directories"
-
-echo ""
-echo "→ 6. cross-cli-contract.md references both platforms"
-if grep -Fq "pipeline/skills/figma-ios" "$CONTRACT" && grep -Fq "pipeline/skills/figma-android" "$CONTRACT"; then
-  pass "contract references figma-ios + figma-android paths"
-else
-  fail "contract missing one or both figma platform paths"
-fi
-
-echo ""
-echo "→ 7. Contract section 1.1 present (figma subphase skills section)"
-if grep -Fq "1.1 Figma component subphase skills" "$CONTRACT"; then
-  pass "section 1.1 heading present"
-else
-  fail "section 1.1 heading missing"
-fi
-
-echo ""
-echo "→ 8. Contract section 1.2 routing rules present"
-if grep -Fq "1.2 Figma-skill routing from multi-agent" "$CONTRACT"; then
-  pass "section 1.2 heading present"
-else
-  fail "section 1.2 heading missing"
-fi
-
-echo ""
-echo "→ 9. Contract section 1.3 frontmatter requirements present"
-if grep -Fq "1.3 Figma skill frontmatter" "$CONTRACT"; then
-  pass "section 1.3 heading present"
-else
-  fail "section 1.3 heading missing"
-fi
-
-echo ""
-echo "══ figma-cross-cli-inventory smoke: $PASS passed, $FAIL failed ══"
-[ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-figma-sync.sh

@@ -1,149 +0,0 @@
-#!/usr/bin/env bash
-# smoke-figma-sync.sh  -  WS-9 contract for sync-figma-source.sh.
-#
-# Verifies:
-#   1. sync script exists + executable.
-#   2. prefs.schema.json declares global.figmaSource with correct shape.
-#   3. sync script handles missing figmaSource gracefully (exit 0 w/ message).
-#   4. sync script handles missing path file.
-#   5. dry-run mode writes nothing.
-#   6. CHANGELOG note format is correct (includes `### Sync YYYY-MM-DD`).
-#   7. Watermark update logic (lastCommit + lastSyncedAt) runs atomically.
-
-set -euo pipefail
-
-HERE="$(cd "$(dirname "$0")" && pwd)"
-ROOT="$(cd "$HERE/../.." && pwd)"
-SYNC="$ROOT/pipeline/scripts/sync-figma-source.sh"
-SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
-TMP="$(mktemp -d -t figma-sync-smoke-XXXX)"
-trap 'rm -rf "$TMP"' EXIT
-
-PASS=0
-FAIL=0
-pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
-fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
-
-need() { command -v "$1" >/dev/null 2>&1 || { echo "error: $1 required" >&2; exit 127; }; }
-need jq
-need git
-
-[ -x "$SYNC" ] && pass "sync script exists and is executable" || fail "sync script not executable at $SYNC"
-
-echo ""
-echo "→ 2. prefs schema declares global.figmaSource with correct shape"
-for field in path branch lastSyncedAt lastCommit; do
-  if jq -e ".properties.global.properties.figmaSource.properties.$field" "$SCHEMA" >/dev/null 2>&1; then
-    pass "figmaSource.$field declared"
-  else
-    fail "figmaSource.$field missing from schema"
-  fi
-done
-
-echo ""
-echo "→ 3. missing figmaSource → exit 0 with skip message"
-cat > "$TMP/prefs-no-source.json" <<'EOF'
-{ "schemaVersion": "2.1.0", "global": {}, "projects": {} }
-EOF
-OUT=$(MULTI_AGENT_PREFS="$TMP/prefs-no-source.json" bash "$SYNC" 2>&1)
-RC=$?
-if [ "$RC" -eq 0 ] && echo "$OUT" | grep -Fq "figmaSource not configured"; then
-  pass "gracefully handles missing figmaSource"
-else
-  fail "did not skip cleanly (rc=$RC, out: $OUT)"
-fi
-
-echo ""
-echo "→ 4. figmaSource.path missing on disk → exit 1 with error"
-cat > "$TMP/prefs-bad-path.json" <<EOF
-{ "schemaVersion": "2.1.0", "global": { "figmaSource": { "path": "$TMP/does-not-exist", "branch": "develop" } }, "projects": {} }
-EOF
-set +e
-OUT=$(MULTI_AGENT_PREFS="$TMP/prefs-bad-path.json" bash "$SYNC" 2>&1)
-RC=$?
-set -e
-if [ "$RC" -ne 0 ] && echo "$OUT" | grep -Fq "does not exist"; then
-  pass "errors cleanly on missing path"
-else
-  fail "did not error on missing path (rc=$RC)"
-fi
-
-echo ""
-echo "→ 5. dry-run mode does not mutate prefs"
-# Build a tiny fake source with .instructions/figma/sample/SKILL.md
-FAKE_SRC="$TMP/fake-src"
-mkdir -p "$FAKE_SRC/.instructions/figma/sample" "$FAKE_SRC/.claude/skills/sample"
-cat > "$FAKE_SRC/.instructions/figma/sample/SKILL.md" <<'EOF'
----
-name: sample
-description: smoke fixture
----
-# sample
-EOF
-cat > "$FAKE_SRC/.claude/skills/sample/SKILL.md" <<'EOF'
----
-name: sample
-description: smoke stub
----
-# sample stub
-EOF
-(cd "$FAKE_SRC" && git init -q && git -c user.email=t@t -c user.name=t add . && git -c user.email=t@t -c user.name=t commit -q -m init)
-PREFS_BEFORE="$TMP/prefs-dry.json"
-cat > "$PREFS_BEFORE" <<EOF
-{ "schemaVersion": "2.1.0", "global": { "figmaSource": { "path": "$FAKE_SRC", "branch": "main" } }, "projects": {} }
-EOF
-CHECKSUM_BEFORE=$(jq -c '.' "$PREFS_BEFORE" | shasum | awk '{print $1}')
-MULTI_AGENT_PREFS="$PREFS_BEFORE" bash "$SYNC" --dry-run >/dev/null 2>&1 || true
-CHECKSUM_AFTER=$(jq -c '.' "$PREFS_BEFORE" | shasum | awk '{print $1}')
-[ "$CHECKSUM_BEFORE" = "$CHECKSUM_AFTER" ] && pass "dry-run leaves prefs untouched" || fail "dry-run mutated prefs"
-
-echo ""
-echo "→ 6. CHANGELOG heading pattern used by sync (grep shape)"
-if grep -Fq '### Sync $(date' "$SYNC" || grep -Eq '### Sync \$\(date' "$SYNC"; then
-  pass "sync emits '### Sync YYYY-MM-DD' heading"
-else
-  fail "sync script does not emit the canonical CHANGELOG heading"
-fi
-
-echo ""
-echo "→ 7. Watermark update uses atomic rename"
-if grep -Fq "mv \"\$TMP\" \"\$PREFS_FILE\"" "$SYNC"; then
-  pass "atomic rename on prefs update"
-else
-  fail "no atomic rename in sync script"
-fi
-
-echo ""
-echo "→ 8. --force-full flag is recognised"
-if grep -Fq -- "--force-full" "$SYNC"; then
-  pass "force-full flag supported"
-else
-  fail "force-full flag missing"
-fi
-
-echo ""
-echo "→ 9. --plan flag writes a structured JSON plan artifact"
-if grep -Fq -- "--plan" "$SYNC"; then
-  pass "plan flag recognised"
-else
-  fail "plan flag missing"
-fi
-if grep -Fq ".last-figma-sync-plan.json" "$SYNC"; then
-  pass "plan writes to .last-figma-sync-plan.json"
-else
-  fail "plan output path missing"
-fi
-if grep -Fq "overlaySkip" "$SYNC"; then
-  pass "plan records overlay-skip per skill"
-else
-  fail "plan does not record overlaySkip"
-fi
-if grep -Fq "tree" "$SYNC" && grep -Fq "figma-ios" "$SYNC" && grep -Fq "figma-common" "$SYNC"; then
-  pass "plan records destination tree (figma-ios vs figma-common)"
-else
-  fail "plan missing tree routing info"
-fi
-
-echo ""
-echo "══ figma-sync smoke: $PASS passed, $FAIL failed ══"
-[ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-sync-delegation.sh

@@ -1,74 +0,0 @@
-#!/usr/bin/env bash
-# smoke-sync-delegation.sh  -  WS-9b contract.
-#
-# Verifies /multi-agent:sync (sync.md) documents the Step 0 delegation
-# to sync-figma-source.sh when figmaSource is configured.
-
-set -euo pipefail
-
-HERE="$(cd "$(dirname "$0")" && pwd)"
-ROOT="$(cd "$HERE/../.." && pwd)"
-SYNC_DOC="$ROOT/pipeline/commands/multi-agent/sync.md"
-SYNC_SCRIPT="$ROOT/pipeline/scripts/sync-figma-source.sh"
-
-PASS=0
-FAIL=0
-pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
-fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
-
-[ -f "$SYNC_DOC" ] || { echo "error: sync.md missing" >&2; exit 1; }
-[ -x "$SYNC_SCRIPT" ] || { echo "error: sync-figma-source.sh missing or not executable" >&2; exit 1; }
-
-echo "→ 1. sync.md lists figma source as Step 0"
-if grep -Fq "Step 0: FIGMA_SYNC" "$SYNC_DOC" || grep -Fq "FIGMA_SYNC" "$SYNC_DOC"; then
-  pass "Step 0 entry present"
-else
-  fail "Step 0 FIGMA_SYNC entry missing"
-fi
-
-echo ""
-echo "→ 2. sync.md references sync-figma-source.sh by path"
-if grep -Fq "pipeline/scripts/sync-figma-source.sh" "$SYNC_DOC"; then
-  pass "sync script path referenced"
-else
-  fail "sync script path missing from sync.md"
-fi
-
-echo ""
-echo "→ 3. sync.md documents the figmaSource preference gate"
-if grep -Fq "figmaSource.path" "$SYNC_DOC" || grep -Fq "figmaSource" "$SYNC_DOC"; then
-  pass "figmaSource pref gate documented"
-else
-  fail "figmaSource pref gate missing"
-fi
-
-echo ""
-echo "→ 4. sync.md notes skip behavior when figmaSource unset"
-if grep -qi "skip" "$SYNC_DOC" && grep -Fq "figmaSource" "$SYNC_DOC"; then
-  pass "skip-when-unset documented"
-else
-  fail "skip behavior not documented"
-fi
-
-echo ""
-echo "→ 5. sync.md mentions local-overlay marker (preservation)"
-if grep -Fq "local-overlay" "$SYNC_DOC"; then
-  pass "local-overlay preservation documented"
-else
-  fail "local-overlay preservation missing"
-fi
-
-echo ""
-echo "→ 6. sync.md puts FIGMA_SYNC BEFORE Step 1 (DETECT)"
-# Regex: FIGMA_SYNC line must appear before DETECT line
-FIGMA_LINE=$(grep -n "FIGMA_SYNC" "$SYNC_DOC" | head -1 | cut -d: -f1)
-DETECT_LINE=$(grep -nE "Step 1(\.[0-9]+)?: DETECT" "$SYNC_DOC" | head -1 | cut -d: -f1)
-if [ -n "$FIGMA_LINE" ] && [ -n "$DETECT_LINE" ] && [ "$FIGMA_LINE" -lt "$DETECT_LINE" ]; then
-  pass "FIGMA_SYNC precedes DETECT in step order"
-else
-  fail "FIGMA_SYNC must precede DETECT (got FIGMA=$FIGMA_LINE DETECT=$DETECT_LINE)"
-fi
-
-echo ""
-echo "══ sync-delegation smoke: $PASS passed, $FAIL failed ══"
-[ "$FAIL" -eq 0 ]

package/pipeline/skills/figma-android/README.md

@@ -1,38 +0,0 @@
-# figma-android  -  Android Platform Skills
-
-Platform peer to `pipeline/skills/figma-ios/`.
-
-## What lives here
-
-Platform-specific skills for generating Jetpack Compose components from Figma designs:
-
-| Skill | Subphase | Sibling in figma-ios |
-|---|---|---|
-| `figma-to-component` | Orchestrator (3.0 - 3.8) | `figma-ios/figma-to-component` |
-| `figma-component-implement` | 3.4 (code gen: Compose) | `figma-ios/figma-component-implement` |
-| `figma-component-test` | 3.5 (Compose Testing + Paparazzi) | `figma-ios/figma-component-test` |
-| `figma-component-code-connect` | 3.6 (Code Connect for Compose) | `figma-ios/figma-component-code-connect` |
-| `figma-component-wiki` | 3.7 (wiki  -  platform-aware rendering) | `figma-ios/figma-component-wiki` |
-
-## What's NOT here (yet)
-
-The platform-**agnostic** skills  -  `figma-commit`, `figma-iterate`, `figma-issue`, `figma-review`, `figma-setup`, `figma-validate`, `figma-utility`, `figma-fix`, `figma-mend`, `figma-evolve-component`, `figma-ui-patterns`, `figma-form-integration`, `figma-price-integration`, `figma-navigation`, `figma-overlays`, `figma-bottom-sheets`, `figma-remote-mcp-auth`, `figma-cli-*`, `performance-*`, etc.  -  live under [`pipeline/skills/figma-common/`](../figma-common/) (WS-7b ✓). Both iOS and Android orchestrators dispatch there without duplication.
-
-The cross-cutting **integration adapters** (`figma-form-integration`, `figma-price-integration`, `figma-navigation`, `figma-overlays`, `figma-bottom-sheets`) carry both an iOS (SwiftUI) and an Android (Jetpack Compose) section  -  the Android orchestrator uses the Compose section; the same emit-intent / caller-owns rules and the `figma-config` `ui.*` hooks apply on both platforms.
-
-## Routing
-
-Multi-agent Phase 3 reads `figmaConfig.project.platform`:
-
-- `"ios"` → dispatches to `figma-ios/figma-to-component`
-- `"android"` → dispatches to `figma-android/figma-to-component` (this directory)
-
-See `pipeline/commands/multi-agent/refs/component-dispatch.md` for the full contract.
-
-## Build target
-
-Android orchestrator expects `figmaConfig.build.gradleModule` to be set (e.g. `:components:button`). Missing → halt with a clear error. See `pipeline/schemas/figma-project-config.schema.json` v2.0.0 for the full `build` shape.
-
-## Status
-
-All five skills stamped `status: wip-v5`  -  contracts + skeleton in place, not yet validated against a real Android project. Fill in the reference implementation detail as a downstream integration lands (follow-up issues will be opened per skill).

package/pipeline/skills/figma-android/figma-component-code-connect/SKILL.md

@@ -1,62 +0,0 @@
----
-name: figma-component-code-connect
-description: Generate Code Connect for Compose mappings  -  {Name}.figma.kt registers the composable with Figma's Code Connect so designers see live code snippets for each variant. Android peer to pipeline/skills/figma-ios/figma-component-code-connect.
-user-invocable: true
-argument-hint: <component-name>
-allowed-tools: Read, Write, Edit, Glob, Grep, Bash
-status: wip-v5
-sourced-from: derived-from/figma-ios/figma-component-code-connect
-platform: android
----
-
-# figma-component-code-connect  -  Code Connect for Compose
-
-> **WS-7 v5.0.0**  -  Subphase 3.6 for Android. Generates `{Name}.figma.kt` so Figma's Dev Mode shows Compose usage for every variant of the component, classified by the Figma variant properties read in subphase 3.1.
-
-## Output
-
-`{Name}.figma.kt` beside the composable:
-
-```kotlin
-@FigmaConnect("https://www.figma.com/design/abc/?node-id=123-456")
-class ButtonPrimaryFigmaConnect {
-    @FigmaProperty.Boolean("Enabled") var enabled: Boolean = true
-    @FigmaProperty.Enum("Style", mapping = [
-        "Primary"   to ButtonStyle.Primary,
-        "Secondary" to ButtonStyle.Secondary,
-        "Ghost"     to ButtonStyle.Ghost,
-    ])
-    var style: ButtonStyle = ButtonStyle.Primary
-
-    @FigmaProperty.Text("Title") var title: String = ""
-
-    @Composable
-    fun Example() {
-        ButtonPrimary(
-            ButtonPrimaryConfiguration()
-                .title(title)
-                .style(style)
-                .enabled(enabled)
-        )
-    }
-}
-```
-
-Variant property names come from the Figma node (fetched in 3.1). Mapping tables translate Figma's "Primary"/"Secondary" strings to the Compose `ButtonStyle` enum.
-
-## Publish
-
-```bash
-figma code-connect publish --type kotlin --dir ${module-path}
-```
-
-Requires `figma-cli` with a valid PAT (resolved via `keychainMapping.figma`). Token missing → Token Save Flow. Publish failure → halt + error.
-
-## Failure handling
-
-- Figma property does not map cleanly to an enum → halt with an actionable message listing the unmapped variants; no partial publish.
-- Composable signature changed between 3.4 and 3.6 → auto-fix the `Example()` body from the current Configuration.
-
-## Cross-CLI parity
-
-iOS and Android Code Connect skills emit identical progress lines, publish via the same `figma code-connect publish` CLI, and halt on variant mapping ambiguity the same way. `smoke-figma-android-parity.sh` asserts skill inventory match.

package/pipeline/skills/figma-android/figma-component-implement/SKILL.md

@@ -1,158 +0,0 @@
----
-name: figma-component-implement
-description: Generate a Jetpack Compose component (Configuration data class + Composable + Modifier extensions + Preview + README) from gathered Figma data. Android peer to pipeline/skills/figma-ios/figma-component-implement.
-user-invocable: true
-argument-hint: <figma-url> | <component-name>
-allowed-tools: Read, Write, Edit, Glob, Grep, Bash
-status: wip-v5
-sourced-from: derived-from/figma-ios/figma-component-implement
-platform: android
----
-
-# figma-component-implement  -  Compose Code Generation
-
-> **WS-7 v5.0.0**  -  Called by the Android `figma-to-component` orchestrator during subphase 3.4. Reads `agent-state.json.phases["3"].subphases["3.1-gather"]` for the fetched Figma tree + token map and writes Kotlin + Compose artefacts.
-
-## Inputs
-
-```
-{
-  componentName:    "ButtonPrimary",             // PascalCase from registry
-  componentPath:    "components/Button/ButtonPrimary",
-  figmaTree:        <node object>,               // from 3.1-gather
-  tokenMap:         <Figma → token symbol map>,  // from 3.3-token-mapping
-  testingIds:       <semantic IDs>,              // from 3.2a
-  localization:     <strings map>,               // from 3.2b
-  accessibility:    <a11y metadata>,             // from 3.2c
-  analytics:        <events>,                    // from 3.2d
-  figmaConfig:      <figma-project-config v2.0.0>,
-  agentState:       <path>,                      // for progress emission + subphase record
-  dev:              boolean                      // --dev elides some steps (see below)
-}
-```
-
-## Outputs
-
-Four Kotlin files beside the component's package, plus a README:
-
-### 1. `{Name}Configuration.kt`
-
-Pure data class. Every variable knob lives here  -  the composable itself holds no state beyond its `Configuration` parameter. Marked `@Immutable` so Compose can skip recomposition when the instance is `equals`:
-
-```kotlin
-@Immutable
-data class ButtonPrimaryConfiguration(
-    val title: String = "",
-    val style: ButtonStyle = ButtonStyle.Primary,
-    val isEnabled: Boolean = true,
-    val onClick: () -> Unit = {}
-) {
-    enum class ButtonStyle { Primary, Secondary, Ghost }
-}
-```
-
-Rules:
-
-- `@Immutable` OR `@Stable`  -  never raw. `@Immutable` when all properties are primitives / immutable; `@Stable` when you guarantee structural stability.
-- Default values for every property so call sites can use `copy()` idiomatically (fluent-API equivalent).
-- Callbacks typed as named function types (`val onClick: () -> Unit = {}`)  -  never `Any?`.
-- Enums inside the Configuration's companion or nested scope  -  mirrors SwiftUI Configuration style.
-
-### 2. `{Name}.kt` (the composable)
-
-```kotlin
-@Composable
-fun ButtonPrimary(
-    configuration: ButtonPrimaryConfiguration,
-    modifier: Modifier = Modifier,
-) {
-    val shape = MaterialTheme.customShapes.mediumRadius
-    Surface(
-        modifier = modifier.semantics {
-            testTag = TestingIdentifiers.buttonPrimary
-            contentDescription = stringResource(R.string.btn_primary_a11y)
-        },
-        shape = shape,
-        color = MaterialTheme.colorScheme.primary,
-    ) {
-        // body uses ONLY configuration + MaterialTheme tokens
-    }
-}
-```
-
-Rules:
-
-- Signature is always `(configuration: XConfiguration, modifier: Modifier = Modifier)`. The `modifier` param is the caller's slot; nothing else.
-- `testTag` from `testingIds`; `contentDescription` from `accessibility.label` or `stringResource(R.string...)`.
-- No hardcoded `dp` / `Color(0xFF...)` / `TextStyle(...)`  -  every value reads from `MaterialTheme.*` or the project's theme extension.
-- No `LaunchedEffect` / `rememberCoroutineScope` for stateful behaviour  -  keep the composable pure. If async is needed, surface it via Configuration callbacks (the caller orchestrates).
-
-### 3. `{Name}Modifiers.kt`
-
-Fluent modifier-style helpers. Android idiom: extension functions on the Configuration type:
-
-```kotlin
-fun ButtonPrimaryConfiguration.title(value: String) = copy(title = value)
-fun ButtonPrimaryConfiguration.style(value: ButtonStyle) = copy(style = value)
-fun ButtonPrimaryConfiguration.enabled(value: Boolean = true) = copy(isEnabled = value)
-fun ButtonPrimaryConfiguration.onClick(block: () -> Unit) = copy(onClick = block)
-```
-
-Call sites read fluently:
-
-```kotlin
-ButtonPrimary(
-    ButtonPrimaryConfiguration()
-        .title("Save")
-        .style(.Secondary)
-        .onClick { viewModel.save() }
-)
-```
-
-### 4. `{Name}Preview.kt`
-
-`@Preview` covering meaningful variants. At minimum:
-
-```kotlin
-@Preview(name = "default",  showBackground = true)
-@Preview(name = "dark",     showBackground = true, uiMode = UI_MODE_NIGHT_YES)
-@Preview(name = "rtl",      showBackground = true, locale = "ar")
-@Preview(name = "fontScale",showBackground = true, fontScale = 1.5f)
-@Composable
-private fun ButtonPrimaryPreview() {
-    AppTheme { ButtonPrimary(ButtonPrimaryConfiguration().title("Save")) }
-}
-```
-
-`--dev` may emit only `default` + `dark` previews; full set lands in non-dev runs.
-
-### 5. `README.md`
-
-Variant matrix + usage example. Format mirrors the iOS peer's `FIGMA.md` so wiki generators can read both without code branches.
-
-## Progress emission
-
-Per the WS-11 contract, emit the following inline before each write:
-
-```
-→ writing Configuration {Name}Configuration.kt
-→ writing Composable {Name}.kt
-→ writing Modifiers {Name}Modifiers.kt
-→ writing Preview {Name}Preview.kt
-→ writing README.md
-→ running gradle compileDebugKotlin  (verification)
-```
-
-## Build verification
-
-After writing, run (with the build-queue lock from `refs/phases/operations.md`):
-
-```bash
-./gradlew :${module}:compileDebugKotlin --console=plain
-```
-
-Compile errors → up to 3 auto-fix cycles via Sonnet (iOS peer allows the same). Still failing → halt and surface via `state.phases["3"].errors[]`.
-
-## Cross-CLI parity
-
-The iOS and Android implement skills emit identical progress-line shapes and write the same 5-file set (Configuration + Component + Modifiers + Preview + README), just in the target language. `smoke-figma-android-parity.sh` asserts that every iOS implement output has an Android peer file name.