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 GitHubSkill 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-internals1 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
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
| Package | Version | Role |
|---|---|---|
riverpod | 3.2.1 | Core — container, element, scheduler, ref |
flutter_riverpod | 3.3.1 | Widget bridge — ConsumerWidget, ProviderScope |
hooks_riverpod | 3.3.1 | Hooks 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:
| Section | Findings | Key topics |
|---|---|---|
| Scheduler & Invalidation | F01–F05 | Timer(Duration.zero) disposal, N-invalidation collapse, refresh() vs invalidate() sync difference |
| Element Lifecycle | F06–F10 | ref.onDispose fires every rebuild, updateShouldNotify silences observers, debug-only CircularDependencyError |
| Ref Contract | F11–F17 | ref.mounted uses object identity, onResume _didCancelOnce gate, keepAlive multi-link invariant |
| AsyncValue & Retry | F18–F23 | Three non-exclusive state bits, 38s silent auto-retry on Exception, refresh() does not reset _retryCount |
| Widget Tree Integration | F24–F29 | Offstage 100% rebuild rate, ref.listen never paused by TickerMode, container reassignment invisible to scope |
| Non-Obvious Behaviors | F30–F34 | StreamProvider.future hang on cold read, TickerMode assertion crash, selectAsync two-channel design |
| Select & Family Cache | F35–F39 | NaN selector infinite loop, operator== not identical(), unbounded family HashMap |
| Scoping & Overrides | F40–F43 | Zero-override child shares parent PointerManager, overrideWith frozen at creation |
3 confirmed upstream issues (reproducers in test suite):
- GH-BUG-1:
AsyncNotifierpost-awaitref.watchsilently disposed —notifier_provider.dart:569 - GH-BUG-3:
StreamProvider.futurehangs on coldref.read—element.dart:175-180 - GH-BUG-4:
TickerModeassertion 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.mdlists overturned claims with replacement verdicts