--- name: ephemeral-generative-ui-architect description: "Master guide for Ephemeral Generative UI, real-time dynamic component streaming (React 19 RSC & Vercel AI SDK v4+), multi-widget layout orchestration, bidirectional action loops, sandboxed error boundaries, and affective adaptive interfaces / Panduan ahli arsitektur Generative UI efemeral, streaming komponen real-time (React 19 RSC & Vercel AI SDK v4+), orkestrasi layout multi-widget, loop aksi dua arah, dan antarmuka adaptif afektif." author: "Roedy Rustam" version: "4.4.2" --- # Ephemeral Generative UI Architect (2026 Sovereign Edition) [English](#english) | [Bahasa Indonesia](#bahasa-indonesia) --- ## English ### Executive Directive & Ephemeral UI Paradigm (2026 Shift) Traditional web applications render pre-compiled, static templates. Even modern AI chatbots largely output passive markdown text or static charts. In the Gemini 4 (fallback: Gemini 3.8 Flash) / Claude 5.5 (fallback: Claude Opus 4.6) / Muse Wonder era, this architecture is obsolete for high-agency coding and autonomous workflows. **Ephemeral Generative UI** is an architectural paradigm where interfaces are: 1. **Synthesized on-the-fly**: Generated dynamically based on the exact query context, underlying data topology, and user cognitive state. 2. **Streaming & Progressive**: Emitting immediate optimistic skeletons within milliseconds of the first tool token, progressively streaming numerical metrics, and hydrating into interactive widgets. 3. **Transient by Default**: Existing within the active conversation stream. Once a decision is finalized or the conversation context shifts, the widget collapses into an ultra-compact audit badge or archives into session checkpoints (`session-memory-manager`). 4. **Bidirectional & Actionable**: User interactions inside the generated widget (e.g., date selection, slider tweaks, form submissions) dispatch typed actions directly back into the LLM reasoning loop without page reloads. ### Orchestration & Integration - **Upstream AI Models & Transports**: `ai-llm-integration-expert`, `frontier-ai-models-expert`, `gemini-agent-booster`, `vercel-ai-sdk-expert`. - **Frontend Presentation & Layout**: `senior-frontend`, `nextjs-app-router-expert`, `design-system-architect`, `tailwind-expert`, `modern-css-native-expert`. - **Sovereign Quality & Anti-Slop**: `anti-slop`, `visual-ui-auditor`, `ui-ux-pro-max`, `structured-output-contracts`. - **Emotional & Cognitive Adaptation**: `affective-computing-emotion-ai`, `voice-ai-realtime-agent`. - **Lifecycle & Security**: `prompt-injection-firewall`, `session-memory-manager`, `zero-to-prod-orchestrator`. --- ### Core Architectural Topologies (The 5 Pillars) ``` ┌────────────────────────────────────────────────────────────────────────┐ │ TOPOLOGY FLOW: EPHEMERAL GENERATIVE UI │ ├────────────────────────────────────────────────────────────────────────┤ │ 1. LLM Tool Call ──► 2. Optimistic Skeleton () │ │ │ │ │ ▼ │ │ 3. Progressive StreamableValue ──► 4. Fully Hydrated Interactive RSC │ │ │ │ │ ▼ │ │ 5. User Interaction (Click/Slider) ──► 6. Typed Server Action Feedback │ │ │ │ │ ▼ │ │ 7. Next LLM Reasoning Turn (No Reload) │ └────────────────────────────────────────────────────────────────────────┘ ``` #### 1. Progressive Server-Streamed RSC (`createStreamableUI` + React 19) The server intercepts LLM tool invocations and immediately yields an optimistic skeleton to the client. As data resolves in parallel, streamable values pipe live numbers into the client, resolving to the full interactive component. #### 2. Client-Side Tool Invocation Dispatcher (`useChat` + `toolInvocations`) For high-scale, edge-rendered applications, LLM tool calls emit structured JSON payloads over the standard data stream (`createDataStreamResponse`). The client router dynamically resolves the component from a typed component registry with graceful degradation. #### 3. Dynamic Multi-Slot Layout Orchestration (AI Layout Engine) Rather than streaming isolated cards, the LLM emits a `LayoutManifest` (e.g., `split-master`, `masonry-grid`, `dashboard-3col`) and streams multiple widgets concurrently into declared layout slots (`headerSlot`, `primarySlot`, `secondarySlot`, `actionSlot`). #### 4. Closed-Loop Bidirectional Action Feedback Ephemeral components are not read-only. Clicking an option, sliding a value, or toggling a tab triggers a typed React 19 Server Action. This action updates the conversation state and re-invokes the agent pipeline with the user's explicit parameters. #### 5. Affective & Cognitive Adaptation Coordinates with `affective-computing-emotion-ai`. If the user's `AffectVector` indicates high cognitive load or frustration, the component engine automatically scales down visual clutter: - Switches from multi-tab dashboards to focused single-metric decision cards. - Increases typography scale and button hit-targets. - Suppresses animated transitions in favor of crisp, instant layout updates. --- ### Sovereign Visual Hierarchy & Anti-Slop Enforcement All ephemeral components must strictly comply with **Anti-Slop Pillar 7**: 1. **Container Grounding**: Enforce Level 1 Surface containers with crisp 1px borders: `bg-white dark:bg-neutral-900 border border-neutral-200/80 dark:border-neutral-800 rounded-xl shadow-xs overflow-hidden`. 2. **Three-Tier Radius Contract**: - `rounded-lg` (8px) for buttons, inputs, pills, and badges. - `rounded-xl` (12px) for card surfaces and widget panels. - `rounded-2xl` (16px) for root generative modals and sheets. 3. **Typographic Rhythm**: - Category Eyebrow: `text-[11px] font-semibold uppercase tracking-wider text-neutral-500 dark:text-neutral-400`. - Primary Heading: `text-base font-semibold tracking-tight text-neutral-900 dark:text-neutral-100`. - Data Values & Metrics: `font-mono text-xl font-bold tracking-tight text-neutral-950 dark:text-neutral-50 tabular-nums`. - Body & Supporting Context: `text-xs text-neutral-600 dark:text-neutral-300 leading-relaxed`. 4. **Mandatory 5-State Interactive Contract**: - Every interactive element within a generated widget MUST handle: `idle`, `hover`, `active`, `focus-visible`, and `disabled`/`loading`. 5. **Accessibility & Screen Reader Contracts**: - Wrap dynamic streaming slots with `role="region"` and `aria-live="polite"`. - Add `aria-busy="true"` while props are streaming; flip to `false` upon hydration completion. 6. **Anti-Slop Prohibitions**: - Zero generic purple-blue gradients (`bg-gradient-to-r from-purple-500 to-blue-500` is strictly banned). - Zero blurred floating neon orbs behind cards. - Zero pill buttons on rectangular card layouts (`rounded-full` is restricted to avatar rings and status indicator chips). --- ### Production Implementation Blueprints #### Blueprint 1: Progressive Server-Streamed RSC Dashboard (`app/actions/stream-dashboard.tsx`) ```tsx 'use server'; import { createStreamableUI, createStreamableValue } from 'ai/rsc'; import { google } from '@ai-sdk/google'; import { streamUI } from 'ai/rsc'; import { z } from 'zod'; import React from 'react'; interface MetricPayload { label: string; value: number; change: number; currency: string; } export async function streamFinancialAnalysis(ticker: string) { const ui = createStreamableUI(
); const metricStream = createStreamableValue({ label: ticker.toUpperCase(), value: 0, change: 0, currency: 'USD', }); (async () => { try { // Simulate sub-millisecond data retrieval metricStream.update({ label: ticker.toUpperCase(), value: 142.50, change: 1.25, currency: 'USD' }); await new Promise(resolve => setTimeout(resolve, 300)); metricStream.update({ label: ticker.toUpperCase(), value: 144.80, change: 2.85, currency: 'USD' }); await new Promise(resolve => setTimeout(resolve, 400)); metricStream.done({ label: ticker.toUpperCase(), value: 145.20, change: 3.12, currency: 'USD' }); ui.done(
Market Telemetry

{ticker.toUpperCase()} Equity Overview

Live Feed
Spot Price
$145.20
24h Alpha
+3.12%
); } catch (err: unknown) { const message = err instanceof Error ? err.message : 'Telemetry streaming failed'; ui.done(
Telemetry Error: {message}
); } })(); return { ui: ui.value, metrics: metricStream.value }; } ``` --- #### Blueprint 2: Client-Side Tool Invocation Registry & Component Dispatcher (`components/ephemeral/tool-registry.tsx`) ```tsx 'use client'; import React from 'react'; import { WidgetErrorBoundary } from './widget-error-boundary'; interface ToolInvocation { toolCallId: string; toolName: string; args: Record; state: 'call' | 'result'; result?: unknown; } interface RegistryProps { invocation: ToolInvocation; onActionSubmit?: (actionName: string, payload: Record) => Promise; } // 1. Shimmering Skeleton for Pending Tool Execution function ToolExecutionSkeleton({ toolName }: { toolName: string }) { return (
Synthesizing Interface: {toolName}
); } // 2. Concrete Interactive Tool: Seat Picker Widget function FlightSeatPickerWidget({ data, onSelectSeat, }: { data: { flightNumber: string; route: string; availableSeats: string[]; basePrice: number }; onSelectSeat?: (seat: string) => void; }) { const [selected, setSelected] = React.useState(null); const handleConfirm = () => { if (selected && onSelectSeat) { onSelectSeat(selected); } }; return (
Interactive Selector

