Flutter 3 & Riverpod / Dart Claude Skill (.md) | Free & Offline

Production-grade architectural rulebook for Flutter 3 & Riverpod / Dart. Engineered to eliminate LLM hallucinations, enforce strict deterministic conventions, and prevent architectural drift across Cursor IDE, Claude Code CLI, and autonomous multi-agent pipelines.

Target Path
.claude/skills/flutter-dart/SKILL.md
Execution Scope
Trigger Phrase / CLI Tool
Specification Format
Folder Skill (SKILL.md)
AI Tool Support
Claude Code CLI & Desktop
02 / DRIFT ANALYSIS & VALUE PROPOSITION

Failure Patterns Prevented for Flutter 3 & Riverpod / Dart

Without This Rule (Default LLM Behavior)Vulnerable

Flutter 3 and Dart 3 introduce records, pattern matching, sealed classes, and Riverpod 2 code generation (@riverpod). AI models routinely emit obsolete setState() spaghetti, mutable widget state, un-const constructors, and legacy Riverpod syntax.

Hallucination Symptoms
  • Invokes deprecated or removed APIs from older model training weights
  • Generates conflicting configuration files and invalid imports
  • Silently drops type-safety, boundaries, or transaction isolation
With This Rule (Guaranteed Invariants)Deterministic
Always add const constructors wherever possible to maximize Flutter element rebuild caching.
Use Riverpod 2 with code generation (@riverpod / NotifierProvider) or BLoC; ban raw mutable setState() in business logic.
Leverage Dart 3 pattern matching and sealed classes for exhaustive state and error representation.
Enforce sound null safety: avoid force-unwrapping with ! unless proven non-null by a preceding guard clause.
Separate presentation UI widgets from asynchronous repository and API service layers.
03 / VERIFIED CODE PATTERNS

Code Standards: Anti-Pattern vs Verified Implementation

Discouraged Anti-Pattern
// Discouraged: Mutable setState with force-unwrap and missing const
class BadProfile extends StatefulWidget {
  @override
  _BadProfileState createState() => _BadProfileState();
}
class _BadProfileState extends State<BadProfile> {
  var user;
  void load() async {
    user = await fetchUser();
    setState(() {});
  }
  @override
  Widget build(BuildContext context) {
    return Container(child: Text(user!.name)); // Runtime crash if null!
  }
}
Verified Production Standard
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';

@immutable
sealed class ViewState<T> {
  const ViewState();
}
class Loading<T> extends ViewState<T> { const Loading(); }
class Success<T> extends ViewState<T> { final T data; const Success(this.data); }
class Failure<T> extends ViewState<T> { final String message; const Failure(this.message); }

class ProfileView extends ConsumerWidget {
  const ProfileView({super.key});

  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final state = ref.watch(profileProvider);
    return Scaffold(
      appBar: AppBar(title: const Text('Profile')),
      body: switch (state) {
        Loading() => const Center(child: CircularProgressIndicator.adaptive()),
        Success(:final data) => Center(child: Text('Welcome, ${data.name}')),
        Failure(:final message) => Center(child: Text('Error: $message')),
      },
    );
  }
}
04 / REPOSITORY PLACEMENT & 3-STEP TERMINAL INSTALLATION

How to Install Flutter 3 & Riverpod / Dart Claude Code Skills (SKILL.md) via Terminal

1

Step 1: Open Project Directory & Verify Target Placement

Open your terminal and navigate to your project root folder where the .claude/skills/flutter-dart/SKILL.md file will reside. Ensure the file is placed at the exact path below relative to your project root so the AI engine automatically loads it:

.claude/skills/flutter-dart/SKILL.md
2

Step 2: Fetch Rule File via Terminal Command

Run curl, PowerShell, or wget to stream the rule directly from the DevScratchpad raw API endpoint and write it to .claude/skills/flutter-dart/SKILL.md:

Terminal One-Liner Install

Run directly in your project root to stream and write this rule file with one command.

Raw API Stream
$mkdir -p ".claude/skills/flutter-dart" && curl -fsSL "https://www.devscratchpad.tech/api/raw/claude-skills/flutter-dart" -o ".claude/skills/flutter-dart/SKILL.md"
3

Step 3: Verify and Activate with AI Agent

Launch your AI coding assistant (Claude Code CLI & Desktop). The assistant will automatically discover .claude/skills/flutter-dart/SKILL.md in your repository and apply the architectural guardrails, type constraints, and verification protocols during code generation.

05 / ROUTE DIRECTORY & CROSS-TOOLING
Format Pillar HubComprehensive Manual

Claude Code Skills (SKILL.md) Directory

Inspect the complete specification manual, glob patterns, directory rules, and all available presets in our central directory.

/claude-skills Directory
06 / FREQUENTLY ASKED QUESTIONS

Technical FAQ: Flutter 3 & Riverpod / Dart AI Rulebooks

Does this rulebook support Riverpod 2 and BLoC?

Yes, it provides architecture rules for both modern code-generated Riverpod and idiomatic BLoC/Cubit event streams.

Why does it require const constructors?

In Flutter, const widgets short-circuit the rebuild tree, providing substantial UI frame-rate gains especially on mobile devices.