arch-lint

Detect architecture and layering violations in Flutter code.

6|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/exception-coder/team-standards --skill arch-lint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-lint
Source: https://github.com/exception-coder/team-standards/tree/main/skills/arch-lint
Command: npx skills add https://github.com/exception-coder/team-standards --skill arch-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects architecture and layering violations in Flutter projects to prevent presentation/domain/data/infrastructure misuse that causes tight coupling, hidden technical debt, and runtime bugs.

Core Features & Use Cases

  • Rule-based layer checks: identifies direct SQL/Database, direct HTTP calls, forbidden framework imports in domain, DAO misuse, and potential money fields typed as double.
  • Dual operation modes: full-project scans for comprehensive auditing and lightweight automatic checks triggered for files changed in a commit or edit.
  • Actionable reports: produces structured violation tables with file path, line number, offending code snippet, severity (severe vs warning), and concrete remediation advice.

Quick Start

Run an architecture lint on the project's lib directory and return a table of violations with file paths, line numbers, severity levels, and suggested fixes.

Frequently Asked Questions about arch-lint

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

FAQPage Schema
How do I detect Flutter architecture layering violations in my project?

Detect Flutter architecture layering violations by scanning the project's lib directory to identify presentation, domain, data, and infrastructure misuse such as direct SQL calls in presentation or forbidden framework imports in domain.

What types of architectural misuse can a Flutter layering linter catch?

A Flutter layering linter catches direct SQL or HTTP calls in presentation layers, forbidden framework imports in domain logic, DAO leakage, and money fields incorrectly typed as double, preventing tight coupling and hidden technical debt.

Can I check only changed files for architecture violations instead of the whole Flutter project?

Yes, you can check only changed files for architecture violations using a lightweight mode that targets the changed layer or files modified in a commit, alongside a full-project scanner mode for comprehensive auditing.

What does a Flutter architecture violation report include?

A Flutter architecture violation report includes the rule name, file path, line number, offending code snippet, severity classification of severe or warning, and concrete remediation suggestions for each finding.

Does this architecture linter work on Flutter projects without specific dependencies?

The architecture linter operates on Flutter projects containing a lib directory and requires no external dependencies, scanning for layering violations across presentation, domain, data, and infrastructure layers seamlessly.

When should I scan the full project versus changed files for layering violations?

Scan the full project when conducting a comprehensive architecture audit to find all layering violations, and use the lightweight changed-files check during commits or edits to catch incremental presentation, domain, or data misuse quickly.