v4.4.2 to v4.7.0

364 added, 2 removed. Audit A to A.

---

name: senior-frontend

- description: "Frontend development for React 19, Next.js 15, TypeScript, and Tailwind CSS v4 / Pengembangan frontend dengan React 19, Next.js 15, TypeScript, dan Tailwind CSS v4."

+ description: "Senior frontend: React 19, Next.js 15, TypeScript, and Tailwind v4 / Frontend tingkat lanjut: React 19, Next.js 15, dan Tailwind v4."

author: "Roedy Rustam"

- version: "4.4.2"

+ version: "4.7.0"

---

# Senior Frontend Specialist (2026 Edition)

[English](#english) | [Bahasa Indonesia](#bahasa-indonesia)

---

## English

### Description

Production-grade frontend development patterns, performance optimization, and modern ecosystem integrations for React 19 / Next.js 15 applications with Tailwind CSS v4 and TypeScript. Covers React 19 Compiler, Partial Prerendering (PPR), View Transitions API, and SPA/MPA hybrid strategies with automated self-healing testing loops.

### Orchestration & Integration

- `modern-web-guidance`: For HTML5/CSS standards, modern browser APIs, and accessibility guidelines.

- `design-system-architect`: For building robust UI components (Radix, Base UI, shadcn) and design tokens.

- `modern-css-native-expert`: For native CSS anchor positioning, View Transitions, container queries, and `@starting-style`.

- `tailwind-expert`: For styling and custom @theme configurations.

- `ui-ux-pro-max`: For UI/UX design intelligence, color harmonies, and 11-stack layout patterns.

- `visual-ui-auditor`: For multimodal vision inspection of rendered interfaces and layout fidelity.

- `svg-animation-motion-expert`: For advanced animations, GSAP timelines, and motion physics.

- `nextjs-app-router-expert`: For RSC, caching, and Next.js routing patterns.

- `state-management-expert`: For client-side state (Zustand, Jotai).

- `tanstack-query-expert`: For advanced data fetching and server state caching.

- `spa-orchestrator`: For Single-Page Application architectures.

- `mpa-orchestrator`: For Multi-Page Application architectures.

+ - `angular-expert` & `solidjs-expert`: For cross-framework enterprise Signals and fine-grained reactivity architectures.

- `autonomous-tdd-debugger`: For automated unit/component test execution and stack-trace self-healing.

- `anti-slop`: For enforcing complete, stub-free component implementations and zero syntax narration comments.

+ - **Cross-Domain Synergy & Subagent Swarm Integration**: `vue-frontend-expert`, `svelte-sveltekit-expert`, `astro-framework-expert`, `htmx-hypermedia-expert`, `micro-frontend-architect`, `fullstack-expert`, `rich-text-editor-expert`, `ephemeral-generative-ui-architect`

### Trigger Conditions

- Scaffold a new React or Next.js 15 project with TypeScript and Tailwind CSS v4.

- Generate new components, custom hooks, or Server Actions.

- Analyze and optimize bundle sizes and Core Web Vitals.

- Implement advanced React 19 patterns (`useActionState`, `useOptimistic`, `use()`).

- Build SPAs — coordinate with `spa-orchestrator`.

- Ensure accessibility compliance (WCAG 2.2) and testing.

### Technical Guidelines & Best Practices

#### 1. Next.js 15: Server vs Client Components

Use **Server Components** by default for performance and SEO. Use `'use client'` strictly for:

- State (`useState`, `useEffect`), event handlers (`onClick`), browser APIs.

- Interactive UI needing client hydration.

*Next.js 15.2+ Requirements:*

- Await `Promise`-based `params` and `searchParams` before accessing properties.

- Use **Partial Prerendering (PPR)** natively. Wrap dynamic sections in `<Suspense>`.

#### 2. React 19 Compiler & Hooks

Do not use `useMemo`, `useCallback`, or `React.memo` unless explicitly required; rely on the React 19 compiler.

**Mandatory Hooks:**

- **`useActionState`**: Manage form state, pending indicators, and action results with Server Actions.

- **`useOptimistic`**: Update UI instantly before server confirmation.

- **`useFormStatus`**: Read form submission state in child components.

- **`use(promise)`**: Unwrap promises or context inside render with Suspense.

#### 3. View Transitions API

Implement native View Transitions API for smooth page transitions. Use Next.js 15 `<Link viewTransition>` natively.

#### 4. Tailwind CSS v4

Use CSS-first configuration. Define custom tokens with `@theme` and register plugins with `@plugin` in the main CSS file. Never create `tailwind.config.js`.

#### 5. Accessibility (WCAG 2.2) & Self-Healing Testing

- Enforce semantic HTML (`<button>`, `<nav>`, `<main>`, `<article>`).

- Enforce full keyboard navigability and valid `aria-*` labels.

- Run typecheck (`tsc --noEmit`) to verify zero compiler diagnostics.

- Write unit tests using **Vitest** and **React Testing Library**.

- When tests fail, activate `autonomous-tdd-debugger` to self-heal until 100% passing.

#### 6. Architecture Integration

- **SPA (`spa-orchestrator`)**: Use **TanStack Router** for type-safe client routing and **TanStack Query v5** for server state. Never use bare `useEffect` for data fetching.

- **MPA (`mpa-orchestrator`)**: Use **Alpine.js** or **HTMX** for micro-interactions. Apply Progressive Enhancement.

#### 7. Animations & Motion

For web animations, scroll-driven timelines, GSAP choreographies, and Framer Motion spring physics, delegate directly to `svg-animation-motion-expert`.

#### 8. Material Design 3 (M3) Web Integration (https://m3.material.io/)

In modern React 19 / Next.js 15 apps, incorporate Google's official Material Web Components (`@material/web`) or token-mapped headless primitives:

- **Material Web Components**: Use Lit-based web components (`@material/web/button/filled-button.js`, `@material/web/textfield/outlined-text-field.js`) with React 19 native custom element support.

- **Dynamic CSS Variable Theming**: Map tokens dynamically at the root.

#### 9. Sovereign Visual Hierarchy & Scanability Engineering

Every React 19 / Next.js 15 view must demonstrate Linear/Apple-caliber visual hierarchy:

- **Typographic Cadence**: Eyebrows (`text-[11px] font-semibold tracking-wider uppercase text-neutral-500`) -> Hero Titles (`text-3xl md:text-5xl font-bold tracking-tight text-neutral-900 leading-[1.1]`) -> Section Headings (`text-xl md:text-2xl font-semibold tracking-tight`) -> Body (`text-sm md:text-base text-neutral-600 leading-relaxed`).

- **Tabular Figures**: Always wrap metrics, currency, and counters in `tabular-nums`.

- **Single Focal CTA**: Exactly one high-contrast primary button per screen view; secondary actions use subtle/outline treatments.

- **Gestalt Proximity**: Related controls sit within `gap-1.5` (6px); distinct groups sit at `space-y-4` (16px); section boundaries use generous whitespace (`py-16 md:py-24`).

- **Crisp 1px Surface Layering**: Pair `border border-neutral-200/80 dark:border-neutral-800` with subtle directional `shadow-xs` instead of blurry 30px drop-shadows.

```tsx

// Example: Production Component with Sovereign Visual Hierarchy

import { ArrowRight } from 'lucide-react';

interface MetricBannerProps {

category: string;

title: string;

metricValue: string;

metricLabel: string;

onPrimaryAction: () => void;

onSecondaryAction?: () => void;

}

export function MetricBanner({

category,

title,

metricValue,

metricLabel,

onPrimaryAction,

onSecondaryAction,

}: MetricBannerProps) {

return (

{/* Eyebrow: Context landmark with optical tracking */}

{category}

</span>

{/* Title: Punchy authority with tight tracking */}

{title}

</h1>

{/* Metric block with tabular numerals to eliminate horizontal jitter */}

{metricValue}

</span>

{metricLabel}

</span>

</div>

{/* Actions: Single primary CTA dominance + subtle ghost action */}

<button

type="button"

onClick={onPrimaryAction}

className="cursor-pointer inline-flex items-center gap-2 rounded-lg bg-neutral-900 dark:bg-neutral-100 px-4 py-2 text-sm font-medium text-white dark:text-neutral-900 transition hover:bg-neutral-800 dark:hover:bg-white active:scale-[0.98] focus-visible:ring-2 focus-visible:ring-neutral-900 focus-visible:ring-offset-2"

Deploy Pipeline

</button>

{onSecondaryAction && (

<button

type="button"

onClick={onSecondaryAction}

className="cursor-pointer rounded-lg px-4 py-2 text-sm font-medium text-neutral-600 dark:text-neutral-400 transition hover:text-neutral-900 dark:hover:text-neutral-100 hover:bg-neutral-100 dark:hover:bg-neutral-800 focus-visible:ring-2 focus-visible:ring-neutral-400"

View Documentation

</button>

)}

</div>

</section>

);

}

```

+ #### 10. Non-Generic Website Navigation: Floating Island Capsule Header & Mega Menu Flyouts

+ Modern production websites must avoid generic edge-to-edge glued navbar templates. Implement the **Floating Island Capsule Header** with rich **Flyout Card Mega Menus**:

+ ```tsx

+ 'use client';

+ import { useState, useRef, useEffect } from 'react';

+ import Link from 'next/link';

+ import { Layers, Cpu, ShieldCheck, Zap, ChevronDown, Menu, X } from 'lucide-react';

+ interface SubMenuItem {

+ title: string;

+ description: string;

+ href: string;

+ icon: typeof Layers;

+ }

+ const SKILL_CATEGORIES: { category: string; items: SubMenuItem[] }[] = [

+ {

+ category: 'Architecture & Swarm',

+ items: [

+ { title: 'Zero-to-Prod Orchestrator', description: '8-phase autonomous software lifecycle pipeline', href: '/skills/orchestrator', icon: Layers },

+ { title: 'Frontier AI & MCP Engine', description: 'Model Context Protocol v1.x with dynamic routing', href: '/skills/mcp', icon: Cpu }

+ ]

+ },

+ {

+ category: 'Security & Quality Gate',

+ items: [

+ { title: 'Sovereign Anti-Slop', description: 'Zero-placeholder code & Linear-caliber UI craft', href: '/skills/anti-slop', icon: ShieldCheck },

+ { title: 'Micro-TDD Compiler', description: 'Sub-15ms in-memory contract verification hot-loop', href: '/skills/tdd', icon: Zap }

+ ]

+ }

+ ];

+ export function FloatingIslandCapsuleHeader() {

+ const [openDropdown, setOpenDropdown] = useState<string | null>(null);

+ const [mobileMenuOpen, setMobileMenuOpen] = useState(false);

+ const navRef = useRef<HTMLElement>(null);

+ useEffect(() => {

+ function handleClickOutside(e: MouseEvent) {

+ if (navRef.current && !navRef.current.contains(e.target as Node)) {

+ setOpenDropdown(null);

+ }

+ function handleKeyDown(e: KeyboardEvent) {

+ if (e.key === 'Escape') setOpenDropdown(null);

+ }

+ document.addEventListener('mousedown', handleClickOutside);

+ document.addEventListener('keydown', handleKeyDown);

+ return () => {

+ document.removeEventListener('mousedown', handleClickOutside);

+ document.removeEventListener('keydown', handleKeyDown);

+ };

+ }, []);

+ return (

+ <header className="fixed top-4 md:top-6 inset-x-0 mx-auto w-[calc(100%-2rem)] max-w-5xl z-50" ref={navRef}>

+ {/* Floating Pill Capsule Bar */}

+ <nav

+ aria-label="Main Navigation"

+ className="flex items-center justify-between rounded-full px-4 md:px-6 py-2.5 md:py-3 bg-neutral-950/80 backdrop-blur-xl saturate-180 border border-white/10 shadow-[0_20px_40px_-15px_rgba(0,0,0,0.5),inset_0_1px_0_rgba(255,255,255,0.12)]"

+ >

+ {/* Brand Logo */}

+ <Link href="/" className="flex items-center gap-2.5 text-white font-bold tracking-tight text-sm md:text-base">

+ <span className="w-7 h-7 rounded-full bg-cyan-500/10 border border-cyan-500/30 flex items-center justify-center text-cyan-400 text-xs">VP</span>

+ <span>Vibes<span className="text-cyan-400">Plug</span></span>

+ </Link>

+ {/* Desktop Nav Links & Flyout Triggers */}

+ <div className="hidden md:flex items-center gap-1">

+ <div className="relative">

+ <button

+ type="button"

+ onClick={() => setOpenDropdown(openDropdown === 'skills' ? null : 'skills')}

+ aria-expanded={openDropdown === 'skills'}

+ aria-haspopup="true"

+ className="inline-flex items-center gap-1 px-3.5 py-1.5 rounded-full text-xs font-medium text-neutral-300 hover:text-white hover:bg-white/5 transition-colors focus-visible:ring-2 focus-visible:ring-cyan-400"

+ >

+ Skills

+ <ChevronDown className={`w-3.5 h-3.5 transition-transform duration-200 ${openDropdown === 'skills' ? 'rotate-180' : ''}`} />

+ </button>

+ {/* Flyout Mega Menu Dropdown (Rich Floating Card) */}

+ {openDropdown === 'skills' && (

+ <div

+ role="menu"

+ className="absolute top-full left-1/2 -translate-x-1/2 mt-3.5 w-[640px] max-w-[calc(100vw-2rem)] rounded-2xl p-5 bg-[#090c15] border border-white/12 shadow-[0_25px_65px_-12px_rgba(0,0,0,0.95),0_0_35px_rgba(6,182,212,0.1)] animate-in fade-in slide-in-from-top-2 duration-150"

+ >

+ <div className="grid grid-cols-2 gap-4">

+ {SKILL_CATEGORIES.map((cat) => (

+ <div key={cat.category} className="space-y-2">

+ <span className="text-[10px] font-semibold tracking-wider uppercase text-neutral-500">{cat.category}</span>

+ <div className="space-y-1">

+ {cat.items.map((item) => {

+ const Icon = item.icon;

+ return (

+ <Link

+ key={item.title}

+ href={item.href}

+ role="menuitem"

+ onClick={() => setOpenDropdown(null)}

+ className="group flex items-start gap-3 p-2.5 rounded-xl hover:bg-white/5 transition-colors"

+ >

+ <div className="w-8 h-8 rounded-lg bg-white/5 border border-white/10 flex items-center justify-center text-cyan-400 group-hover:scale-105 transition-transform">

+ <Icon className="w-4 h-4" />

+ </div>

+ <div className="flex-1 min-w-0">

+ <p className="text-xs font-semibold text-white group-hover:text-cyan-400 transition-colors">{item.title}</p>

+ <p className="text-[11px] text-neutral-400 line-clamp-1">{item.description}</p>

+ </div>

+ </Link>

+ );

+ })}

+ </div>

+ ))}

+ </div>

+ )}

+ </div>

+ <Link href="#benchmarks" className="px-3.5 py-1.5 rounded-full text-xs font-medium text-neutral-300 hover:text-white hover:bg-white/5 transition-colors">

+ Benchmarks

+ </Link>

+ <Link href="#architecture" className="px-3.5 py-1.5 rounded-full text-xs font-medium text-neutral-300 hover:text-white hover:bg-white/5 transition-colors">

+ Architecture

+ </Link>

+ </div>

+ {/* CTA & Mobile Trigger */}

+ <div className="flex items-center gap-2">

+ <Link

+ href="/docs"

+ className="cursor-pointer inline-flex items-center justify-center px-4 py-1.5 rounded-full text-xs font-semibold text-neutral-950 bg-cyan-400 hover:bg-cyan-300 transition-colors shadow-sm"

+ >

+ Get Started

+ </Link>

+ <button

+ type="button"

+ onClick={() => setMobileMenuOpen(!mobileMenuOpen)}

+ aria-label="Toggle Navigation Menu"

+ className="md:hidden p-1.5 rounded-full text-neutral-300 hover:text-white hover:bg-white/5"

+ >

+ {mobileMenuOpen ? <X className="w-5 h-5" /> : <Menu className="w-5 h-5" />}

+ </button>

+ </div>

+ </nav>

+ </header>

+ );

+ }

+ ```

---

+ #### React 19 Optimistic Mutation & Server Action Form Hook (TypeScript)

+ ```tsx

+ 'use client';

+ import { useActionState, useOptimistic } from 'react';

+ export interface TaskItem {

+ id: string;

+ title: string;

+ completed: boolean;

+ }

+ export function OptimisticTaskList({

+ initialTasks,

+ toggleTaskAction

+ }: {

+ initialTasks: TaskItem[];

+ toggleTaskAction: (prevState: { error?: string }, formData: FormData) => Promise<{ error?: string }>;

+ }) {

+ const [state, formAction, isPending] = useActionState(toggleTaskAction, {});

+ const [optimisticTasks, addOptimisticToggle] = useOptimistic(

+ initialTasks,

+ (currentTasks, toggledId: string) =>

+ currentTasks.map((t) => (t.id === toggledId ? { ...t, completed: !t.completed } : t))

+ );

+ return (

+ <form

+ action={(formData) => {

+ const id = String(formData.get('taskId') ?? '');

+ addOptimisticToggle(id);

+ formAction(formData);

+ }}

+ className="space-y-2"

+ >

+ {state.error && <p className="text-xs font-medium text-red-600">{state.error}</p>}

+ {optimisticTasks.map((task) => (

+ <div

+ key={task.id}

+ className="flex items-center justify-between rounded-lg border border-neutral-200/80 dark:border-neutral-800 px-3 py-2"

+ >

+ <span className="text-sm font-medium text-neutral-900 dark:text-neutral-100">{task.title}</span>

+ <button

+ type="submit"

+ name="taskId"

+ value={task.id}

+ disabled={isPending}

+ className="cursor-pointer rounded-md border border-neutral-300 dark:border-neutral-700 px-2.5 py-1 text-xs font-medium tabular-nums transition hover:bg-neutral-100 dark:hover:bg-neutral-800 focus-visible:ring-2 focus-visible:ring-neutral-900 disabled:opacity-50"

+ >

+ {task.completed ? 'Done' : 'Mark Done'}

+ </button>

+ </div>

+ ))}

+ </form>

+ );

+ }

+ ```

+ #### React 19 `use()` Promise Streaming & View Transition Switcher (TSX)

+ ```tsx

+ 'use client';

+ import { use, startTransition, useState } from 'react';

+ export interface TelemetryPoint {

+ readonly id: string;

+ readonly region: string;

+ readonly latencyP99Ms: number;

+ readonly status: 'healthy' | 'degraded';

+ }

+ export function StreamingTelemetryPanel({

+ telemetryPromise

+ }: {

+ telemetryPromise: Promise<readonly TelemetryPoint[]>;

+ }) {

+ const rows = use(telemetryPromise);

+ const [selectedRegion, setSelectedRegion] = useState<string>('ALL');

+ const filtered = selectedRegion === 'ALL'

+ ? rows

+ : rows.filter((r) => r.region === selectedRegion);

+ function handleSelectRegion(region: string) {

+ startTransition(() => {

+ setSelectedRegion(region);

+ });

+ }

+ return (

+ <div className="rounded-xl border border-neutral-200/80 dark:border-neutral-800 bg-white dark:bg-neutral-950 p-4">

+ <div className="mb-3 flex items-center gap-2">

+ {['ALL', 'ap-southeast-1', 'us-east-1', 'eu-central-1'].map((region) => (

+ <button

+ key={region}

+ type="button"

+ onClick={() => handleSelectRegion(region)}

+ className="cursor-pointer rounded-lg border border-neutral-200 dark:border-neutral-800 px-3 py-1.5 text-xs font-medium transition hover:bg-neutral-100 dark:hover:bg-neutral-900 active:scale-[0.98] focus-visible:ring-2 focus-visible:ring-neutral-900"

+ >

+ {region}

+ </button>

+ ))}

+ </div>

+ <div className="divide-y divide-neutral-200/70 dark:divide-neutral-800">

+ {filtered.map((item) => (

+ <div key={item.id} className="flex items-center justify-between py-2.5 text-sm">

+ <span className="font-mono text-xs text-neutral-700 dark:text-neutral-300">{item.region}</span>

+ <span className="font-mono text-xs font-semibold tabular-nums text-neutral-900 dark:text-neutral-100">

+ {item.latencyP99Ms} ms

+ </span>

+ </div>

+ ))}

+ </div>

+ );

+ }

+ ```

+ #### Sovereign Enterprise Data Table with Tabular Numerals & Keyboard Navigation (TSX)

+ ```tsx

+ 'use client';

+ import { useState, type KeyboardEvent } from 'react';

+ export interface LedgerRow {

+ readonly id: string;

+ readonly invoiceNo: string;

+ readonly amountMinor: number;

+ readonly currency: string;

+ readonly settled: boolean;

+ }

+ export function SovereignLedgerTable({ rows }: { readonly rows: readonly LedgerRow[] }) {

+ const [focusedIndex, setFocusedIndex] = useState<number>(0);

+ function handleKeyDown(e: KeyboardEvent<HTMLTableSectionElement>) {

+ if (e.key === 'ArrowDown') {

+ e.preventDefault();

+ setFocusedIndex((prev) => Math.min(rows.length - 1, prev + 1));

+ } else if (e.key === 'ArrowUp') {

+ e.preventDefault();

+ setFocusedIndex((prev) => Math.max(0, prev - 1));

+ }

+ return (

+ <div className="overflow-hidden rounded-xl border border-neutral-200/80 dark:border-neutral-800 bg-white dark:bg-neutral-950">

+ <table className="w-full border-collapse text-left text-sm">

+ <thead>

+ <tr className="border-b border-neutral-200/80 dark:border-neutral-800 bg-neutral-50 dark:bg-neutral-900/50 text-xs font-medium uppercase tracking-wider text-neutral-500">

+ <th className="px-4 py-3">Invoice</th>

+ <th className="px-4 py-3">Status</th>

+ <th className="px-4 py-3 text-right">Amount</th>

+ </tr>

+ </thead>

+ <tbody onKeyDown={handleKeyDown} tabIndex={0} className="divide-y divide-neutral-200/60 dark:divide-neutral-800/70 focus:outline-none">

+ {rows.map((row, idx) => (

+ <tr

+ key={row.id}

+ aria-selected={idx === focusedIndex}

+ onClick={() => setFocusedIndex(idx)}

+ className="cursor-pointer transition hover:bg-neutral-50 dark:hover:bg-neutral-900/60 aria-selected:bg-neutral-100/80 dark:aria-selected:bg-neutral-900"

+ >

+ <td className="px-4 py-3 font-mono text-xs font-medium text-neutral-900 dark:text-neutral-100">{row.invoiceNo}</td>

+ <td className="px-4 py-3 text-xs text-neutral-600 dark:text-neutral-400">{row.settled ? 'Settled' : 'Pending'}</td>

+ <td className="px-4 py-3 text-right font-mono text-xs font-semibold tabular-nums text-neutral-900 dark:text-neutral-100">

+ {row.currency} {(row.amountMinor / 100).toFixed(2)}

+ </td>

+ </tr>

+ ))}

+ </tbody>

+ </table>

+ </div>

+ );

+ }

+ ```

+ ### 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 |

+ | **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

### Deskripsi

Pola pengembangan frontend tingkat produksi, optimasi performa, dan integrasi ekosistem modern untuk aplikasi React 19 / Next.js 15 dengan Tailwind CSS v4 dan TypeScript. Mencakup React 19 Compiler, Partial Prerendering (PPR), View Transitions API, dan strategi hybrid SPA/MPA dengan loop pengujian perbaikan mandiri (self-healing).

### Integrasi Orkestrasi

- `modern-web-guidance`: Untuk standar HTML5/CSS, API browser modern, dan pedoman aksesibilitas.

- `design-system-architect`: Untuk membangun komponen UI yang kuat (Radix, Base UI, shadcn) dan design token.

- `modern-css-native-expert`: Untuk CSS anchor positioning native, View Transitions, container queries, dan `@starting-style`.

- `tailwind-expert`: Untuk styling dan konfigurasi @theme kustom.

- `ui-ux-pro-max`: Untuk kecerdasan desain UI/UX, harmoni warna, dan pola layout lintas 11 stack.

- `visual-ui-auditor`: Untuk inspeksi vision multimodal terhadap antarmuka yang dirender dan fidelitas tata letak.

- `svg-animation-motion-expert`: Untuk animasi web, timeline GSAP, dan fisika spring.

- `nextjs-app-router-expert`: Untuk RSC, caching, dan pola routing Next.js.

- `state-management-expert`: Untuk state client-side (Zustand, Jotai).

- `tanstack-query-expert`: Untuk fetching data lanjutan dan caching server state.

- `spa-orchestrator`: Untuk arsitektur Single-Page Application.

- `mpa-orchestrator`: Untuk arsitektur Multi-Page Application.

- `autonomous-tdd-debugger`: Untuk eksekusi pengujian otomatis dan perbaikan mandiri berdasarkan stack trace terminal.

- `anti-slop`: Untuk penegakan implementasi komponen lengkap tanpa stub dan tanpa komentar narasi sintaksis.

+ - **Sinergi Lintas Domain & Integrasi Swarm Subagent**: `vue-frontend-expert`, `svelte-sveltekit-expert`, `solidjs-expert`, `angular-expert`, `astro-framework-expert`, `htmx-hypermedia-expert`, `micro-frontend-architect`, `fullstack-expert`, `rich-text-editor-expert`, `ephemeral-generative-ui-architect`

### Kondisi Pemicu

- Buat proyek React atau Next.js 15 baru dengan TypeScript dan Tailwind CSS v4.

- Buat komponen baru, custom hooks, atau Server Actions.

- Analisis dan optimalkan ukuran bundle dan Core Web Vitals.

- Terapkan pola React 19 lanjutan (`useActionState`, `useOptimistic`, `use()`).

- Bangun SPA — koordinasikan dengan `spa-orchestrator`.

- Pastikan kepatuhan aksesibilitas (WCAG 2.2) dan pengujian.

### Panduan Teknis & Praktik Terbaik

#### 1. Next.js 15: Server vs Client Components

Gunakan **Server Components** secara default. Gunakan `'use client'` hanya untuk:

- State (`useState`, `useEffect`), event handler, API browser.

- UI interaktif yang membutuhkan hidrasi klien.

*Persyaratan Next.js 15.2+:*

- Wajib `await` pada `params` dan `searchParams` yang kini bertipe `Promise`.

- Gunakan **Partial Prerendering (PPR)** secara native. Bungkus bagian dinamis dengan `<Suspense>`.

#### 2. React 19 Compiler & Hook Baru

Jangan gunakan `useMemo`, `useCallback`, atau `React.memo` kecuali sangat diperlukan; andalkan compiler React 19.

**Hook Wajib:**

- **`useActionState`**: Kelola state form, indikator loading, dan hasil action dengan Server Actions.

- **`useOptimistic`**: Perbarui UI secara instan sebelum server mengonfirmasi.

- **`useFormStatus`**: Baca status form di dalam komponen anak.

- **`use(promise)`**: Buka promise atau context langsung di dalam render dengan Suspense.

#### 3. View Transitions API

Terapkan View Transitions API bawaan browser untuk transisi halaman. Gunakan `<Link viewTransition>` pada Next.js 15.

#### 4. Tailwind CSS v4

Gunakan konfigurasi CSS-first. Definisikan token kustom dengan `@theme` dan plugin dengan `@plugin` di file CSS utama (lihat `tailwind-expert`). Jangan pernah membuat file `tailwind.config.js`.

#### 5. Aksesibilitas (WCAG 2.2) & Pengujian Self-Healing

- Wajib gunakan HTML semantik (`<button>`, `<nav>`, `<main>`).

- Wajib pastikan navigasi keyboard dengan label `aria-*` yang valid.

- Jalankan pemeriksaan tipe (`tsc --noEmit`) untuk memastikan nol eror diagnostik.

- Tulis pengujian unit dengan **Vitest** dan **React Testing Library**.

- Jika pengujian gagal, aktifkan `autonomous-tdd-debugger` untuk memulihkan kode hingga 100% lolos.

#### 6. Integrasi Arsitektur

- **SPA (`spa-orchestrator`)**: Gunakan **TanStack Router** untuk routing klien dan **TanStack Query v5** untuk server state. Jangan gunakan `useEffect` murni untuk fetching data.

- **MPA (`mpa-orchestrator`)**: Gunakan **Alpine.js** atau **HTMX** untuk interaksi mikro. Terapkan Progressive Enhancement.

#### 7. Animasi & Motion

Untuk animasi web, timeline scroll-driven, koreografi GSAP, dan fisika spring Framer Motion, delegasikan langsung ke `svg-animation-motion-expert`.

#### 8. Integrasi Web Material Design 3 (M3) (https://m3.material.io/)

Pada aplikasi React 19 / Next.js 15 modern, terapkan komponen web resmi Google (`@material/web`) atau primitif headless yang dipetakan ke token M3:

- **Komponen Material Web**: Manfaatkan komponen berbasis Lit (`@material/web`) yang didukung secara native oleh React 19 tanpa wrapper tambahan.

- **Theming Variabel CSS Dinamis**: Terapkan token M3 (`--md-sys-color-primary`, `--md-sys-color-surface-container`) pada elemen root untuk menjamin paritas kontras WCAG di seluruh komponen antarmuka.

#### 9. Rekayasa Hierarki Visual & Kemampuan Pindai

Setiap tampilan React 19 / Next.js 15 wajib memancarkan hierarki visual kaliber Stripe/Linear:

- **Irama Tipografi**: Eyebrow (`text-[11px] font-semibold tracking-wider uppercase text-neutral-500`) -> Judul Utama (`text-3xl md:text-5xl font-bold tracking-tight text-neutral-900 leading-[1.1]`) -> Subjudul (`text-xl md:text-2xl font-semibold tracking-tight`) -> Body (`text-sm md:text-base text-neutral-600 leading-relaxed`).

- **Angka Tabular Wajib**: Selalu terapkan `tabular-nums` pada metrik, saldo mata uang, dan pencacah data.

- **Dominasi Single Primary CTA**: Maksimal satu tombol utama kontras tinggi per layar; aksi sekunder menggunakan gaya subtle/outline.

- **Kedekatan Gestalt (Proximity)**: Kontrol dan label terhubung duduk berjarak rapat `gap-1.5` (6px); batas antar-seksi menggunakan ruang kosong yang lega (`py-16 md:py-24`).

- **Pelapisan Permukaan 1px Tajam**: Padukan border tajam `border border-neutral-200/80 dark:border-neutral-800` dengan micro-shadow terarah `shadow-xs` alih-alih bayangan hitam buram 30px.

+ #### 10. Navigasi Website Anti-Pasaran: Kapsul Mengambang (Floating Island) & Flyout Mega Menu

+ Website produksi modern dilarang menggunakan template navbar kotak generik yang menempel penuh ke batas atas. Wajib implementasikan arsitektur **Floating Island Capsule Header** dengan **Flyout Card Mega Menu**:

+ - **Bilah Kapsul Melayang**: Melayang di atas kanvas latar belakang (`fixed top-4 md:top-6 inset-x-0 mx-auto w-[calc(100%-2rem)] max-w-5xl z-50 rounded-full px-4 md:px-6 py-2.5 md:py-3`).

+ - **Tema Glassmorphism Translusen Gelap**: Padukan latar belakang gelap dengan blur optik halus (`bg-neutral-950/80 backdrop-blur-xl saturate-180 border border-white/10`) sehingga konten di bawahnya tetap terlihat samar elegan saat digulir.

+ - **Flyout Card Bertingkat**: Saat menu *Skills* atau *Produk* diaktifkan, tampilkan kartu melayang terpisah (`rounded-2xl p-5 bg-[#0a0d14]/95 backdrop-blur-2xl border border-white/10 shadow-2xl`) yang menyajikan sub-menu dalam kisi terstruktur: wadah ikon visual, judul tegas, dan deskripsi nilai manfaat 1 kalimat (bebas link teks polos yang membosankan).

+ ### 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 |

+ | **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` |