stylegallery 0.1.0

package/consumer-reference/schema/promotion-rfc.schema.json

@@ -0,0 +1,219 @@
+{
+  "$defs": {
+    "attestation": {
+      "additionalProperties": false,
+      "properties": {
+        "attested_by": { "minLength": 1, "type": "string" },
+        "context_id": { "$ref": "#/$defs/slug" },
+        "consumer_id": { "$ref": "#/$defs/slug" },
+        "count_toward_gate": { "type": "boolean" },
+        "organization_id": { "$ref": "#/$defs/slug" },
+        "profile_record": {
+          "pattern": "^(?!/)(?!.*//)(?!.*(?:^|/)\\.{1,2}(?:/|$))(?![A-Za-z][A-Za-z0-9+.-]*:)[^\\\\?#]+\\.json$",
+          "type": "string"
+        },
+        "relationship": { "enum": ["independent", "related"] }
+      },
+      "required": ["attested_by", "context_id", "consumer_id", "count_toward_gate", "organization_id", "relationship"],
+      "type": "object"
+    },
+    "evidence": {
+      "additionalProperties": false,
+      "properties": {
+        "id": { "$ref": "#/$defs/slug" },
+        "kind": { "enum": ["blocking", "claim_scoped", "regression"] },
+        "reference": { "minLength": 1, "type": "string" },
+        "status": { "enum": ["failed", "passed"] }
+      },
+      "required": ["id", "kind", "reference", "status"],
+      "type": "object"
+    },
+    "slug": {
+      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+      "type": "string"
+    }
+  },
+  "$id": "https://stylegallery.example/consumer-reference/schema/promotion-rfc.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "allOf": [
+    {
+      "if": {
+        "properties": { "transition": { "properties": { "to": { "const": "stable" } }, "required": ["to"], "type": "object" } },
+        "required": ["transition"]
+      },
+      "then": {
+        "properties": {
+          "provenance": { "properties": { "debt_resolved": { "const": true } }, "required": ["debt_resolved"], "type": "object" },
+          "stable_scope_decision": { "const": true },
+          "support": { "properties": { "status": { "const": "active" } }, "required": ["status"], "type": "object" },
+          "evidence": {
+            "allOf": [
+              { "contains": { "properties": { "kind": { "const": "claim_scoped" }, "status": { "const": "passed" } }, "required": ["kind", "status"], "type": "object" } },
+              { "contains": { "properties": { "kind": { "const": "regression" }, "status": { "const": "passed" } }, "required": ["kind", "status"], "type": "object" } }
+            ],
+            "type": "array"
+          }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "normative_bypass": { "const": "normative_correctness" } }, "required": ["normative_bypass"] },
+      "then": { "properties": { "scope": { "properties": { "kind": { "const": "normative_correctness" } }, "required": ["kind"], "type": "object" } } }
+    },
+    {
+      "if": { "properties": { "compatibility": { "properties": { "breaking": { "const": true } }, "required": ["breaking"], "type": "object" } }, "required": ["compatibility"] },
+      "then": { "properties": { "migration": { "properties": { "required": { "const": true } }, "required": ["required"], "type": "object" } } }
+    }
+  ],
+  "properties": {
+    "attestations": {
+      "items": { "$ref": "#/$defs/attestation" },
+      "type": "array"
+    },
+    "compatibility": {
+      "additionalProperties": false,
+      "properties": {
+        "breaking": { "type": "boolean" },
+        "surface": { "minLength": 1, "type": "string" }
+      },
+      "required": ["breaking", "surface"],
+      "type": "object"
+    },
+    "decision": { "enum": ["deferred", "rejected"] },
+    "deprecation": {
+      "additionalProperties": false,
+      "properties": {
+        "plan": { "minLength": 1, "type": "string" },
+        "required": { "type": "boolean" }
+      },
+      "required": ["plan", "required"],
+      "type": "object"
+    },
+    "eligibility_basis": { "const": "full_contract" },
+    "evidence": {
+      "items": { "$ref": "#/$defs/evidence" },
+      "minItems": 1,
+      "type": "array"
+    },
+    "example_only": { "const": true },
+    "exceptions": {
+      "items": { "minLength": 1, "type": "string" },
+      "type": "array"
+    },
+    "id": { "$ref": "#/$defs/slug" },
+    "known_issues": {
+      "items": { "minLength": 1, "type": "string" },
+      "type": "array"
+    },
+    "migration": {
+      "additionalProperties": false,
+      "properties": {
+        "plan": { "minLength": 1, "type": "string" },
+        "required": { "type": "boolean" }
+      },
+      "required": ["plan", "required"],
+      "type": "object"
+    },
+    "normative_bypass": { "enum": ["none", "normative_correctness"] },
+    "owner": {
+      "additionalProperties": false,
+      "properties": {
+        "enforcement": { "const": "placeholder" },
+        "migration": { "minLength": 1, "type": "string" },
+        "rollback": { "minLength": 1, "type": "string" },
+        "scope": { "minLength": 1, "type": "string" },
+        "support": { "minLength": 1, "type": "string" }
+      },
+      "required": ["enforcement", "migration", "rollback", "scope", "support"],
+      "type": "object"
+    },
+    "provenance": {
+      "additionalProperties": false,
+      "properties": {
+        "debt_resolved": { "type": "boolean" },
+        "source": { "minLength": 1, "type": "string" }
+      },
+      "required": ["debt_resolved", "source"],
+      "type": "object"
+    },
+    "review_independence": { "const": "single_account" },
+    "rollback": {
+      "additionalProperties": false,
+      "properties": {
+        "action": { "minLength": 1, "type": "string" },
+        "triggers": {
+          "items": { "minLength": 1, "type": "string" },
+          "minItems": 1,
+          "type": "array"
+        }
+      },
+      "required": ["action", "triggers"],
+      "type": "object"
+    },
+    "schema_version": { "const": "1.0" },
+    "scope": {
+      "additionalProperties": false,
+      "properties": {
+        "aesthetic": { "const": false },
+        "kind": { "enum": ["invariant", "normative_correctness"] },
+        "summary": { "minLength": 1, "type": "string" }
+      },
+      "required": ["aesthetic", "kind", "summary"],
+      "type": "object"
+    },
+    "stable_scope_decision": { "type": "boolean" },
+    "support": {
+      "additionalProperties": false,
+      "properties": {
+        "capacity": { "const": "committed" },
+        "status": { "const": "active" }
+      },
+      "required": ["capacity", "status"],
+      "type": "object"
+    },
+    "transition": {
+      "additionalProperties": false,
+      "oneOf": [
+        {
+          "properties": { "from": { "const": "consumer_local" }, "to": { "const": "shared_experimental" } },
+          "required": ["from", "to"]
+        },
+        {
+          "properties": { "from": { "const": "shared_experimental" }, "to": { "const": "stable" } },
+          "required": ["from", "to"]
+        }
+      ],
+      "properties": {
+        "from": { "enum": ["consumer_local", "shared_experimental", "stable"] },
+        "to": { "enum": ["shared_experimental", "stable"] }
+      },
+      "required": ["from", "to"],
+      "type": "object"
+    }
+  },
+  "required": [
+    "attestations",
+    "compatibility",
+    "decision",
+    "deprecation",
+    "eligibility_basis",
+    "evidence",
+    "example_only",
+    "exceptions",
+    "id",
+    "known_issues",
+    "migration",
+    "normative_bypass",
+    "owner",
+    "provenance",
+    "review_independence",
+    "rollback",
+    "schema_version",
+    "scope",
+    "stable_scope_decision",
+    "support",
+    "transition"
+  ],
+  "type": "object"
+}

