Architecture Auditor

Audit Flutter feature modules for Clean Architecture and Riverpod compliance.

Updated Aug 11, 2025
One-click install
npx skills add https://github.com/NinaVerde/ninaverde_app --skill architecture-auditor-ninaverde
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Architecture Auditor
Source: https://github.com/NinaVerde/ninaverde_app/tree/main/.agent/skills/architecture-auditor
Command: npx skills add https://github.com/NinaVerde/ninaverde_app --skill architecture-auditor-ninaverde

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture Auditor helps teams enforce Clean Architecture, Riverpod best practices, and strict separation of concerns, reducing architectural drift across Flutter projects.

Core Features & Use Cases

  • Enforces Clean Architecture layers: Presentation (UI), Domain (Entities & Use Cases), Data (Repositories & Data Sources).
  • Enforces Riverpod strict mode: no logic in UI, explicit typing, and recommended Notifier usage.
  • Folder structure enforcement: /features/feature_name/presentation/, /features/feature_name/domain/, /features/feature_name/data/.
  • Smell Test: rejects UI with HTTP calls; ensures repositories don't depend on UI context; flags overly long build methods.

Quick Start

Run Architecture Auditor on a new feature module to verify adherence to guidelines and folder structure.

Frequently Asked Questions about Architecture Auditor

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

FAQPage Schema
How do I enforce clean architecture and separation of concerns in a Flutter project?

To enforce clean architecture in a Flutter project, audit feature modules to verify strict separation into presentation, domain, and data layers. This ensures UI code contains no business logic and repositories remain decoupled from UI context.

What is the correct folder structure for a Flutter feature module using Riverpod?

The correct folder structure for a Flutter feature module organizes code into /features/feature_name/presentation/, /features/feature_name/domain/, and /features/feature_name/data/ directories. This structure enforces strict clean architecture boundaries.

How do I check if my Flutter app follows Riverpod best practices?

To check Riverpod best practices in a Flutter app, audit the codebase to enforce strict mode. This verifies explicit typing, checks recommended Notifier usage, and ensures no business logic resides directly inside the UI build methods.

Why does my Flutter architecture audit fail when UI components contain HTTP calls?

Your Flutter architecture audit fails because making HTTP calls directly from UI components violates clean architecture separation of concerns. All network data fetching must be moved to the data layer repositories to pass the architectural smell test.

Can I use an architecture audit to detect overly long build methods in Flutter?

Yes, you can use an architecture audit to detect overly long build methods in Flutter. The audit includes a smell test that flags excessively long build methods to enforce UI simplicity and maintain strict separation of concerns.