Our review

This skill provides a disciplined approach to implementing advanced React 19 useTransition/useOptimistic patterns for server action form state in a Next.js/Playwright monorepo, with strict validation and evidence reporting.

Strengths

Enforces a clear workflow with abort conditions for unsafe states.
Tied to a concrete validation pipeline: lint, typecheck, build, tests, audit, E2E, deploy.
Emphasizes forensic evidence (traces, screenshots, commit hash) for every change.
Includes explicit trigger detection for when the skill should activate.

Limitations

Tailored to a specific monorepo (hefarica/arbitragex-v2), so not directly reusable elsewhere.
Requires familiarity with internal tooling and doctrine (Vault/age, Zod isomorphism, etc.).
Covers only the useTransition/useOptimistic aspect of React 19, not a general React guide.

When to use it

Use when working on server action form state in the arbitragex-v2 Next.js frontend and you need to implement or review useTransition/useOptimistic with full E2E validation.

When not to use it

Do not use for generic React development outside this repo or for topics unrelated to server action form state.

Examples

Implement useOptimistic for server action form

In the arbitragex-v2 frontend, I need to add optimistic updates to a server action form using React 19's useOptimistic. Apply the G005 skill and run the full validation pipeline.

Review useTransition usage in a Next.js form

Review the current useTransition usage in the 'frontend/app' directory for server action form state. Use the G005 skill to check against the doctrine and report evidence.

Add E2E tests for optimistic form state

Write Playwright E2E tests covering the DEGRADED/UP/DOWN states for the optimistic form in the arbitragex-v2 repo, following the G005 skill.

name: arbx-g-g005-advanced-react-19-usetransitionuseoptimistic description: "Post-Doc skill alineada al monorepo hefarica/arbitragex-v2 (Frontend Doctrinal (Next.js + Playwright)). Se activa cuando: server actions form state. Doctrina OMEGA Zero-Mocks · Fail-Closed · El Remoto Manda."

G005 — Advanced React 19 useTransition/useOptimistic

Dominio: Frontend Doctrinal (Next.js + Playwright) Nivel: Post-Doc Trigger: server actions form state Repos de referencia: vercel/next.js · facebook/react · microsoft/playwright · TanStack/query · shadcn-ui/ui · radix-ui/primitives · wevm/viem · wagmi-dev/wagmi Archivos del repo: frontend/app/* · frontend/components/* · frontend/tests/e2e/* · packages/schemas/*

Quick Start

ARBX_BUILD_FOR_LOCAL_E2E=1 ARBX_ASSUME_NO_RPC=1 pnpm playwright test --reporter=list,html

Core Workflow

Cargar contexto del repo hefarica/arbitragex-v2 (rama actual, último PR, estado de CI).
Identificar el subsistema impactado dentro de los archivos del repo listados arriba.
Aplicar la doctrina del nivel Post-Doc sin desviaciones.
Validar contra: lint → typecheck → build → tests → audit → E2E → deploy.
Reportar evidencia en formato Markdown forense (logs, traces, métricas, hash de commit).

Doctrina del Nivel

Aporte de investigación: paper o RFC referenciado.
Benchmarks reproducibles con criterio estadístico (95% CI).
Comparativa contra estado del arte público.

Reglas de Ejecución

| Condición | Acción | |-----------|--------| | CI rojo en main | ABORT — fix-forward, nunca skip | | Drift schema producer↔consumer | ABORT — restaurar isomorfismo Zod/struct | | Cobertura E2E < contrato iter 18 | ABORT — añadir testid + assertion DEGRADED/UP/DOWN | | Secret en plaintext fuera de Vault/age | ABORT — rotar y reportar | | Profit neto ≤ gas + flashloan_fee | ABORT (skill C/E) | | Slippage > banda RiskGate | RESIZE o ABORT (skill C/E) |

Activation Triggers (regex parciales)

server actions form state
advanced react 19 usetransition/useoptimistic
arbitragex-v2 g

Output Esperado

Diff atómico (rustfmt aparte de semántica).
Evidencia: gh pr checks <N>, cargo nextest, traces OTel, screenshots Playwright.
ADR si la decisión cambia contrato (docs/adr/NNNN-*.md).

Advanced React 19 useTransition/useOptimistic

Recommended for