package/consumer-reference/schema/runtime-evidence-manifest.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://stylegallery.local/consumer-reference/schema/runtime-evidence-manifest.schema.json",
+  "title": "Closed component-state runtime evidence manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "record_kind", "claim_boundary", "recorded_at", "environment", "run", "session", "records"],
+  "properties": {
+    "schema_version": { "const": "1.0" },
+    "record_kind": { "const": "component_state_runtime_manifest" },
+    "claim_boundary": { "const": "Scenario artifacts are evidence, not visual regression baselines or accessibility certification." },
+    "recorded_at": { "type": "string", "format": "date-time" },
+    "environment": { "$ref": "https://stylegallery.local/consumer-reference/schema/capture-session.schema.json#/$defs/environment" },
+    "run": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "source", "repository", "revision", "attempt"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "source": { "enum": ["local", "github_actions"] },
+        "repository": { "type": "string", "minLength": 1 },
+        "revision": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+        "attempt": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "session": { "$ref": "https://stylegallery.local/consumer-reference/schema/capture-session.schema.json#/$defs/completed_session" },
+    "records": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "https://stylegallery.local/consumer-reference/schema/evidence-record.schema.json" }
+    }
+  }
+}

package/consumer-reference/schema/visual-evidence.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://stylegallery.local/consumer-reference/schema/visual-evidence.schema.json",
+  "title": "Browser-authored visual capture metadata",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "channel", "capture_session", "captured_at", "profile_id", "scenario_id", "semantic_mode", "source_sha256", "image"],
+  "properties": {
+    "schema_version": { "const": "1.0" },
+    "channel": { "const": "visual" },
+    "capture_session": { "$ref": "https://stylegallery.local/consumer-reference/schema/capture-session.schema.json#/$defs/session_link" },
+    "captured_at": { "type": "string", "format": "date-time" },
+    "profile_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "scenario_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "semantic_mode": { "enum": ["action", "toggle", "disclosure", "switch"] },
+    "source_sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "image": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256", "byte_length", "media_type", "width", "height"],
+      "properties": {
+        "path": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*\\.png$" },
+        "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "byte_length": { "type": "integer", "minimum": 1 },
+        "media_type": { "const": "image/png" },
+        "width": { "type": "integer", "minimum": 44 },
+        "height": { "type": "integer", "minimum": 44 }
+      }
+    }
+  }
+}

package/design-engineering/consumer-migration-readiness.md

@@ -0,0 +1,124 @@
+---
+type: Domain Guide
+title: Consumer Migration Readiness
+description: Evidence-bound method for deciding whether a consumer migration preserves its declared behavior.
+domain: design-engineering
+lifecycle: experimental
+provenance_kind: local
+---
+
+# Consumer Migration Readiness
+
+Use this method only when an existing consumer is being migrated and its behavior must remain demonstrably equivalent. It turns migration intent into a consumer-owned conformance record and executable page evidence without making StyleGallery the owner of product code or visual values.
+
+## Repository Boundary
+
+The consuming repository owns its conformance record, source paths, runtime scenarios, evidence artifacts, adoption mappings, deviations, debt, and approval decision. StyleGallery supplies an experimental method, closed schemas, and validators. It does not certify the consumer, define product defaults, or turn a local adoption into a shared standard.
+
+Ordinary implementation handoffs remain unchanged and may use `Consumer reference: not_applicable` with a sentence reason. Only a migration handoff that elects this method adds `Consumer migration conformance: declared` and one normalized repository-relative JSON record path.
+
+## Reusable Method
+
+1. Inventory the old and new consumer behavior before changing implementation.
+2. Create one consumer-local record using the [consumer conformance schema](../consumer-reference/schema/consumer-conformance-record.schema.json).
+3. Explicitly classify every migration dimension as `applicable` with runtime scenario IDs or `not_applicable` with a sentence reason.
+4. Map each adopted StyleGallery source anchor to a concrete local component, selector, or module plus its local decision, deviations, debt, and scenario IDs.
+5. Execute the named unit, integration, or browser command. A prose checklist, screenshot, or generated fixture alone is not runtime proof.
+6. For page work, create one source-bound evidence session, execute the browser matrix, finalize the manifest, and validate the completed session against the conformance record.
+7. Review the [consumer migration evidence gate](../quality/gates/consumer-migration-evidence.md). Block migration when required evidence is missing, stale, cross-session, source-drifted, or failed.
+
+## Migration Dimension Contract
+
+The record must classify exactly these thirteen dimensions:
+
+| Dimension | What the consumer must preserve or explicitly exclude |
+| --- | --- |
+| `behavior_inventory` | The complete named behavior surface being migrated. |
+| `route_parity` | Routes, entry points, and navigation outcomes. |
+| `field_parity` | Accepted fields, output fields, validation, and serialization. |
+| `action_parity` | User and programmatic actions plus observable outcomes. |
+| `state_transitions` | Allowed state changes, guards, and terminal states. |
+| `contract_precedence` | Which rule wins when old, new, and local contracts conflict. |
+| `direct_mutation` | Effects of direct state or model mutation. |
+| `indirect_mutation` | Effects reached through events, adapters, or dependent modules. |
+| `persistence_round_trip` | Save, reload, serialization, and restoration behavior. |
+| `reset_boundary` | What reset clears, preserves, and returns to defaults. |
+| `exact_time_boundary` | Inclusive or exclusive timing behavior at exact boundaries. |
+| `defaults_tri_state_mapping` | Mapping among absent, explicit default, and explicit non-default values. |
+| `atomic_batch_behavior` | All-or-nothing behavior, ordering, and rollback for grouped changes. |
+
+An `applicable` dimension references at least one declared runtime scenario. A `not_applicable` dimension includes a concrete sentence reason. Silence is never a classification.
+
+## Opinionated Guidance
+
+- Prefer the smallest scenario that proves an observable outcome over broad internal coverage.
+- Pin both the consumer revision and each adopted StyleGallery revision; a branch name or moving tag is insufficient.
+- Record local deviations honestly. Conformance means the declared boundary is internally consistent, not that every StyleGallery suggestion was copied.
+- Treat expired debt as a decision trigger. Do not rewrite evidence timestamps to make a stale review appear current.
+- Keep page evidence tied to the exact source inventory and browser run that produced it.
+
+## Platform-Specific Guidance
+
+Browser page evidence uses the required viewport set `320`, `375`, `768`, `1024`, and `1440` pixels plus the declared container, content, state, overlay, and page-scale cases. Platform-specific raster identity may supplement computed assertions, but it cannot replace semantic, focus, overflow, or contrast checks and cannot imply cross-platform pixel equivalence.
+
+## Unsupported Absolutes
+
+Passing this method does not prove complete accessibility, product correctness, usability, visual quality, independent adoption, cross-browser equivalence, or owner approval. Synthetic fixtures prove validator behavior only. A pinned revision proves source identity, not source authority or consumer suitability.
+
+## Verification Contract
+
+The minimum verification chain is:
+
+```txt
+consumer source inventory
+  -> conformance record with 13 explicit classifications
+  -> executable scenarios with zero exit and result artifacts
+  -> adoption mappings with pinned StyleGallery anchors
+  -> optional source-bound page-evidence manifest
+  -> consumer migration evidence gate decision
+```
+
+Validate a record without applicable page evidence directly:
+
+```sh
+node <stylegallery-root>/scripts/validate-consumer-conformance.mjs \
+  --root <consumer-root> \
+  --record <record.json> \
+  --json
+```
+
+Unit and integration scenarios declare a shell-free Node `argv` array beginning with `node`. The validator checks out the exact consumer revision in an isolated worktree, enables Node's permission model without child-process, worker, native-addon, or WASI grants, supplies only `PATH`, `CI=1`, deterministic locale flags, `STYLEGALLERY_RESULT_ARTIFACT`, and `STYLEGALLERY_RUNTIME_CONTEXT`, and requires the command to create that result artifact during the run. Commands may read and write only inside the isolated checkout, must be self-contained at the pinned revision, and cannot override the governed permission flags. The validator does not reuse the caller's `node_modules` or forward caller secrets.
+
+When `page_evidence.status` is `applicable`, use one artifact root for the complete lifecycle. Start the source-bound session before the browser run, write each runner result beneath that artifact root, finalize the session, and then validate the record against the completed artifacts:
+
+```sh
+node <stylegallery-root>/scripts/create-page-evidence-session.mjs \
+  --root <consumer-root> \
+  --record <record.json> \
+  --artifact-root <artifact-root> \
+  --json
+
+node <stylegallery-root>/scripts/finalize-page-evidence.mjs \
+  --root <consumer-root> \
+  --artifact-root <artifact-root> \
+  --runner-result <runner-result.json> \
+  --review-by <RFC3339-date-time> \
+  --json
+
+node <stylegallery-root>/scripts/validate-consumer-conformance.mjs \
+  --root <consumer-root> \
+  --record <record.json> \
+  --artifact-root <artifact-root> \
+  --json
+```
+
+`<record.json>` resolves from `<consumer-root>`, and each `<runner-result.json>` resolves from `<artifact-root>`. The completed manifest must match the consumer repository, revision, relevant source set, browser scenario set, run/session identities, and source digests. The StyleGallery checkout used for validation must contain every pinned StyleGallery revision; a shallow checkout that omits a historical pin fails closed. See [Consumer Migration Evidence](../quality/evidence/consumer-migration.md) for what each channel can and cannot support.
+
+## Source, License, And Attribution
+
+This is a StyleGallery-local method. It has no external source snapshot and intentionally declares `provenance_kind: local` rather than upstream repository metadata.
+
+## IA Navigation
+
+Parent: [Design Engineering](index.md).
+Next: [Consumer Migration Evidence Gate](../quality/gates/consumer-migration-evidence.md).

package/design-engineering/index.md

@@ -0,0 +1,28 @@
+# Design Engineering
+
+The Design Engineering domain owns product-layer craft questions and verification methods without turning practitioner taste into shared policy.
+
+## Scope Boundary
+
+In scope: purpose, frequency, interaction detail, implementation review, prototyping, and evidence-bearing product decisions.
+
+Out of scope: a second universal principle set, unsupported claims of beauty or adoption, and overrides of semantic, accessibility, Layout, or shared quality contracts.
+
+## Documents
+
+- [Interface Craft Decisions](interface-craft.md) connects product purpose, implementation detail, and verification without treating taste as proof.
+- [Consumer Migration Readiness](consumer-migration-readiness.md) turns migration intent into a consumer-owned thirteen-dimension conformance record and executable evidence chain.
+- [Reference Profiles](reference-profiles/index.md) provides two explicitly selected, related adversarial examples and a documentation-only external adaptation route.
+
+## Relationship To Shared Quality
+
+This domain proposes product-layer questions. [Quality Gates](../quality/index.md) remain the shared authority for claims, evidence families, accessibility precedence, rationale, and debt.
+
+## Domain Contract
+
+See [StyleGallery Domains](../DOMAINS.md) for lifecycle, provenance, page membership, and promotion rules.
+
+## IA Navigation
+
+Parent: [StyleGallery](../index.md).
+Next: [Consumer Migration Readiness](consumer-migration-readiness.md).

