convez.ai
SkillProdutividadeAvançado
iskra-ai-tech

Riverpod Internals — Skill Técnico de Análise

iskra-ai-tech/riverpod-internals

Internals do Riverpod: 43 achados verificados, 740+ testes, zero intuição

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill de código Claude que documenta os mecanismos internos do Riverpod 3.2.1, Flutter Riverpod 3.3.1 e Hooks Riverpod 3.3.1 através de análise de fonte verificada. Contém 43 descobertas com citação exata de linhas de código, 75 arquivos de teste e 740+ testes passando, confirmando comportamentos não-óbvios e bugs confirmados.

Instalação

$npx convez-ai iskra-ai-tech/riverpod-internals

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Resolver bugs sutis em aplicações Flutter com Riverpod
  • Entender lifecycle de elementos e invalidação de providers
  • Debugar comportamentos não-óbvios de AsyncValue, select e scoping
  • Validar implementações de notifiers customizados contra padrões verificados

Veredito

Recurso altamente especializado e preciso para desenvolvedores Flutter/Riverpod que enfrentam comportamentos complexos ou bugs obscuros. Exigência técnica elevada, mas valor inestimável para quem trabalha nas camadas profundas do estado reativo.

README

A tradução para o português deste README ainda está na fila.

riverpod-internals

A Claude Code skill covering the internal mechanics of riverpod 3.2.1, flutter_riverpod 3.3.1, and hooks_riverpod 3.3.1 — derived from source analysis and verified by a 75-file test suite (740+ passing tests, device-confirmed on Pixel 3 Android 12).

Every claim in this skill cites an exact source file and line number. No training-data intuition, no documentation paraphrase.


Packages covered

PackageVersionRole
riverpod3.2.1Core — container, element, scheduler, ref
flutter_riverpod3.3.1Widget bridge — ConsumerWidget, ProviderScope
hooks_riverpod3.3.1Hooks integration — HookConsumerWidget

Install

Claude Code (manual):

# Copy SKILL.md to your Claude skills directory
cp SKILL.md ~/.claude/skills/riverpod-internals.md

Via Claude Code CLI:

claude skill add iskra-ai-tech/riverpod-internals

Once installed, Claude Code loads the skill automatically when working on Flutter/Dart projects using Riverpod.


What the skill contains

43 source-verified findings across 8 sections:

SectionFindingsKey topics
Scheduler & InvalidationF01–F05Timer(Duration.zero) disposal, N-invalidation collapse, refresh() vs invalidate() sync difference
Element LifecycleF06–F10ref.onDispose fires every rebuild, updateShouldNotify silences observers, debug-only CircularDependencyError
Ref ContractF11–F17ref.mounted uses object identity, onResume _didCancelOnce gate, keepAlive multi-link invariant
AsyncValue & RetryF18–F23Three non-exclusive state bits, 38s silent auto-retry on Exception, refresh() does not reset _retryCount
Widget Tree IntegrationF24–F29Offstage 100% rebuild rate, ref.listen never paused by TickerMode, container reassignment invisible to scope
Non-Obvious BehaviorsF30–F34StreamProvider.future hang on cold read, TickerMode assertion crash, selectAsync two-channel design
Select & Family CacheF35–F39NaN selector infinite loop, operator== not identical(), unbounded family HashMap
Scoping & OverridesF40–F43Zero-override child shares parent PointerManager, overrideWith frozen at creation

3 confirmed upstream issues (reproducers in test suite):

  • GH-BUG-1: AsyncNotifier post-await ref.watch silently disposed — notifier_provider.dart:569
  • GH-BUG-3: StreamProvider.future hangs on cold ref.read — element.dart:175-180
  • GH-BUG-4: TickerMode assertion crash via re-entrant counter — element.dart:1055

Test methodology

  • 451 unit tests across 36 files — pure Dart, run in local flutter test
  • 289 device-integration tests across 39 files — flutter test integration_test/ on Pixel 3, Android 12
  • 740+ verified passing (last full run: 2026-05-22)
  • 1 intentional failing test (rp_issue_post_await_watch_test.dart) — confirms GH-BUG-1 repro

Every behavioral claim has a calibration sibling: a test that must trivially pass under the same harness to confirm the harness is not broken.


Visual reference

article/RIVERPOD_ARTICLE.html — rendered HTML with all 43 findings, source refs, code examples, and the full hiding-mechanism comparison table.


Source citation format

Claims use molecular citations: absolute_path:line:verbatim_code → causal_link. Example:

scheduler.dart:24 — Timer(Duration.zero, task.call)
When sub.close() reduces hasNonWeakListeners to zero, line 24 schedules
disposal as a macrotask. Synchronous assertions after sub.close() see the
provider still alive.

Accuracy

  • All 8 core source citations independently re-verified against pub cache source on 2026-05-22
  • Zero claims stated from training knowledge alone
  • Revalidation ledger inside SKILL.md lists overturned claims with replacement verdicts
Ver o original no GitHub

Bom para

Relacionados