@adia-ai/adia-ui-factory 0.8.39 → 0.8.41

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "adia-ui-kit-factory",
-  "version": "0.8.39",
+  "version": "0.8.41",
   "description": "Author and verify apps built ON the adia-ui (@adia-ai) light-DOM web-component framework \u2014 orient, scaffold, compose, wire, verify, and migrate across SPA and SSR rendering modes. Wires the a2ui MCP for catalog retrieval, UI generation, and validation.",
   "author": {
     "name": "Kim",

package/.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "adia-gen-ui": {
       "command": "npx",
-      "args": ["-y", "@adia-ai/mcp@0.8.39", "gen-ui"]
+      "args": ["-y", "@adia-ai/mcp@0.8.41", "gen-ui"]
     }
   }
 }

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog — adia-ui-kit-factory
 
+## [0.8.41] — 2026-08-17
+
+### Changed
+- **`pattern-catalog`'s `references/pattern-index.md` lists every component tag a pattern composes (gh#1498)** — the silent top-12 cap per pattern is removed, and the index is regenerated for the 0.8.41 catalog wave (`progress-row-ui` absorbed into `progress-ui`, `input-ui[type]` enum trim). Consumers picking patterns by component tag now see the full list.
+- **`gen-ui-wiring` + `wave-coordination` skills harvest ADR-0046/ADR-0047 into references (#1409)** — `gen-ui-wiring/references/persona-floor.md` and `wave-coordination/references/seat-roster-names.md` carry the ratified decisions the SKILL.md files previously restated informally.
+
+### Maintenance
+- **`.claude-plugin/plugin.json` version bump** — moves in lockstep with package.json (the `/plugin update` cache key).
+
+## [0.8.40] — 2026-08-15
+
+### Maintenance
+- **Lockstep version bump only.** No source changes in this package; bumped to maintain the lockstep version coherence enforced by `scripts/release/check-lockstep.mjs`. Substantive v0.8.40 work shipped in the ADR-0052/0053/0054/0056 attribute-grammar and token-convention breaking wave. See `packages/web-components/CHANGELOG.md#0840--2026-08-15` for details.
+- **`.claude-plugin/plugin.json` version bump** — moves in lockstep with package.json (the `/plugin update` cache key).
+
 ## [0.8.39] — 2026-08-15
 
 ### Maintenance

package/README.md

@@ -98,7 +98,7 @@ surface-qa-agent) · `component-model.md` · the `references/contracts/` twins.
 
 ## MCP
 
