argent-react-native-optimization

Rules

• Do not apply shotgun optimizations. Measure first, define what "good enough" looks like (target metric + threshold), fix the top offender, re-measure honestly.
• Quick scan — react-profiler-renders for a live render count table. Identifies hot components instantly.
• Deep measure — load argent-react-native-profiler skill. react-profiler-start → interact → react-profiler-stop → react-profiler-analyze.
• Inspect — react-profiler-component-source per finding. react-profiler-fiber-tree to trace component ancestry and render cost.
• Verify correctness - before fixing, recollect information from steps above and make a logical conclusion whether the approach is worth undertaking.
• Fix — apply one fix. Validate with debugger-evaluate before committing.
• Re-measure — report whether the target metric improved, regressed, or stayed flat. Check for regressions in other areas. If no net benefit or unacceptable tradeoffs, revert.
• Profile for discovery, not only verification. Use the profiler to find issues static analysis missed, not only to confirm fixes.
• One fix per cycle for architectural changes. Mechanical batch fixes (inline styles, index keys) can be grouped — re-profile once after the batch. When the measurement involves simulator interaction, record it as a flow (argent-create-flow skill) before the first run so all subsequent cycles replay identical steps.
• React Compiler: if react-profiler-analyze reports reactCompilerEnabled: true, do NOT propose useCallback/useMemo/React.memo unless you confirmed compiler bail-out via react-profiler-fiber-tree (absent useMemoCache).
• Sub-agents: Phases 1–2 dispatch sub-agents — one per file for lint results, one per checklist item for semantic. Sub-agents CANNOT touch the simulator - all profiling and E2E verification must happen in the main agent.

Pipeline

Lint and semantic sweeps catch deterministic issues cheaply. Profiling finds runtime bottlenecks that static analysis misses. Do both.

Copy this checklist into your TODO list: