Notre avis

Cette compétence propose une approche rigoureuse pour implémenter les motifs avancés useTransition/useOptimistic de React 19 pour l'état de formulaire des server actions dans un monorepo Next.js/Playwright, avec validation stricte et rapport de preuves.

Points forts

Impose un workflow clair avec des conditions d'abandon en cas d'état dangereux.
Lié à un pipeline de validation concret : lint, typecheck, build, tests, audit, E2E, deploy.
Met l'accent sur des preuves forensiques (traces, captures, hash de commit) pour chaque modification.
Inclut la détection explicite des déclencheurs d'activation.

Limites

Adapté à un monorepo spécifique (hefarica/arbitragex-v2), donc pas directement réutilisable ailleurs.
Nécessite une connaissance de l'outillage et de la doctrine interne (Vault/age, isomorphisme Zod, etc.).
Ne couvre que l'aspect useTransition/useOptimistic de React 19, pas un guide React général.

Quand l'utiliser

À utiliser lorsque vous travaillez sur l'état de formulaire de server actions dans le frontend Next.js d'arbitragex-v2 et que vous devez implémenter ou revoir useTransition/useOptimistic avec validation E2E complète.

Quand l'éviter

Ne pas utiliser pour du développement React générique hors de ce dépôt ni pour des sujets sans rapport avec l'état de formulaire des server actions.

Exemples

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).

React 19 avancé: useTransition/useOptimistic

Recommandé pour