Flight {data.flightNumber} ({data.route})

From ${data.basePrice}
Select Preferred Seat:
{data.availableSeats.map((seat) => ( ))}
Selected: {selected || 'None'}
); } // 3. Central Dispatcher export function ToolRegistryDispatcher({ invocation, onActionSubmit }: RegistryProps) { if (invocation.state === 'call') { return ; } return ( {invocation.toolName === 'pickFlightSeat' && ( onActionSubmit?.('confirmSeat', { seat, flightNumber: (invocation.args as { flightNumber?: string }).flightNumber })} /> )} ); } ``` --- #### Blueprint 3: Self-Healing Error Boundary Sandbox (`components/ephemeral/widget-error-boundary.tsx`) ```tsx 'use client'; import React, { Component, ErrorInfo, ReactNode } from 'react'; interface Props { children: ReactNode; toolName: string; } interface State { hasError: boolean; errorMessage: string; } export class WidgetErrorBoundary extends Component { public state: State = { hasError: false, errorMessage: '', }; public static getDerivedStateFromError(error: Error): State { return { hasError: true, errorMessage: error.message }; } public componentDidCatch(error: Error, errorInfo: ErrorInfo) { console.error(`[Ephemeral-UI] Failed rendering widget '${this.props.toolName}':`, error, errorInfo); } public render() { if (this.state.hasError) { return (
Widget Rendering Fallback {this.props.toolName}

