karto4ki

Post-generation workflow that orchestrates code generation and quality verification for created or modified Dart files.

Execute code generation for created source files. Handles build_runner (freezed, json_serializable, retrofit, auto_route, theme_tailor, flutter_gen) and localization via Melos. Use after creating or modifying source files that require code generation.

Automate the full submodule-change lifecycle: detect modified submodules, create a feature branch inside the submodule, commit, push, generate the GitLab MR URL, then bump the submodule pointer in the parent repo as a separate commit. Picks up any intermediate state (dirty / staged / committed but unpushed / pushed but parent pointer not bumped) and continues from there. Use when you've edited a file inside `docs/flutter-rules/` (or any other submodule) and need to land the change properly.

Create Retrofit API interfaces and DTOs with proper nullability, JSON serialization, and code generation. Use when adding new API clients or data transfer objects.

Create Alchemist golden tests for screens, widgets, and UIKit components. Use when adding visual regression tests for a View, ViewModel-driven screen, reusable widget, or UIKit element.

Build a GitLab merge request for the current branch — generates title and description following the project's MR template, parses JIRA ticket from branch name, summarizes the diff, runs pre-push safety checks, pushes the branch, and outputs a ready-to-open GitLab "new MR" URL. Use when finishing a feature branch.

Create local data storage (key-value/secure storage) or database DAO (Drift/SQLite) implementations with interfaces, DTOs, and DI wiring. Use when adding persistent local storage or database DAOs for a feature.

Create a new reusable component in module_ui (modules/ui/lib/uikit) with proper theming, asset access, naming, exports, golden test, and Figma mapping update. Use when adding a new design system component shared across features.

Extract hardcoded user-facing strings from a Dart file into ARB localization keys, replace literals with context.l10n calls, and hand off ARB editing to /localize. Use when migrating a View or Widget that contains literal Russian/English copy.

Verification and quality assurance feedback loop. Runs auto-fix, static analysis, and iterates until all errors are resolved.

Translates Figma designs into production-ready code with 1:1 visual fidelity. Use when implementing UI from Figma files, when user mentions "implement design", "generate code", "implement component", "build Figma design", provides Figma URLs, or asks to build components matching Figma specs. Requires Figma MCP server connection.

Add localized strings to ARB files with proper grouping, naming, placeholders, and code generation. Use when adding translations or localized text to the app.

Scaffold screens, BLoCs, repositories, and assemblies using Mason bricks. Use when creating or scaffolding Flutter features — both on user request and autonomously when boilerplate is needed.

Regenerate AI_CODE_REVIEW_RULES.md from current .cursor/rules/*.mdc files. Use when /validate-ai-setup reports AI review rules drift, or after adding/modifying architecture rules.

Validate consistency of .cursor/rules and .claude/skills files. Checks cross-references, frontmatter, logical contradictions, and code example consistency. Use when rules/skills are added or modified.

Validate that init_project.sh and initialization documentation are consistent with the current project state. Checks that all template values referenced in the script actually exist in target files, that file paths are valid, and that no new template-specific values have appeared uncovered. Use when init_project.sh, project structure, native configs, or initialization docs are modified. Also use proactively after any structural changes to the template project.