package/design-engineering/interface-craft.md

@@ -0,0 +1,107 @@
+---
+type: Domain Guide
+title: Interface Craft Decisions
+description: Repository-bounded method for purpose, implementation, review, and evidence decisions at the product layer.
+domain: design-engineering
+lifecycle: experimental
+source_repository: https://github.com/emilkowalski/skills
+source_path: skills/emil-design-eng/SKILL.md
+source_revision: 220e8607c90b17337d210125777b7b695f26c221
+---
+
+# Interface Craft Decisions
+
+Primary role: design-engineering decision guide.
+
+## Repository Boundary
+
+This page helps connect product intent, implementation detail, and verification. It does not create a second StyleGallery principle set, rank visual taste as objective quality, or override Layout, accessibility, source-order, and shared evidence contracts.
+
+## Reusable Method
+
+### Establish The Job
+
+Before tuning the interface, name:
+
+- the user task and state change;
+- why the behavior or treatment is necessary;
+- how frequently it appears;
+- which constraints and inputs it must survive;
+- the observable that will decide whether it works.
+
+If those answers are absent, implementation detail is premature.
+
+### Build A Verifiable Representation
+
+Use semantic structure and the owning domain's smallest robust contract first. Prototype the uncertain interaction or visual relationship at the lowest fidelity that exposes its failure modes. A prototype is evidence of one implementation state, not proof of general usability.
+
+### Review Observable Failures
+
+Inspect real content, empty states, long labels, constrained containers, repeated interaction, focus order, alternative input, relevant preferences, and target browsers/devices. When timing or continuity matters, review recordings slowly or frame by frame.
+
+### Record The Decision
+
+Use the shared high-impact claim shape:
+
+```text
+Principle:
+Claim:
+Context:
+Use case:
+Warrant:
+Evidence family:
+Verification protocol:
+Implementation handoff:
+Consumer reference: not_applicable
+Consumer reference reason: This blank craft-decision template declares no consumer-specific reference record.
+Boundary or limitation:
+Debt or escalation:
+Decision:
+```
+
+This makes the result reviewable without turning the practitioner's preference into authority.
+
+## Decision Questions
+
+| Question | Evidence that can help | What it cannot prove alone |
+| --- | --- | --- |
+| Does the detail serve the primary task? | Task model, prototype, user evidence | Universal preference |
+| Is the default understandable without instruction? | Task completion, terminology test, comparative prototype | Long-term adoption |
+| Does repetition make the behavior costly? | Frequency estimate, interaction timing, user evidence | One universal threshold |
+| Does the interface preserve continuity? | Rendered sequence, source/focus inspection | Human orientation for every user |
+| Does the implementation survive real constraints? | Content/container/input/browser matrix | Brand or aesthetic quality |
+| Is the final polish coherent with declared intent? | Named comparative criteria and representative review | Objective beauty |
+
+## Opinionated Guidance
+
+Small details can compound, strong defaults can lower adoption effort, and fresh-eye review can expose defects familiarity hides. These are practitioner heuristics. “Beautiful,” “delightful,” “premium,” “obvious,” and “feels right” require an operational definition and suitable human evidence when used as claims.
+
+## Platform-Specific Guidance
+
+CSS entry features, clipping techniques, Motion/Framer Motion, React effects, component-library variables, pointer capture, and browser-specific performance behavior belong in bounded implementation notes. Verify current official documentation and the actual product surface before recommending them.
+
+## Unsupported Absolutes
+
+- Beauty is not repository leverage or a sufficient acceptance criterion.
+- A fixed duration, easing, scale, velocity, or frequency threshold is not universal.
+- CSS does not categorically outperform JavaScript.
+- A property or API name does not prove hardware acceleration.
+- Product popularity does not prove a reusable implementation pattern.
+- A promotional or enthusiastic posture is not part of the review contract.
+
+## Verification Contract
+
+Every high-impact recommendation maps `principle -> claim -> context -> warrant -> evidence -> protocol -> boundary/debt`. Visual and interaction claims require rendered evidence; accessibility claims use the accessibility gate; human-quality claims need corresponding user or HCI evidence. A passing implementation keeps the owning domain's constraints visible in the handoff.
+
+## Source, License, And Attribution
+
+- Upstream inspiration: [emil-design-eng/SKILL.md](https://github.com/emilkowalski/skills/blob/220e8607c90b17337d210125777b7b695f26c221/skills/emil-design-eng/SKILL.md)
+- Snapshot: `220e8607c90b17337d210125777b7b695f26c221`
+- Upstream license: MIT, Copyright (c) 2026 Emil Kowalski.
+- Reuse form: independent method rewrite; upstream prose, tables, code, examples, distinctive ordering, and the quotation attributed to Paul Graham were not retained.
+- Evidence boundary: this practitioner source suggests review questions; it does not establish local quality, accessibility, performance, or adoption outcomes.
+
+## IA Navigation
+
+Parent: [Design Engineering](index.md).
+Next: [Platform Guides](../platform-guides/index.md).

package/design-engineering/reference-profiles/external-adaptation/index.md

@@ -0,0 +1,12 @@
+# External Consumer Adaptation
+
+Synthetic validator coverage only; no durable adopter record exists in this route.
+
+An external consumer keeps its canonical JSON record in its own repository, selects it explicitly there, and points only toward the pinned Layout source. StyleGallery documents that route without storing an adopter, attestation, production, independence, or promotion claim.
+
+The validator exercises a synthetic local-as-external mutation and rejects any JSON record placed below this documentation directory.
+
+## IA Navigation
+
+Parent: [Reference Profiles](../index.md).
+Next: [Platform Guides](../../../platform-guides/index.md).