flutter_bloc_app

Canonical rules — feature layers, domain purity, cubit vs widget roles, DI entrypoints, Freezed. Part of agents-canonical-rules split.

Scaffold or add a feature Cubit with Freezed state, tests, and repo-standard placement under presentation/cubit/.

Figma design-to-code for this repo (figma-sync assets, Flutter adaptation, MCP).

Dependency direction and feature composition. Use for shared package/app-shell changes, cross-feature deps, auth/theme contracts.

External references and key file paths for this repo. Use when locating theme, DI, lifecycle, sync, HTTP, or Supabase code.

Flutter BLoC app stack snapshot and lib/ layout. Use at task start or when adding features, routes, or shared code.

Request-id, in-flight coalesce, stream emit safety, offline don't-overwrite. Use for async repos/cubits and remote→local merge.

Cursor/Codex feature delivery contract for folder shape, use cases, DTO mapping, testing matrix, DI/routes, and validation.

Shared Codex/Cursor delivery loop for non-trivial work, validation routing, tracker choice, and completion gate before done or commit. Includes finish gate with post-bug agents-regression-capture before report.

Pre-flight checklist of frequent agent mistakes. Use before writing or reviewing code.

Turns fixed unique bugs into regression tests, static guards, checklist wiring, and lessons so the same failure class is caught early. Auto-use immediately after resolving a non-trivial bug, race, lifecycle issue, flaky test, or one-off production failure that could recur; also when the user asks to harden a fix or prevent recurrence.

Discover and invoke the right agent skills for Flutter BLoC app tasks — repo-first routing, official Dart/Flutter skills, discovery commands, and bug-fix hardening via agents-regression-capture. Use when starting implementation, tests, debugging, validation, or host setup; or when unsure which skill applies.

Validation scripts, regression guards, and testing requirements for this repo. After non-trivial bug fix, use with agents-regression-capture. Use when running checks, adding regression tests, or touching Mix/lifecycle/offline-first.

Auto-use on errors/failures; preserve root-cause discipline.

Auto-use before “done”; require proof before claiming done.

Fast repo orientation, command entrypoints, cross-host guardrails, and shared Codex/Cursor pointers. Repo canon wins.

Repo BLoC/Cubit standards for Cursor and Codex feature work, state modelling, lifecycle, side effects, and tests.

Canonical rules — UI, theme, l10n, Mix, type-safe BLoC access, list/build performance. Part of agents-canonical-rules split.

Architectural principles and non-negotiable baseline for this repo. Use when implementing features or reviewing code for DRY, SRP, architecture, or baseline (theme, l10n, lifecycle).

Use automatically for Flutter work involving Android, iOS, Web, Desktop, responsive/adaptive UI, platform behavior, routing/deep links, theming, accessibility, performance, or cross-target tests.

Plan discipline, risk scaling, verification, lessons, and bounded subagent/delegation rules for this repo.

Run repo host agent setup for Cursor—sync templates, install/update global vendor skills, trim ~/.agents/skills duplicates, skill inventory. Use when setting up Cursor, after install_global_agent_skills, reducing skill-list bloat, or user says sync/trim global skills.

Supabase MCP + migrations for this repo. Use for schema, RLS, apply_migration/list_migrations.

Auto-use on ambiguous asks; route to repo canon.

Compress memory files to caveman format; backup .original.md

Alias for agents-figma. Use when implementing Figma designs in this repo.

Auto-use for testable behavior changes; keep TDD pragmatic.

Auto-use for multi-step work; keep plan small and executable.

Canonical rules — cubit lifecycle, subscriptions, timers, stream safety, widget async/mounted, coordinators. Part of agents-canonical-rules split.

Canonical rules — DI, Hive, Dio, Retrofit, offline-first, HTTP errors, parsing, null/doc hygiene, logging, serialization, deferred routes. Part of agents-canonical-rules split.

Router for canonical coding rules — points to scoped agents-canonical-rules-* skills. Use when implementing or reviewing feature code; open the child skill that matches your change.

Cursor integration pointer for Flutter BLoC app. Use when editing repo rules, shared Cursor adapters, or Cursor/Codex review wiring.

Triage open non-draft PRs on main, merge/close/make-ready, run upgrade_validate_all, then PR and merge the resulting artifacts.