The AI-synthesized interface encountered a runtime schema mismatch: {this.state.errorMessage}

); } return this.props.children; } } ``` --- #### Blueprint 4: Multi-Slot Adaptive Grid Container (`components/ephemeral/multi-widget-grid.tsx`) ```tsx 'use client'; import React from 'react'; export type LayoutArchetype = 'single-card' | 'split-master' | 'dashboard-3col' | 'timeline-feed'; interface MultiWidgetGridProps { archetype: LayoutArchetype; headerSlot?: React.ReactNode; primarySlot: React.ReactNode; secondarySlot?: React.ReactNode; actionSlot?: React.ReactNode; } export function MultiWidgetGrid({ archetype, headerSlot, primarySlot, secondarySlot, actionSlot, }: MultiWidgetGridProps) { return (
{headerSlot &&
{headerSlot}
} {archetype === 'single-card' && (
{primarySlot}
)} {archetype === 'split-master' && (
{primarySlot}
{secondarySlot}
)} {archetype === 'dashboard-3col' && (
{primarySlot}
{secondarySlot}
{actionSlot}
)} {archetype === 'timeline-feed' && (
{primarySlot} {secondarySlot}
)} {actionSlot && archetype !== 'dashboard-3col' && (
{actionSlot}
)}
); } ``` --- ### Latency Budget & Production Hardening - **TTFS (Time to First Skeleton)**: Under **100ms**. The moment an LLM generates a tool call opening token, stream the corresponding placeholder skeleton immediately. - **Hydration Target**: Under **450ms** from stream completion to interactive readiness. - **Input Sanitization**: All props supplied by the LLM MUST be strictly validated via Zod schemas before passing to client components to prevent indirect prompt injection (`prompt-injection-firewall`). - **Memory Hygiene**: Ephemeral components must clean up active polling subscriptions or event listeners when removed from the DOM. - **Model Availability Fallback**: If streaming structured UI manifests via Gemini 4 or Claude Opus 5.5, maintain seamless failover to Gemini 3.8 Flash and Claude Opus 4.6 to safeguard <100ms TTFS. ### Sovereign Execution, Token Efficiency & Invariants | Dimension | Sovereign Mandate & Deterministic Contract | | :--- | :--- | | **Frontier Model Cascade** | Medium / High (`Gemini 4 Argon`, `Claude Sonnet 5.5 High`, `Muse Wonder High`, `Composer 2.5 Fast`) | | **Availability Fallback** | `Gemini 4 Argon/Pro` -> `Gemini 3.8 Flash`; `Claude Opus 5.5` -> `Claude Opus 4.6` (Zero unhandled missing-model errors) | | **KV-Cache & Token Protocol** | Pin static instructions & schemas at prompt prefix (`kv-cache-prefix-optimizer`); pass surgical `CONTEXT_MAP.md` slices (<250 tokens/call) during Swarm Fan-Out | | **SaaT CLI & MCP Dispatch** | CLI: `vibes skill exec ephemeral-generative-ui-architect ` / MCP: `vibes_skill_dispatch`, `vibes_visual_audit`, `vibes_ast_query`, `vibes_verify_gate` | | **NFR & Anti-Slop Invariants** | LCP < 1.8s, INP < 100ms, CLS < 0.05, 1px crisp borders, 3-tier radius (6px/8px/12px), `tabular-nums`, 5-state interactive contract; 100% complete zero-placeholder output verified via `node scripts/check-anti-slop.js --strict` | --- --- ## Bahasa Indonesia ### Direktif Eksekutif & Paradigma UI Efemeral (Pergeseran 2026) Aplikasi web konvensional merender template statis yang telah dikompilasi sebelumnya. Bahkan chatbot AI modern sebagian besar masih menghasilkan teks markdown pasif atau diagram statis. Di era Gemini 4 (fallback: Gemini 3.8 Flash) / Claude 5.5 (fallback: Claude Opus 4.6) / Muse Wonder, arsitektur ini sudah usang untuk kebutuhan coding tingkat lanjut dan alur kerja agen otonom. **Generative UI Efemeral** adalah paradigma arsitektur di mana antarmuka: 1. **Disintesis Secara Instan (On-the-fly)**: Dihasilkan secara dinamis berdasarkan konteks kueri pengguna, topologi data yang mendasari, dan beban kognitif pengguna. 2. **Streaming & Progresif**: Mengeluarkan kerangka pemuatan (*skeleton*) optimistik dalam hitungan milidetik dari token alat pertama, melakukan streaming metrik angka secara bertahap, dan menghidrasi komponen interaktif. 3. **Fana (Transient) Secara Bawaan**: Hidup di dalam aliran percakapan aktif. Begitu keputusan diambil atau konteks berpindah, widget menyusut menjadi lencana audit ringkas atau diarsipkan ke checkpoint sesi (`session-memory-manager`). 4. **Dua Arah & Dapat Dioperasikan (Bidirectional)**: Interaksi pengguna di dalam widget (memilih tanggal, menggeser slider harga, mengisi formulir) mengirimkan aksi bertipe kembali ke loop penalaran LLM tanpa *refresh* halaman. ### Integrasi Orkestrasi - **Model AI Hulu & Protokol Transport**: `ai-llm-integration-expert`, `frontier-ai-models-expert`, `gemini-agent-booster`, `vercel-ai-sdk-expert`. - **Presentasi Frontend & Tata Letak**: `senior-frontend`, `nextjs-app-router-expert`, `design-system-architect`, `tailwind-expert`, `modern-css-native-expert`. - **Standar Kualitas & Anti-Slop**: `anti-slop`, `visual-ui-auditor`, `ui-ux-pro-max`, `structured-output-contracts`. - **Adaptasi Emosional & Kognitif**: `affective-computing-emotion-ai`, `voice-ai-realtime-agent`. - **Siklus Hidup & Keamanan**: `prompt-injection-firewall`, `session-memory-manager`, `zero-to-prod-orchestrator`. --- ### 5 Topologi Arsitektur UI Efemeral ``` ┌────────────────────────────────────────────────────────────────────────┐ │ ALUR TOPOLOGI: GENERATIVE UI EFEMERAL 2026 │ ├────────────────────────────────────────────────────────────────────────┤ │ 1. Pemanggilan Alat LLM ──► 2. Skeleton Optimis () │ │ │ │ │ ▼ │ │ 3. StreamableValue Progresif ──► 4. RSC Interaktif Terhidrasi Penuh │ │ │ │ │ ▼ │ │ 5. Interaksi User (Klik/Slider) ──► 6. Umpan Balik Server Action │ │ │ │ │ ▼ │ │ 7. Giliran Penalaran LLM Berikutnya │ └────────────────────────────────────────────────────────────────────────┘ ``` #### 1. Streaming RSC Progresif Server-Side (`createStreamableUI` + React 19) Server mencegat eksekusi alat LLM dan langsung memancarkan skeleton optimistik ke klien. Selama data diselesaikan secara paralel, nilai streamable memompa angka secara langsung, dan berakhir pada komponen interaktif yang utuh. #### 2. Dispatcher Pemanggilan Alat Sisi Klien (`useChat` + `toolInvocations`) Untuk aplikasi berskala tinggi pada edge node, pemanggilan alat LLM memancarkan payload JSON terstruktur melalui data stream standar (`createDataStreamResponse`). Router klien menyelesaikan komponen dari registri bertipe secara dinamis. #### 3. Orkestrasi Tata Letak Multi-Slot Dinamis (Mesin Layout AI) Alih-alih men-streaming satu kartu terisolasi, LLM memancarkan manifes tata letak (`LayoutManifest`: *split-master*, *masonry-grid*, *dashboard-3col*) dan men-streaming beberapa widget secara bersamaan ke slot yang ditentukan (`headerSlot`, `primarySlot`, `secondarySlot`, `actionSlot`). #### 4. Loop Aksi Umpan Balik Tertutup (Closed-Loop Feedback) Komponen efemeral tidak bersifat *read-only*. Mengklik opsi atau menggeser nilai memicu Server Action React 19 bertipe yang memperbarui state percakapan dan memicu kembali pipeline agen tanpa kehilangan konteks aliran. #### 5. Adaptasi Afektif & Kognitif Terkoneksi dengan `affective-computing-emotion-ai`. Jika `AffectVector` pengguna mendeteksi kebingungan atau stres tinggi, mesin antarmuka menyederhanakan kepadatan visual: - Beralih dari multi-tab kompleks ke kartu fokus keputusan metrik tunggal. - Memperbesar ukuran teks dan target sentuh tombol. - Menonaktifkan animasi transisi agar tata letak tampil instan dan jernih. --- ### Kontrak Hierarki Visual Anti-Slop pada UI Efemeral Seluruh komponen efemeral wajib mematuhi **Pilar 7 Anti-Slop**: 1. **Pembatasan Kontainer Permukaan**: Bungkus widget dalam wadah Level 1 dengan border 1px yang tegas: `bg-white dark:bg-neutral-900 border border-neutral-200/80 dark:border-neutral-800 rounded-xl shadow-xs overflow-hidden`. 2. **Skala Radius 3-Tingkat**: - `rounded-lg` (8px) untuk tombol, input, dan badge. - `rounded-xl` (12px) untuk permukaan kartu dan panel widget. - `rounded-2xl` (16px) untuk wadah modal dan sheet generatif utama. 3. **Irama Tipografi Baku**: - Eyebrow Kategori: `text-[11px] font-semibold uppercase tracking-wider text-neutral-500 dark:text-neutral-400`. - Judul Utama: `text-base font-semibold tracking-tight text-neutral-900 dark:text-neutral-100`. - Nilai Metrik & Saldo: `font-mono text-xl font-bold tracking-tight text-neutral-950 dark:text-neutral-50 tabular-nums`. - Teks Pendukung: `text-xs text-neutral-600 dark:text-neutral-300 leading-relaxed`. 4. **Kontrak 5-State Interaktif Wajib**: - Setiap elemen interaktif wajib menangani: `idle`, `hover`, `active`, `focus-visible`, dan `disabled`/`loading`. 5. **Aksesibilitas & Pembaca Layar**: - Bungkus slot streaming dengan atribut `role="region"` dan `aria-live="polite"`. - Gunakan `aria-busy="true"` selama fase streaming, dan ubah ke `false` setelah hidrasi selesai. 6. **Larangan Slop Visual**: - Dilarang keras menggunakan gradien ungu-biru generik AI. - Dilarang menampilkan orb neon blur di belakang kartu. - Dilarang memakai tombol pil (`rounded-full`) pada tata letak kartu persegi panjang standar. --- ### Verifikasi, Latensi & Keamanan - **TTFS (Waktu ke Skeleton Pertama)**: Maksimal **100ms** sejak token pembuka pemanggilan alat dipancarkan. - **Target Hidrasi**: Maksimal **450ms** sejak aliran stream tuntas hingga komponen siap berinteraksi. - **Sanitasi Input**: Seluruh argumen dari LLM WAJIB divalidasi dengan skema Zod sebelum diteruskan ke komponen klien guna menangkal injeksi prompt tidak langsung (`prompt-injection-firewall`). - **Kebersihan Memori**: Komponen efemeral wajib membersihkan *event listener* atau langganan aktif saat dicopot dari DOM. - **Fallback Ketersediaan Model**: Jika men-streaming manifes UI terstruktur melalui Gemini 4 atau Claude Opus 5.5, alihkan secara otomatis ke Gemini 3.8 Flash dan Claude Opus 4.6 untuk mempertahankan TTFS <100ms. ### Matriks Eksekusi Berdaulat, Efisiensi Token & Invarian | Dimensi | Mandat Berdaulat & Kontrak Deterministik | | :--- | :--- | | **Kaskade Model Frontier** | Medium / High (`Gemini 4 Argon`, `Claude Sonnet 5.5 High`, `Muse Wonder High`, `Composer 2.5 Fast`) | | **Invarian Fallback Ketersediaan** | `Gemini 4 Argon/Pro` -> `Gemini 3.8 Flash`; `Claude Opus 5.5` -> `Claude Opus 4.6` (Bebas gagal saat model belum tersedia/kuota penuh) | | **Protokol Hemat Token & KV-Cache** | Kunci instruksi & skema statis di prefix awal (`kv-cache-prefix-optimizer`); kirim potongan `CONTEXT_MAP.md` (<250 token/panggilan) saat Fan-Out | | **Eksekusi SaaT CLI & MCP** | CLI: `vibes skill exec ephemeral-generative-ui-architect ` / MCP: `vibes_skill_dispatch`, `vibes_visual_audit`, `vibes_ast_query`, `vibes_verify_gate` | | **Invarian NFR & Anti-Slop** | LCP < 1.8s, INP < 100ms, CLS < 0.05, border tegas 1px, radius 3-tier (6px/8px/12px), `tabular-nums`, kontrak interaktif 5-state; kode 100% tuntas tanpa placeholder diverifikasi melalui `node scripts/check-anti-slop.js --strict` |