Merlin LogoMerlin

merlin architecture

Advanced architectural analysis and pattern detection. Analyze design quality, detect architectural patterns, and identify anti-patterns in your codebase.

Basic Usage

# Analyze project architecture
merlin architecture .

# Generate summary analysis
merlin architecture . --format summary

# Focus on specific directory
merlin architecture ./src --format detailed

Architecture Insight

The merlin architecture command analyzes your codebase structure and provides recommendations based on industry best practices and design patterns.

What Gets Analyzed

Python Patterns

  • MVC/MTV patterns
  • Factory/Builder patterns
  • Decorator patterns
  • Context managers
  • Metaclass usage

Package Architecture

  • Module organization
  • Package structure
  • Import relationships
  • Namespace packages
  • Entry points

Dependencies

  • Import analysis
  • Circular imports
  • Coupling metrics
  • Dependency injection
  • Third-party usage

Code Organization

  • PEP 8 structure
  • Module cohesion
  • Separation of concerns
  • Layer boundaries
  • Configuration management

Advanced Options

--format

Output format (summary, detailed, patterns, json)

$ merlin architecture . --format detailed
--patterns

Specific architectural patterns to detect

$ merlin architecture . --patterns mvc --patterns clean_architecture
--min-confidence

Minimum confidence threshold (0.0-1.0)

$ merlin architecture . --min-confidence 0.8
--include-anti-patterns

Include anti-pattern detection

$ merlin architecture . --include-anti-patterns
--depth

Maximum analysis depth

$ merlin architecture . --depth 5
--exclude

Exclude patterns (e.g., tests, __pycache__)

$ merlin architecture . --exclude tests --exclude __pycache__

Common Detected Patterns

Layered Architecture

Clear separation of presentation, business, and data layers

Component-Based Design

Modular components with single responsibilities

Repository Pattern

Data access abstraction layer

Dependency Injection

Loose coupling through DI containers

Example Architecture Report

🏗️ Merlin Architecture Analyzer v0.1.0
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 PROJECT STRUCTURE
Modules: 23 • Components: 89 • Services: 12
Architecture: Layered (MVC pattern)
✅ DETECTED PATTERNS
+ Repository Pattern (data access)
+ Dependency Injection (services)
+ Component-Based Design (UI)
⚠️ ARCHITECTURAL CONCERNS
• Circular dependency: UserService ↔ AuthService
• High coupling in payment module
💡 RECOMMENDATIONS
1. Extract shared interfaces to break cycles
2. Apply Facade pattern to payment module
3. Consider implementing Event-Driven Architecture
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🏆 ARCHITECTURE SCORE: 86/100
✨ WELL-STRUCTURED • Minor improvements needed

Architecture Visualization

Interactive Diagrams

Generate visual representations of your architecture including dependency graphs, layer diagrams, and component relationships.

$ merlin architecture . --format detailed --include-anti-patterns

Related Commands

Combine architectural analysis with other Merlin tools for comprehensive code review.

Full AnalysisDependency Tree