-`adia-gen-ui` server pinned: `@adia-ai/mcp@0.8.39` (tool SoT:
+`adia-gen-ui` server pinned: `@adia-ai/mcp@0.8.41` (tool SoT:
 `packages/gen-ui/mcp/TOOLS.md` — the `gen-ui` section; stability rule in
 `references/contracts/`; pin lives in `.mcp.json` — `check:plugin-count-claims`
 guards this README copy against it). The server is `adia-mcp gen-ui`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/adia-ui-factory",
-  "version": "0.8.39",
+  "version": "0.8.41",
   "description": "Author and verify apps built ON the adia-ui (@adia-ai) light-DOM web-component framework \u2014 orient, scaffold, compose, wire, verify, and migrate across SPA and SSR rendering modes. Wires the a2ui MCP for catalog retrieval, UI generation, and validation.",
   "keywords": [
     "adia-ui",

package/skills/gen-ui-wiring/SKILL.md

@@ -99,8 +99,11 @@ audit/undo, and an escalation pathway in the rendered output. Six patterns, each
 concrete AdiaUI surface: [agentic-ux-patterns.md](../../references/agentic-ux-patterns.md).
 Load it whenever the generated experience is agentic, not just displaying data.
 
-## References (plugin-root)
+## References
 
+- [references/persona-floor.md](references/persona-floor.md) — load before authoring copy,
+  errors, or defaults on this surface: the non-engineer builder is the ruled floor persona
+  (ADR-0046) and floor = MIN across their journey-critical cells.
 - [genui-a2ui.md](../../references/genui-a2ui.md) — load when mounting roots, shaping
   messages, wiring resolvers, or authoring a corpus.
 - [agentic-ux-patterns.md](../../references/agentic-ux-patterns.md) — load when the surface's

package/skills/gen-ui-wiring/references/persona-floor.md

@@ -0,0 +1,69 @@
+# Persona floor — who this surface must work for, and what "floor" means
+
+_Load before authoring or reviewing the copy, error messages, defaults, or Generation
+Record of a gen-UI surface. Answers one question: who is the least-engineering-skilled
+person this surface must serve, and what standard does that set? Complements
+[SKILL.md](../SKILL.md)'s loop (the plumbing) and the plugin-root
+[agentic-ux-patterns.md](../../../references/agentic-ux-patterns.md) (trust when the
+agent acts) — nothing here repeats them._
+
+## The floor persona is the non-engineer builder
+
+- **In scope, by ruling (ADR-0046, 2026-08-12).** People who build UIs without engineering
+  skills are inside the factory's persona floor — never out-of-scope-by-default. Their
+  primary surface is THIS skill's path: describe the experience → validate before
+  serialize → VerifyProof, i.e. `/gen-ui-wiring`. (ADR-0046 names it `/adia-genui`; the
+  ADR-0011 D10 rename wave of 2026-08-14 moved the name, not the charter.) The first two
+  steps are this skill's loop and its Generation Record; the VerifyProof is the
+  post-serialization browser gate owned by [surface-qa](../../surface-qa/SKILL.md)
+  (§Deliverable — the VerifyProof), not a record this skill emits.
+- **The name is "non-engineer builder" — not "non-technical".** The operator rephrased it
+  deliberately: these users may be deeply technical (clinicians, analysts, designers, PMs)
+  without being engineers. "Non-technical" does not appear in the program's documents; it
+  should not appear in anything authored for this surface either.
+- **What it asks of the words you write.** Copy and docs addressed to this persona avoid
+  engineering jargon without dumbing down the domain content — a clinician reading a
+  generation failure needs the cause and the next step in plain language, and the clinical
+  vocabulary left intact.
+
+## "Floor = MIN across journey-critical cells"
+
+The factory-DX program (gh#1115) scores the factory on a persona × journey matrix. Each
+persona's **floor is the MIN score across the dimensions critical to its journey**, and the
+program may not trade a floor away for expert-path work. For the non-engineer builder (P1)
+ADR-0046 names five critical dimensions — discoverability, install integrity, preflight,
+time-to-first-success, error quality — and the R1 rubric's persona-critical map extends P1's
+row with agent operability and the feedback loop (rows D1, D2, D3, D4, D5, D8, D10). Read it
+as: the weakest cell IS the persona's score — a brilliant expert path with a broken
+first-success step scores at the broken step.
+
+Floors are preserve-not-regress: they re-score per release, and a sweep goes GREEN only
+when every persona floor is ≥3 with no regression against the previous sweep (any floor
+≤1 or any regression is RED). A change to this surface that lowers a P1-critical cell is a
+program regression, not a local trade-off.
+
+What that means when authoring on this surface (each row names its rubric cell):
+
+| Cell | Authoring consequence on a gen-UI surface |
+| --- | --- |
+| Error quality (D5) | Every failure names cause + remedy in language this persona can act on — the rubric's 5-anchor is literally "remedy language matches the persona (P1-readable), zero dead ends". A Generation Record `fail` on the Validate line, or a resolver scheme left unregistered (which renders empty with no error — SKILL.md §The loop, step 4), must surface as a finding with a next step, never as a silent blank or a raw schema trace. |
+| Agent operability (D8) | Output reaches this persona only through the trust gate — the floor persona "must not go GREEN while exhausted-repair output still ships verbatim". A `fail` with no refine step after it is the exact failure the Generation Record exists to catch. |
+| Preflight (D3) | A prerequisite discovered at failure time is the 1-anchor. [inferred] On this surface the prerequisites are conditional, so check only the ones the chosen path actually needs — before the loop starts, naming the remedy, not mid-generation: the semantic-search key (`VOYAGE_API_KEY`/OpenAI — SKILL.md §Corpus) only when semantic search is selected (keyword search is offline), and the streaming endpoint behind `src`+`transport` only when the surface streams (author mode — `.doc` + `mock:` resolvers — needs neither and must not read as blocked). |
+| Time-to-first-success (D4) | The first pass must reach a rendered, validated surface. [inferred] Prefer the loop's offline defaults (core corpus keyword search, `mock:` resolvers) for the first render and ask for configuration afterwards. |
+
+## Grounding
+
+- [verified 2026-08-16] ADR-0046 — `docs/ops/adr/adr-0046-factory-persona-floor-non-engineers.md:22-30`
+  (decision: in scope; the persona's name), `:36-41` (consequences: MIN-score floor over
+  journey-critical dimensions; the jargon rule). Ratified 2026-08-12, gh#1115 Stage 0.
+- [verified 2026-08-16] Owning brief — `.claude/docs/specs/factory-dx-brief.md:29-30`
+  ("persona floor = MIN across journey-critical cells"), `:36-37` (P1 = ADR-0046 floor
+  persona), `:57-59` (floors re-score per release, preserve-not-regress).
+- [verified 2026-08-16] R1 rubric — `.claude/docs/specs/factory-dx-rubrics.md:49-57`
+  (persona-critical map; P1 = D1, D2, D3, D4, D5, D8, D10; the exhausted-repair clause),
+  `:37-39` (D3/D4/D5 anchors), `:74-77` (GREEN/AMBER/RED aggregation).
+- [verified 2026-08-16] The `/adia-genui` → `/gen-ui-wiring` rename — gen-ui-kit commit
+  `6a4fcd6ab` (2026-08-14, ADR-0011 D10 wave); the SKILL.md charter carried over unchanged.
+- [drift-prone] The P1 floor was BROKEN at the 2026-08-12 baseline (first-success and debug
+  both failed with no recovery path — brief `:36-37`; all six floors = 1, rubrics `:64`).
+  Re-read the latest R1 sweep record before quoting a floor value.

package/skills/pattern-catalog/references/pattern-index.md

@@ -16,7 +16,7 @@
   - source: `/packages/web-components/patterns/agent-cost/agent-cost.examples.html` · demo: `/packages/web-components/patterns/agent-cost/agent-cost.html` · docs: `/site/patterns/agent-cost`
 - **Agent Memory** (Patterns) — Surfaces to audit and edit what an agent remembers — a memory list, a single-entry detail, and an add/revise editor.
   - keywords: context, recall, saved facts, persistence, remember
-  - components: `button-ui` `tag-ui` `list-item-ui` `card-ui` `col-ui` `radio-ui` `text-ui` `field-ui` `code-ui` `description-list-ui` `list-ui` `row-ui`
+  - components: `button-ui` `tag-ui` `list-item-ui` `card-ui` `col-ui` `radio-ui` `text-ui` `field-ui` `code-ui` `description-list-ui` `list-ui` `row-ui` `textarea-ui`
   - source: `/packages/web-components/patterns/agent-memory/agent-memory.examples.html` · demo: `/packages/web-components/patterns/agent-memory/agent-memory.html` · docs: `/site/patterns/agent-memory`
 - **Agent Prompt Library** (Patterns) — Saved-prompt store — a full library grid, a compact in-context recall picker, and the reusable prompt card shared by both.
   - keywords: snippets, templates, slash menu, saved queries, presets
@@ -38,7 +38,7 @@
 
 - **Comments & Collaboration** (Patterns) — Comment threads with @-mentions and emoji reactions on any object — reach for it to let users discuss a doc, task, row, or design.
   - keywords: threads, mentions, reactions, replies, discussion, annotations
-  - components: `button-ui` `text-ui` `row-ui` `col-ui` `avatar-ui` `tag-ui` `card-ui` `field-ui` `kbd-ui` `divider-ui` `icon-ui` `input-ui`
+  - components: `button-ui` `text-ui` `row-ui` `col-ui` `avatar-ui` `tag-ui` `card-ui` `field-ui` `kbd-ui` `divider-ui` `icon-ui` `input-ui` `textarea-ui`
   - source: `/packages/web-components/patterns/comments-and-collaboration/comments-and-collaboration.examples.html` · demo: `/packages/web-components/patterns/comments-and-collaboration/comments-and-collaboration.html` · docs: `/site/patterns/comments-and-collaboration`
 
 ### data-table
@@ -57,7 +57,7 @@
   - source: `/packages/web-components/patterns/data-tables-inline-edit-and-tree/data-tables-inline-edit-and-tree.examples.html` · demo: `/packages/web-components/patterns/data-tables-inline-edit-and-tree/data-tables-inline-edit-and-tree.html` · docs: `/site/patterns/data-tables-inline-edit-and-tree`
 - **Filter Bar** (Patterns) — Row of removable facet chips above a table/list with an add-filter popover — reach for it when users stack multiple faceted filters.
   - keywords: facet, chips, refine, narrow, segment, query
-  - components: `action-item-ui` `tag-ui` `button-ui` `segment-ui` `card-ui` `row-ui` `action-list-ui` `code-ui` `popover-ui` `search-ui` `segmented-ui` `table-ui`
+  - components: `action-item-ui` `tag-ui` `button-ui` `segment-ui` `card-ui` `row-ui` `action-list-ui` `code-ui` `popover-ui` `search-ui` `segmented-ui` `table-ui` `text-ui` `toolbar-ui`
   - source: `/packages/web-components/patterns/filter-bar/filter-bar.examples.html` · demo: `/packages/web-components/patterns/filter-bar/filter-bar.html` · docs: `/site/patterns/filter-bar`
 
 ### data-viz
@@ -68,7 +68,7 @@
   - source: `/packages/web-components/patterns/chart-in-card/chart-in-card.examples.html` · demo: `/packages/web-components/patterns/chart-in-card/chart-in-card.html` · docs: `/site/patterns/chart-in-card`
 - **Conversion Funnel** (Patterns) — Multi-step drop-off funnel built from labeled progress rows — reach for onboarding, checkout, activation, or paywall sequences.
   - keywords: drop-off, activation, checkout steps, sign-up flow, progress rows
-  - components: `text-ui` `progress-row-ui` `col-ui` `badge-ui` `card-ui` `row-ui` `segment-ui` `button-ui` `segmented-ui`
+  - components: `text-ui` `progress-ui` `col-ui` `badge-ui` `card-ui` `row-ui` `segment-ui` `button-ui` `segmented-ui`
   - source: `/packages/web-components/patterns/conversion-funnel/conversion-funnel.examples.html` · demo: `/packages/web-components/patterns/conversion-funnel/conversion-funnel.html` · docs: `/site/patterns/conversion-funnel`
 - **Retention Cohort** (Patterns) — Retention cohort heatmap rendered as a table with color-bucketed badge cells — reach for it for retention/decay reporting.
   - keywords: heatmap, churn, decay, weekly buckets, engagement grid
@@ -87,7 +87,7 @@
   - source: `/packages/web-components/patterns/export-flow/export-flow.examples.html` · demo: `/packages/web-components/patterns/export-flow/export-flow.html` · docs: `/site/patterns/export-flow`
 - **Time-zone Selector** (Patterns) — Searchable IANA zone picker (region/city · UTC±N) from browser Intl data — reach for it for scheduling, log-display, or user prefs.
   - keywords: iana, utc offset, dst, locale, scheduling, region picker
-  - components: `field-ui` `text-ui` `card-ui` `col-ui` `select-ui` `input-ui`
+  - components: `field-ui` `text-ui` `card-ui` `col-ui` `select-ui` `time-picker-ui`
   - source: `/packages/web-components/patterns/timezone-selector/timezone-selector.examples.html` · demo: `/packages/web-components/patterns/timezone-selector/timezone-selector.html` · docs: `/site/patterns/timezone-selector`
 - **Form Drawer** (Patterns) — Side drawer with a sticky action footer for create/edit forms — reach for it for '+ New X' flows that fit one screen of fields.
   - keywords: side panel, create, edit, sticky footer, slide-in, new record
@@ -102,7 +102,7 @@
 
 - **Marketing & Engagement** (Patterns) — Hero/CTA blocks, referral-invite flows, and achievement moments — reach for it for landing pages and growth/engagement surfaces.
   - keywords: hero, cta, referral, invite, landing page, gamification
-  - components: `text-ui` `card-ui` `tag-ui` `col-ui` `button-ui` `stat-ui` `avatar-ui` `list-item-ui` `row-ui` `grid-ui` `field-ui` `input-ui`
+  - components: `text-ui` `card-ui` `tag-ui` `col-ui` `button-ui` `stat-ui` `avatar-ui` `list-item-ui` `row-ui` `grid-ui` `field-ui` `input-ui` `list-ui`
   - source: `/packages/web-components/patterns/marketing-engagement/marketing-engagement.examples.html` · demo: `/packages/web-components/patterns/marketing-engagement/marketing-engagement.html` · docs: `/site/patterns/marketing-engagement`
 
 ### navigation
@@ -113,7 +113,7 @@
   - source: `/packages/web-components/patterns/overview/overview.examples.html` · demo: `/packages/web-components/patterns/overview/overview.html` · docs: `/site/patterns/overview`
 - **Admin Sidebar** (Patterns) — The admin left rail — workspace + user switchers over a nav tree, with grouped, divided, sub-nav, and sign-in variants.
   - keywords: side rail, workspace switcher, account menu, left nav, rail
-  - components: `nav-item-ui` `admin-shell` `admin-sidebar` `adia-mark-ui` `admin-entity-item` `admin-topbar` `nav-ui` `section-ui` `admin-statusbar` `code-ui` `nav-group-ui` `select-ui`
+  - components: `nav-item-ui` `admin-shell` `admin-sidebar` `adia-mark-ui` `admin-entity-item` `admin-topbar` `nav-ui` `section-ui` `admin-statusbar` `code-ui` `nav-group-ui` `select-ui` `tag-ui` `avatar-ui` `button-ui`
   - source: `/site/pages/patterns/admin-sidebar.html` · docs: `/site/patterns/admin-sidebar`
 - **App Nav** (Patterns) — Sidebar navigation tree — grouped collapsible items, dividers, section labels, badges, and popover flyouts when collapsed.
   - keywords: menu tree, side rail, groups, flyout, collapsible menu
@@ -143,11 +143,11 @@
   - source: `/packages/web-components/patterns/alert-dialog/alert-dialog.examples.html` · demo: `/packages/web-components/patterns/alert-dialog/alert-dialog.html` · docs: `/site/patterns/alert-dialog`
 - **Inline Dialog** (Patterns) — Anchored non-modal popover carrying a 1–3 field mini-form — reach for it for reversible in-context micro-decisions like rename or set-status.
   - keywords: popover, anchored, non-modal, contextual, confirm, quick edit
-  - components: `button-ui` `field-ui` `input-ui` `card-ui` `popover-ui` `row-ui` `text-ui` `col-ui` `icon-ui` `select-ui` `tag-ui`
+  - components: `button-ui` `field-ui` `card-ui` `popover-ui` `row-ui` `text-ui` `col-ui` `icon-ui` `input-ui` `calendar-picker-ui` `select-ui` `tag-ui` `time-picker-ui`
   - source: `/packages/web-components/patterns/inline-dialog/inline-dialog.examples.html` · demo: `/packages/web-components/patterns/inline-dialog/inline-dialog.html` · docs: `/site/patterns/inline-dialog`
 - **Record Detail Drawer** (Patterns) — Side drawer showing a selected row's details over tabs — reach for it for list-detail workflows that must keep list scroll and filters.
   - keywords: side panel, row inspector, peek, tabbed, contact, order
-  - components: `button-ui` `badge-ui` `col-ui` `text-ui` `timeline-item-ui` `row-ui` `tab-ui` `description-list-ui` `drawer-ui` `avatar-ui` `code-ui` `tabs-ui`
+  - components: `button-ui` `badge-ui` `col-ui` `text-ui` `timeline-item-ui` `row-ui` `tab-ui` `description-list-ui` `drawer-ui` `avatar-ui` `code-ui` `tabs-ui` `timeline-ui`
   - source: `/packages/web-components/patterns/record-detail-drawer/record-detail-drawer.examples.html` · demo: `/packages/web-components/patterns/record-detail-drawer/record-detail-drawer.html` · docs: `/site/patterns/record-detail-drawer`
 
 ### permissions-access
@@ -158,7 +158,7 @@
   - source: `/packages/web-components/patterns/access-requests/access-requests.examples.html` · demo: `/packages/web-components/patterns/access-requests/access-requests.html` · docs: `/site/patterns/access-requests`
 - **Admin — Keys & Export** (Patterns) — API-key/webhook management plus GDPR/CCPA data export — secret-masking and destructive-action wiring for account admin.
   - keywords: api tokens, webhooks, secrets, credentials, gdpr
-  - components: `button-ui` `icon-ui` `list-item-ui` `tag-ui` `text-ui` `row-ui` `card-ui` `col-ui` `field-ui` `list-ui` `alert-ui` `select-ui`
+  - components: `button-ui` `icon-ui` `list-item-ui` `tag-ui` `text-ui` `row-ui` `card-ui` `col-ui` `field-ui` `list-ui` `alert-ui` `select-ui` `input-ui`
   - source: `/packages/web-components/patterns/admin-keys-and-export/admin-keys-and-export.examples.html` · demo: `/packages/web-components/patterns/admin-keys-and-export/admin-keys-and-export.html` · docs: `/site/patterns/admin-keys-and-export`
 - **Permissions Matrix** (Patterns) — RBAC grid of capabilities × roles with checkbox cells plus a plain-language role summary — reach for it for configurable role authoring.
   - keywords: rbac, roles, capabilities, grid, access control, entitlements
@@ -170,11 +170,11 @@
   - source: `/packages/web-components/patterns/permissions-role-picker/permissions-role-picker.examples.html` · demo: `/packages/web-components/patterns/permissions-role-picker/permissions-role-picker.html` · docs: `/site/patterns/permissions-role-picker`
 - **Permissions Sharing** (Patterns) — Share-a-resource surfaces: visibility scope picker, share link with expiry, add-people autocomplete — reach for it for a Share dialog.
   - keywords: visibility, share link, expiry, invite people, scope, access
-  - components: `col-ui` `row-ui` `text-ui` `select-ui` `option-card-ui` `avatar-ui` `button-ui` `field-ui` `tag-ui` `card-ui` `description-list-ui` `input-ui`
+  - components: `col-ui` `row-ui` `text-ui` `select-ui` `option-card-ui` `avatar-ui` `button-ui` `field-ui` `tag-ui` `card-ui` `description-list-ui` `input-ui` `search-ui`
   - source: `/packages/web-components/patterns/permissions-sharing/permissions-sharing.examples.html` · demo: `/packages/web-components/patterns/permissions-sharing/permissions-sharing.html` · docs: `/site/patterns/permissions-sharing`
 - **Profile — Public & Verification** (Patterns) — Shareable public profile page plus a KYC identity-verification flow — reach for it for external bylines or regulated identity checks.
   - keywords: kyc, identity, verified badge, byline, onboarding, account
-  - components: `text-ui` `col-ui` `button-ui` `card-ui` `alert-ui` `stepper-item-ui` `list-item-ui` `row-ui` `stat-ui` `tag-ui` `upload-ui` `avatar-ui`
+  - components: `text-ui` `col-ui` `button-ui` `card-ui` `alert-ui` `stepper-item-ui` `list-item-ui` `row-ui` `stat-ui` `tag-ui` `upload-ui` `avatar-ui` `field-ui` `grid-ui` `list-ui` `select-ui` `stepper-ui`
   - source: `/packages/web-components/patterns/profile-public-and-verification/profile-public-and-verification.examples.html` · demo: `/packages/web-components/patterns/profile-public-and-verification/profile-public-and-verification.html` · docs: `/site/patterns/profile-public-and-verification`
 
 ### search-discovery
@@ -188,7 +188,7 @@
 
 - **Admin Shell** (Patterns) — Canonical admin/SaaS/dashboard app shell — sidebar, topbar, scrollable content, statusbar, command palette; reach for a full internal app.
   - keywords: dashboard, saas, app frame, layout scaffold, workspace
-  - components: `nav-item-ui` `admin-topbar` `button-ui` `admin-entity-item` `admin-content` `admin-page` `admin-page-body` `admin-page-header` `admin-scroll` `admin-shell` `admin-sidebar` `admin-statusbar`
+  - components: `nav-item-ui` `admin-topbar` `button-ui` `admin-entity-item` `admin-content` `admin-page` `admin-page-body` `admin-page-header` `admin-scroll` `admin-shell` `admin-sidebar` `admin-statusbar` `avatar-ui` `breadcrumb-ui` `nav-ui` `section-ui` `code-ui` `icon-ui` `select-ui`
   - source: `/packages/web-components/patterns/admin-shell/admin-shell.examples.html` · demo: `/packages/web-components/patterns/admin-shell/admin-shell.html` · docs: `/site/patterns/admin-shell`
 - **Admin Page Header** (Patterns) — The sticky page-title band inside admin-page — title, description, right-aligned page actions, and an optional tab row.
   - keywords: title band, deck, subtitle, action row, sticky title
@@ -200,7 +200,7 @@
   - source: `/site/pages/patterns/admin-content-topbar.html` · docs: `/site/patterns/admin-content-topbar`
 - **Admin Content Aside** (Patterns) — Content-attached rails — an in-content section subnav or a trailing inspector/changelog pane beside the page body.
   - keywords: inspector rail, side panel, subnav, right rail, context pane
-  - components: `nav-item-ui` `code-ui` `tag-ui` `admin-content` `admin-page` `admin-page-body` `admin-page-header` `admin-scroll` `admin-shell` `admin-topbar` `breadcrumb-ui` `button-ui`
+  - components: `nav-item-ui` `code-ui` `tag-ui` `admin-content` `admin-page` `admin-page-body` `admin-page-header` `admin-scroll` `admin-shell` `admin-topbar` `breadcrumb-ui` `button-ui` `nav-ui`
   - source: `/site/pages/patterns/admin-content-aside.html` · docs: `/site/patterns/admin-content-aside`
 - **Adia Editor** (Patterns) — Design-tool/code-editor shell — toolbar, navigator, canvas, inspector, statusbar. Doc-hub — copy its canonical-hierarchy code sample, not the components list.
   - keywords: canvas layout, ide, workspace panes, design tool, inspector
@@ -238,7 +238,7 @@
   - source: `/packages/web-components/patterns/kanban-board/kanban-board.examples.html` · demo: `/packages/web-components/patterns/kanban-board/kanban-board.html` · docs: `/site/patterns/kanban-board`
 - **Wizard Drawer** (Patterns) — Multi-step form in a drawer with a header stepper and Back/Next footer — reach for it for 3–5 step onboarding or guided setup flows.
   - keywords: stepper, multi-step, onboarding, guided setup, progress, steps
-  - components: `field-ui` `button-ui` `col-ui` `stepper-item-ui` `input-ui` `textarea-ui` `alert-ui` `code-ui` `description-list-ui` `drawer-ui` `select-ui` `stepper-ui`
+  - components: `field-ui` `button-ui` `col-ui` `stepper-item-ui` `input-ui` `textarea-ui` `alert-ui` `code-ui` `description-list-ui` `drawer-ui` `select-ui` `stepper-ui` `switch-ui` `text-ui`
   - source: `/packages/web-components/patterns/wizard-drawer/wizard-drawer.examples.html` · demo: `/packages/web-components/patterns/wizard-drawer/wizard-drawer.html` · docs: `/site/patterns/wizard-drawer`
 
 ## Templates
@@ -374,7 +374,7 @@
 
 - **Admin Dashboard** (Dashboards) — Tabbed SaaS analytics dashboard (KPI grid, activity chart, transactions table) — reach for it as the app's home monitoring surface.
   - keywords: analytics, kpi, metrics, saas, home
-  - components: `text-ui` `row-ui` `col-ui` `card-ui` `button-ui` `list-item-ui` `badge-ui` `avatar-ui` `field-ui` `grid-ui` `icon-ui` `stat-ui`
+  - components: `text-ui` `row-ui` `col-ui` `card-ui` `button-ui` `list-item-ui` `badge-ui` `avatar-ui` `field-ui` `grid-ui` `icon-ui` `stat-ui` `segment-ui` `input-ui` `progress-ui` `chart-ui` `nav-item-ui` `divider-ui` `list-ui` `select-ui` `tab-ui` `action-item-ui` `check-ui` `col-def` `table-ui` `integration-card-ui` `menu-item-ui` `segmented-ui` `switch-ui` `textarea-ui` `admin-page-body` `drawer-ui` `nav-group-ui` `tag-ui` `action-list-ui` `admin-page` `admin-page-header` `alert-ui` `code-ui` `heatmap-ui` `link-ui` `menu-ui` `nav-ui` `tabs-ui` `time-picker-ui`
   - source: `/apps/saas/app/admin-dashboard/admin-dashboard.contents.html` · demo: `/apps/saas/app/admin-dashboard/admin-dashboard.html` · docs: `/site/examples/admin-dashboard`
 
 ### data-table
@@ -392,7 +392,7 @@
 
 - **Conversion Funnel 6step** (Pattern Library) — Conversion funnel with 6 stages, stage labels, counts, and drop-off conversion percentages.
   - keywords: funnel, conversion, analytics, stages, metrics, drop-off, rate, marketing
-  - components: `progress-row-ui` `text-ui` `col-ui` `card-ui` `row-ui`
+  - components: `progress-ui` `text-ui` `col-ui` `card-ui` `row-ui`
   - source: `/catalog/ui-patterns/app/conversion-funnel-6step/conversion-funnel-6step.contents.html` · demo: `/catalog/ui-patterns/app/conversion-funnel-6step/conversion-funnel-6step.html` · docs: `/site/examples/patterns/conversion-funnel-6step`
 - **Email Inbox List** (Pattern Library) — Email inbox list — scrollable list of email rows with sender avatar, subject, preview snippet, timestamp, and unread badge indicator. List-item-ui rows with dividers.
   - keywords: email, inbox, list, message, unread, sender, subject, preview, timestamp, avatar
@@ -400,7 +400,7 @@
   - source: `/catalog/ui-patterns/app/email-inbox-list/email-inbox-list.contents.html` · demo: `/catalog/ui-patterns/app/email-inbox-list/email-inbox-list.html` · docs: `/site/examples/patterns/email-inbox-list`
 - **Import Mapping** (Pattern Library) — Multi-step CSV/file import flow — upload, field mapping (source columns ↔ target fields), preview, import. Shows the field-mapping step prominently since it's the part most often m
   - keywords: import, csv, upload, mapping, fields, columns, bulk, data, migration
-  - components: `text-ui` `col-ui` `icon-ui` `grid-ui` `list-item-ui` `select-ui` `button-ui` `avatar-ui` `card-ui` `row-ui` `alert-ui` `badge-ui`
+  - components: `text-ui` `col-ui` `icon-ui` `grid-ui` `list-item-ui` `select-ui` `button-ui` `avatar-ui` `card-ui` `row-ui` `alert-ui` `badge-ui` `list-ui` `step-progress-ui` `table-ui`
   - source: `/catalog/ui-patterns/app/import-mapping/import-mapping.contents.html` · demo: `/catalog/ui-patterns/app/import-mapping/import-mapping.html` · docs: `/site/examples/patterns/import-mapping`
 - **Invoice Line Items** (Pattern Library) — Invoice table with line items, quantities, unit prices, and total row. Card with invoice header, item rows, subtotal, tax, and total due.
   - keywords: invoice, table, line, items, quantities, totals, billing, amount, price, quantity
@@ -432,7 +432,7 @@
   - source: `/catalog/ui-patterns/app/users-table-badge/users-table-badge.contents.html` · demo: `/catalog/ui-patterns/app/users-table-badge/users-table-badge.html` · docs: `/site/examples/patterns/users-table-badge`
 - **Data Blocks** (Pattern Library) — Real-time metrics dashboard with live counter cards, streaming line chart, error-rate progress, and last-updated timestamp.
   - keywords: real-time, metrics, live, dashboard, streaming, counters, charts, websocket, telemetry, monitoring
-  - components: `text-ui` `col-ui` `row-ui` `card-ui` `button-ui` `icon-ui` `progress-ui` `col-def` `badge-ui` `chart-ui` `description-list-ui` `grid-ui`
+  - components: `text-ui` `col-ui` `row-ui` `card-ui` `button-ui` `icon-ui` `progress-ui` `col-def` `badge-ui` `chart-ui` `description-list-ui` `grid-ui` `table-ui` `tag-ui`
   - source: `/catalog/ui-patterns/v050-data-blocks/v050-data-blocks.contents.html` · demo: `/catalog/ui-patterns/v050-data-blocks/v050-data-blocks.html` · docs: `/site/examples/patterns/v050-data-blocks`
 - **Chart With Filter Pills** (Pattern Library) — Chart card with time-range pill selector in the header — segmented switch between day/week/month/year + chart body + footer caption.
   - keywords: chart, filter, pills, time-range, segmented, period, selector, analytics, dashboard, card
@@ -467,7 +467,7 @@
   - source: `/catalog/ui-patterns/app/survey-rating-form/survey-rating-form.contents.html` · demo: `/catalog/ui-patterns/app/survey-rating-form/survey-rating-form.html` · docs: `/site/examples/patterns/survey-rating-form`
 - **Form Blocks** (Pattern Library) — File upload form with drag and drop zone and file list. Upload-ui with browse fallback, file-type hints, and max-size note.
   - keywords: file, upload, drag-and-drop, dnd, browse, attachments, form-input, drop, zone, file-list
-  - components: `field-ui` `button-ui` `col-ui` `text-ui` `input-ui` `row-ui` `card-ui` `tag-ui` `radio-ui` `calendar-picker-ui` `check-ui` `grid-ui`
+  - components: `field-ui` `button-ui` `col-ui` `text-ui` `input-ui` `row-ui` `card-ui` `tag-ui` `radio-ui` `calendar-picker-ui` `check-ui` `grid-ui` `icon-ui` `select-ui` `textarea-ui` `search-ui` `step-progress-ui` `time-picker-ui` `upload-ui`
   - source: `/catalog/ui-patterns/v050-form-blocks/v050-form-blocks.contents.html` · demo: `/catalog/ui-patterns/v050-form-blocks/v050-form-blocks.html` · docs: `/site/examples/patterns/v050-form-blocks`
 - **Accordion Settings** (Pattern Library) — Settings panel organized as accordion — expandable sections (profile / notifications / privacy / advanced) each containing form controls.
   - keywords: accordion, settings, collapsible, expandable, sections, preferences, profile, notifications, privacy
@@ -510,7 +510,7 @@
   - source: `/catalog/ui-patterns/app/testimonials-avatar-cards/testimonials-avatar-cards.contents.html` · demo: `/catalog/ui-patterns/app/testimonials-avatar-cards/testimonials-avatar-cards.html` · docs: `/site/examples/patterns/testimonials-avatar-cards`
 - **Marketing Blocks** (Pattern Library) — Two-column hero — left side heading + lede + CTA buttons; right side product image or media.
   - keywords: hero, split-hero, two-column, landing-page, heading, lede, media, product-image, cta
-  - components: `text-ui` `col-ui` `link-ui` `row-ui` `accordion-item-ui` `grid-ui` `avatar-ui` `button-ui` `card-ui` `icon-ui` `accordion-ui` `divider-ui`
+  - components: `text-ui` `col-ui` `link-ui` `row-ui` `accordion-item-ui` `grid-ui` `avatar-ui` `button-ui` `card-ui` `icon-ui` `accordion-ui` `divider-ui` `image-ui`
   - source: `/catalog/ui-patterns/v050-marketing-blocks/v050-marketing-blocks.contents.html` · demo: `/catalog/ui-patterns/v050-marketing-blocks/v050-marketing-blocks.html` · docs: `/site/examples/patterns/v050-marketing-blocks`
 - **Image Carousel** (Pattern Library) — Horizontal image carousel — current slide + peek of next/prev + dot indicators + autoplay-pause control.
   - keywords: carousel, slider, swiper, image-gallery, slides, photos, hero, rotator, paginated
@@ -579,7 +579,7 @@
   - source: `/apps/user-flow/app/onboarding/first-action/first-action.contents.html` · demo: `/apps/user-flow/app/onboarding/first-action/first-action.html` · docs: `/site/examples/onboarding/first-action`
 - **Review** (Onboarding) — 'Review your setup' onboarding step — summary of choices before finishing; reach for it as the pre-completion review step of onboarding.
   - keywords: summary, confirm, recap, verify, overview
-  - components: `text-ui` `button-ui` `field-ui` `option-card-ui` `col-ui` `avatar-ui` `drawer-ui` `grid-ui` `select-ui` `switch-ui` `divider-ui` `input-ui`
+  - components: `text-ui` `button-ui` `field-ui` `option-card-ui` `col-ui` `avatar-ui` `drawer-ui` `grid-ui` `select-ui` `switch-ui` `divider-ui` `input-ui` `textarea-ui` `adia-mark-ui` `alert-ui` `badge-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/onboarding/review/review.contents.html` · demo: `/apps/user-flow/app/onboarding/review/review.html` · docs: `/site/examples/onboarding/review`
 - **Notifications** (Onboarding) — Notification-preferences onboarding step — toggles for email and push channels; reach for it as the alert opt-in step of product onboarding.
   - keywords: preferences, alerts, email, push, opt-in
@@ -610,7 +610,7 @@
   - source: `/catalog/ui-patterns/app/destructive-confirm-modal/destructive-confirm-modal.contents.html` · demo: `/catalog/ui-patterns/app/destructive-confirm-modal/destructive-confirm-modal.html` · docs: `/site/examples/patterns/destructive-confirm-modal`
 - **Content Blocks** (Pattern Library) — Masonry image gallery — variable-height tiles in a column-flow grid with hover overlays.
   - keywords: masonry, gallery, images, photos, grid, variable-height, pinterest, tiles, overlays, lightbox
-  - components: `text-ui` `col-ui` `card-ui` `avatar-ui` `image-ui` `row-ui` `progress-ui` `col-def` `grid-ui` `timeline-item-ui` `avatar-group-ui` `badge-ui`
+  - components: `text-ui` `col-ui` `card-ui` `avatar-ui` `image-ui` `row-ui` `progress-ui` `col-def` `grid-ui` `timeline-item-ui` `avatar-group-ui` `badge-ui` `blockquote-ui` `description-list-ui` `rating-ui` `table-ui` `timeline-ui`
   - source: `/catalog/ui-patterns/v050-content-blocks/v050-content-blocks.contents.html` · demo: `/catalog/ui-patterns/v050-content-blocks/v050-content-blocks.html` · docs: `/site/examples/patterns/v050-content-blocks`
 - **Popover With Content** (Pattern Library) — Popover anchored to a trigger button, containing a small content panel with a heading + body text + close affordance.
   - keywords: popover, popup, overlay, anchor, trigger, content, tooltip, floating, panel, hint
@@ -669,19 +669,19 @@
   - source: `/apps/user-flow/app/registration/address/address.contents.html` · demo: `/apps/user-flow/app/registration/address/address.html` · docs: `/site/examples/registration/address`
 - **Brand scrape** (Registration) — 'Pull your brand' signup step — URL input that fetches logo/colors into preview cards; reach for it as the auto-brand-import step of signup.
   - keywords: logo, colors, website, url, theme
-  - components: `text-ui` `button-ui` `row-ui` `avatar-ui` `badge-ui` `card-ui` `icon-ui` `adia-mark-ui` `check-ui` `col-ui` `field-ui` `input-ui`
+  - components: `text-ui` `button-ui` `row-ui` `avatar-ui` `badge-ui` `card-ui` `icon-ui` `adia-mark-ui` `check-ui` `col-ui` `field-ui` `input-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/registration/brand-scrape/brand-scrape.contents.html` · demo: `/apps/user-flow/app/registration/brand-scrape/brand-scrape.html` · docs: `/site/examples/registration/brand-scrape`
 - **Support** (Registration) — Customer-support setup signup step — configure help channels and contacts; reach for it as an optional support-setup step of registration.
   - keywords: help, contact, channels, desk, service
-  - components: `text-ui` `card-ui` `icon-ui` `switch-ui` `field-ui` `segment-ui` `input-ui` `adia-mark-ui` `alert-ui` `button-ui` `check-ui` `col-ui`
+  - components: `text-ui` `card-ui` `icon-ui` `switch-ui` `field-ui` `segment-ui` `input-ui` `adia-mark-ui` `alert-ui` `button-ui` `check-ui` `col-ui` `divider-ui` `grid-ui` `segmented-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/registration/support/support.contents.html` · demo: `/apps/user-flow/app/registration/support/support.html` · docs: `/site/examples/registration/support`
 - **Departments** (Registration) — 'Set up your departments' signup step — add and name org departments; reach for it as the org-structure step of a multi-team registration.
   - keywords: teams, org, divisions, groups, units
-  - components: `check-ui` `text-ui` `button-ui` `row-ui` `tag-ui` `adia-mark-ui` `alert-ui` `col-ui` `divider-ui` `field-ui` `grid-ui` `input-ui`
+  - components: `check-ui` `text-ui` `button-ui` `row-ui` `tag-ui` `adia-mark-ui` `alert-ui` `col-ui` `divider-ui` `field-ui` `grid-ui` `input-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/registration/departments/departments.contents.html` · demo: `/apps/user-flow/app/registration/departments/departments.html` · docs: `/site/examples/registration/departments`
 - **Org review** (Registration) — 'Review your org chart' signup step — org-structure summary before finishing; reach for it as the org-confirmation step of registration.
   - keywords: organization, chart, structure, summary, hierarchy
-  - components: `text-ui` `button-ui` `row-ui` `avatar-ui` `badge-ui` `card-ui` `list-item-ui` `field-ui` `segment-ui` `icon-ui` `input-ui` `select-ui`
+  - components: `text-ui` `button-ui` `row-ui` `avatar-ui` `badge-ui` `card-ui` `list-item-ui` `field-ui` `segment-ui` `icon-ui` `input-ui` `select-ui` `adia-mark-ui` `check-ui` `drawer-ui` `list-ui` `segmented-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/registration/org-review/org-review.contents.html` · demo: `/apps/user-flow/app/registration/org-review/org-review.html` · docs: `/site/examples/registration/org-review`
 - **Personal** (Registration) — 'Round out your profile' signup step — extra personal-detail fields; reach for it as a profile-completion step of a registration wizard.
   - keywords: profile, details, bio, about, complete
@@ -696,23 +696,23 @@
 
 - **General** (Settings) — Workspace general-settings page — name, defaults, appearance, notifications, danger zone; reach for it as the primary settings surface.
   - keywords: workspace, preferences, configuration, account, defaults
-  - components: `divider-ui` `switch-ui` `field-ui` `check-ui` `button-ui` `card-ui` `stat-ui` `text-ui` `col-ui` `grid-ui` `input-ui` `theme-panel`
+  - components: `divider-ui` `switch-ui` `field-ui` `check-ui` `button-ui` `card-ui` `stat-ui` `text-ui` `col-ui` `grid-ui` `input-ui` `theme-panel` `alert-ui` `range-ui` `select-ui` `textarea-ui` `avatar-ui` `badge-ui` `drawer-ui`
   - source: `/apps/saas/app/settings-page/settings-page.contents.html` · demo: `/apps/saas/app/settings-page/settings-page.html` · docs: `/site/examples/settings-page`
 - **Billing** (Settings) — Billing settings sub-page — trial countdown, plan card with monthly/annual toggle, usage quotas; reach for it as the plan-and-usage tab.
   - keywords: subscription, plan, invoice, usage, quota
-  - components: `text-ui` `field-ui` `button-ui` `icon-ui` `input-ui` `row-ui` `card-ui` `col-ui` `divider-ui` `list-item-ui` `avatar-ui` `badge-ui`
+  - components: `text-ui` `field-ui` `button-ui` `icon-ui` `input-ui` `row-ui` `card-ui` `col-ui` `divider-ui` `list-item-ui` `avatar-ui` `badge-ui` `alert-ui` `grid-ui` `progress-ui` `drawer-ui` `radio-ui` `select-ui` `list-ui` `segment-ui` `stat-ui` `segmented-ui` `table-ui` `textarea-ui`
   - source: `/apps/saas/app/billing/billing.contents.html` · demo: `/apps/saas/app/billing/billing.html` · docs: `/site/examples/billing`
 - **Members** (Settings) — Members settings sub-page — invite-by-email form plus an active roster table with roles; reach for it as the workspace people-management tab.
   - keywords: team, invite, roster, roles, seats
-  - components: `field-ui` `text-ui` `button-ui` `check-ui` `col-ui` `card-ui` `divider-ui` `avatar-ui` `badge-ui` `grid-ui` `input-ui` `row-ui`
+  - components: `field-ui` `text-ui` `button-ui` `check-ui` `col-ui` `card-ui` `divider-ui` `avatar-ui` `badge-ui` `grid-ui` `row-ui` `select-ui` `stat-ui` `switch-ui` `input-ui` `textarea-ui` `drawer-ui` `list-item-ui` `alert-ui` `description-list-ui` `list-ui` `modal-ui` `search-ui` `table-ui`
   - source: `/apps/saas/app/members/members.contents.html` · demo: `/apps/saas/app/members/members.html` · docs: `/site/examples/members`
 - **Integrations** (Settings) — Connected-apps settings sub-page — grid of third-party cards with per-app configure drawers; reach for it as the app-connections settings tab.
   - keywords: apps, connections, oauth, third-party, services
-  - components: `field-ui` `text-ui` `button-ui` `col-ui` `divider-ui` `input-ui` `switch-ui` `check-ui` `row-ui` `card-ui` `avatar-ui` `badge-ui`
+  - components: `field-ui` `text-ui` `button-ui` `col-ui` `divider-ui` `input-ui` `switch-ui` `check-ui` `row-ui` `card-ui` `avatar-ui` `badge-ui` `icon-ui` `grid-ui` `select-ui` `drawer-ui` `alert-ui` `list-item-ui` `stat-ui` `code-ui` `range-ui` `empty-state-ui` `list-ui`
   - source: `/apps/saas/app/integrations/integrations.contents.html` · demo: `/apps/saas/app/integrations/integrations.html` · docs: `/site/examples/integrations`
 - **Profile & Security** (Settings) — Profile-and-security settings sub-page — name/avatar fields, password change, 2FA setup, sessions; reach for it as the account-security tab.
   - keywords: account, password, 2fa, sessions, authentication
-  - components: `text-ui` `button-ui` `field-ui` `col-ui` `avatar-ui` `input-ui` `divider-ui` `row-ui` `card-ui` `code-ui` `icon-ui` `alert-ui`
+  - components: `text-ui` `button-ui` `field-ui` `col-ui` `avatar-ui` `input-ui` `divider-ui` `row-ui` `card-ui` `code-ui` `icon-ui` `alert-ui` `badge-ui` `grid-ui` `drawer-ui` `check-ui` `select-ui` `switch-ui` `otp-input-ui` `textarea-ui` `upload-ui`
   - source: `/apps/saas/app/profile-security/profile-security.contents.html` · demo: `/apps/saas/app/profile-security/profile-security.html` · docs: `/site/examples/profile-security`
 
 ### system-status
@@ -734,7 +734,7 @@
 
 - **Checkout success — 6-trait composed flow** (Trait compositions) — Checkout→success flow stitched from six independent traits — reach for it as the canonical place-order → success product moment.
   - keywords: place-order, payment, celebration, animation, ecommerce
-  - components: `list-item-ui` `text-ui` `field-ui` `switch-ui` `col-ui` `row-ui` `button-ui` `input-ui` `list-ui` `stat-ui` `card-ui` `code-ui`
+  - components: `list-item-ui` `text-ui` `field-ui` `switch-ui` `col-ui` `row-ui` `button-ui` `input-ui` `list-ui` `stat-ui` `card-ui` `code-ui` `grid-ui` `tag-ui` `icon-ui`
   - source: `/playgrounds/composed-flow/app/composed-flow.contents.html` · demo: `/playgrounds/composed-flow/app/composed-flow.html` · docs: `/site/examples/composed-flow`
 
 ### workflow

package/skills/wave-coordination/SKILL.md

@@ -23,6 +23,8 @@ merges the parallel branches, into what, when a wave counts as done, how big
 a wave should be, or what happens when two screens edit the same
 shared-foundation file. The sections below are that written mechanics doc.
 
+Name check: `ui-architect` here is the shipped whole-deliverable coordinator (gh#1183) — NOT ADR-0040's Ladder-walker of the same name; before authoring, renaming, reusing, or citing any factory seat name — and whenever a document quotes the ADR-0040 roster (`ui-orchestrator · ui-architect · composer · data-wirer · ui-verifier`) or an interim name that has since moved (`screen-builder`, `consumer-reviewer`, `app-planner`) — load [references/seat-roster-names.md](references/seat-roster-names.md) (ADR-0047's disambiguation).
+
 ## The four questions this skill answers
 
 1. **Integration** — who merges each screen's branch, when, into what

package/skills/wave-coordination/references/seat-roster-names.md

@@ -0,0 +1,63 @@
+# Seat-roster names — which `ui-architect` this skill means, and which names not to reuse
+
+_Load before authoring, renaming, or citing any factory seat, or when a document quotes the
+ADR-0040 roster (`ui-orchestrator · ui-architect · composer · data-wirer · ui-verifier`).
+Answers one question: is the `ui-architect` in [SKILL.md](../SKILL.md) the `ui-architect`
+ADR-0040 chartered? **No** — and ADR-0047 is the record of why._
+
+## `ui-architect` means two things
+
+| Name | Charter | Status |
+| --- | --- | --- |
+| `ui-architect` — **the one this skill serves** (shipped gh#1183, 2026-08-12; `agents/ui-architect.md`) | Whole-deliverable coordinator: two-gear model, dispatches app-planning-agent / screen-composition-agent / surface-qa-agent, holds no Write/Edit, preloads this skill for GEAR 2. In ADR-0040's vocabulary this is the **`ui-orchestrator`** role. | Shipped. The name is an interim realization; a rename is a stated non-goal of the roster-completion spec (churn across a just-shipped seat, its routing corpus, and gh#1183's history) and the name is exempted in `naming.manifest.json`. |
+| `ui-architect` — **ADR-0040's** (accepted 2026-06-07) | "intent → domain → role → wireframe → plan; the 19-rung Reasoning Ladder" — the Ladder-walker. | Unbuilt as a seat. The Ladder rehomes to the planning side (app-planning-agent's Domain Plan block, roster-completion REQ-01/02); a fifth seat is rejected with evidence. |
+
+Every `ui-architect` in this skill is the first row — the coordinator whose GEAR-2 waves
+these mechanics govern. A reader who arrives from ADR-0040 must not read the Ladder-walker
+into it.
+
+## The rest of the ADR-0040 → shipped map
+
+ADR-0040's Phase-2 five-seat roster stays IN FORCE — not superseded; the shipped seats are
+interim realizations of it. Two rename waves sit between ADR-0047's record and today's
+agent files, so the map has three columns:
+
+| ADR-0040 name | Shipped as (the name ADR-0047 recorded) | Current agent name (post ADR-0011 D10, 2026-08-14) |
+| --- | --- | --- |
+| `ui-orchestrator` | `ui-architect` (gh#1183) | `ui-architect` — unchanged, exempted |
+| `ui-verifier` | `consumer-reviewer` | `surface-qa-agent` |
+| `composer` + `data-wirer` | merged into `screen-builder` | `screen-composition-agent` — the merge is ratified-as-measured (REQ-04); a re-split returns only on sweep evidence |
+| `ui-architect` (Ladder-walker) | — unbuilt | — (Ladder → app-planning-agent's Domain Plan, REQ-01/02) |
+| team patterns | partially, gh#1183's GEAR-2 wave model | this skill — REQ-05's authored home |
+
+## The rule for future seat authoring
+
+Read ADR-0047 before reusing ANY ADR-0040 roster name (`ui-orchestrator`, `ui-architect`,
+`composer`, `data-wirer`, `ui-verifier`) or any interim name that has since moved
+(`app-architect`/`app-planner`, `screen-composer`/`screen-builder`,
+`consumer-verifier`/`consumer-reviewer`) — the `ui-architect` collision is not to be
+repeated. A charter that should be dropped rather than built lands as an ADR superseding the
+relevant ADR-0047 clause, never as a silent edit; new seats trace to gh#1199's ticket spine
+(gh#1200's build tickets), not to fresh ad-hoc asks.
+
+## Grounding
+
+- [verified 2026-08-16] ADR-0047 — `docs/ops/adr/adr-0047-factory-five-seat-roster-in-force.md:14-28`
+  (context: the collision), `:34-49` (decision 1: roster in force + the seat map), `:64-70`
+  (consequences: read this ADR before reusing a name). Operator ruling gh#1199 option b,
+  2026-08-12.
+- [verified 2026-08-16] Roster-completion spec — `.claude/docs/specs/factory-roster-completion.md:9-13`
+  (single home for the unbuilt charters, gh#1200), `:31-59` (REQ-01/02: Ladder rehomes to
+  app-planning-agent, no fifth seat), `:80-91` (REQ-04: merge ratified-as-measured),
+  `:92-105` (REQ-05: team-pattern mechanics ride a skill in `ui-architect`'s preload — this
+  skill, gh#1210), `:123-131` (non-goals: no literal ADR-0040 `ui-architect` seat; no rename
+  of the shipped coordinator).
+- [verified 2026-08-16] Rename lineage, gen-ui-kit agent files — commit `0a28c68bf`
+  (2026-07-18: app-architect→app-planner, screen-composer→screen-builder,
+  consumer-verifier→consumer-reviewer) and `6a4fcd6ab` (2026-08-14, ADR-0011 D10:
+  app-planner→app-planning-agent, screen-builder→screen-composition-agent,
+  consumer-reviewer→surface-qa-agent; adia-waves→wave-coordination). `ui-architect`'s
+  exemption: `packages/plugins/adia-ui-factory/naming.manifest.json` `exemption_notes`.
+- [drift-prone] `factory-roster-completion.md` is `status: draft` (v0.1.1, 2026-08-13); the
+  "unbuilt" status of the Ladder-walker charter and the REQ-04 re-split question change as
+  gh#1200's build tickets land — re-read before quoting either.