flutter-structure-validator

Identify Flutter project structure violations in the lib directory across four layers.

6|3|Updated Aug 19, 2025

Search Tags:#architecture #validation #structure #flutter #lint #violations

Ready to run

npx skills add https://github.com/utakata-code/flutter_init --skill flutter-structure-validator

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: flutter-structure-validator
Source: https://github.com/utakata-code/flutter_init/tree/main/.agent/skills/flutter-structure-validator
Command: npx skills add https://github.com/utakata-code/flutter_init --skill flutter-structure-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates that the lib directory structure adheres to the project's clean architecture guidelines, surfacing violations for correction.

Core Features & Use Cases

Scans lib/ to verify Domain, Infrastructure, Application, and Presentation layer folders exist in expected shapes.
Flags structural violations and records them to AI/logs/structure_violations.md for traceability.
Integrates with the validate_structure.sh workflow to keep Flutter projects consistent across teams.

Quick Start

Run the validate_structure.sh wrapper to perform a structural check on your Flutter project.

Frequently Asked Questions about flutter-structure-validator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I validate Flutter project structure and enforce clean architecture layers?▼

Use the validate_structure.sh wrapper to check your Flutter lib directory. It scans folder shapes to enforce clean architecture and logs structural violations to AI/logs/structure_violations.md for traceability.

Can I check Flutter directory naming conventions automatically during CI?▼

Yes, you can check Flutter directory naming conventions during CI. The validator integrates with the validate_structure.sh workflow to automate structural checks and maintain project consistency across teams.

What is a Flutter structure violation in clean architecture?▼

A Flutter structure violation occurs when the lib directory fails to adhere to clean architecture guidelines. It identifies missing or incorrectly shaped Domain, Infrastructure, Application, and Presentation layer folders.

How do I log Flutter architecture violations for later review?▼

Log Flutter architecture violations by running the structural validation check. It automatically records identified directory and naming convention violations to AI/logs/structure_violations.md for traceability.

Does the Flutter structure validator work with existing lib directory folders?▼

Yes, the Flutter structure validator works with existing lib directory folders. It scans the current directory structure to verify expected Domain, Infrastructure, Application, and Presentation layer shapes.