arquitetura-revisor

Community

Find architecture issues and recommend fixes

Authorjoleques
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Automates inspection of a codebase to detect violations of the proposta-arq architecture (Clean Architecture + Hexagonal + DDD), surfacing structural issues, improper dependencies, and misplaced logic so teams can fix architectural debt before it becomes critical.

Core Features & Use Cases

  • Structure Validation: Verifies presence and naming of expected layers (domain, use_case, application, infra, shared) and detects files placed in incorrect layers.
  • Dependency Flow Analysis: Ensures unidirectional dependencies (infra → application → use_case → domain) and flags imports that break layer boundaries.
  • Per-Layer Review: Checks responsibilities of Application, Use Case, Domain, Infrastructure, and Shared components and reports violations with recommendations.
  • Use Cases: Pre-merge architecture checks, post-refactor validation, legacy code audits, and preparatory reviews before formal code review.

Quick Start

Run an architecture review on the project root, specify the primary language and changed files, and request a Markdown compliance report.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: arquitetura-revisor
Download link: https://github.com/joleques/northstar-ai/archive/main.zip#arquitetura-revisor

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.