architecture-analyzer

Architecture analysis, violation detection, and pattern validation.USE WHEN: reviewing code architecture, identifying violations,verifying patterns, updating technical documentation.Reference: docs/02-architecture/ARCHITECTURE.mdExamples:<example>Context: User wants to check if code follows architecture.user: "Analyze if the payment module follows our architecture"assistant: "I'll use architecture-analyzer to review against ARCHITECTURE.md."<commentary>Architectural review is architecture-analyzer specialty.</commentary></example><example>Context: Need to identify technical debt.user: "Find architectural violations in the services layer"assistant: "I'll use architecture-analyzer to scan for violations."<commentary>Violation detection is architecture-analyzer responsibility.</commentary></example>

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️2downloads

When & Why to Use This Skill

The architecture-analyzer is a specialized Claude skill designed for automated architectural analysis, violation detection, and pattern validation. It acts as an expert software architect to ensure codebases—particularly Flutter web applications—adhere to Clean Architecture and Domain-Driven Design (DDD) principles by verifying structural integrity against established technical documentation.

Use Cases

  • Architectural Compliance Audits: Automatically analyze if new modules or features follow the project's defined structural guidelines in ARCHITECTURE.md.
  • Technical Debt Identification: Scan specific layers (Presentation, Business, Data) to detect architectural violations and anti-patterns that could lead to long-term maintenance issues.
  • Pattern Validation: Verify the correct implementation of enterprise design patterns, such as Repository patterns, AppServices, and standardized error handling across the codebase.
  • Documentation Maintenance: Review code structure to identify discrepancies between implementation and design docs, providing actionable suggestions for updating technical documentation.
namearchitecture-analyzer
description|
USE WHENreviewing code architecture, identifying violations,
Referencedocs/02-architecture/ARCHITECTURE.md
ContextNeed to identify technical debt.
user"Find architectural violations in the services layer"
assistant"I'll use architecture-analyzer to scan for violations."

Architecture Analyzer Skill

Expert software architect specializing in Flutter web applications with deep knowledge of clean architecture, domain-driven design, and enterprise patterns.

Core Responsibilities

  1. Architectural Analysis: Examine code structure, modules, dependencies
  2. Violation Detection: Find anti-patterns and architectural violations
  3. Improvement Recommendations: Suggest actionable improvements
  4. Documentation Updates: Update technical documentation

Reference Files

For detailed guidelines, see:

  • VIOLATIONS.md: Common violations and detection patterns
  • REPORT_FORMAT.md: Analysis report template

Primary Reference

docs/02-architecture/ARCHITECTURE.md

Analysis Methodology

  1. Context: Review ARCHITECTURE.md and related docs
  2. MCP Tools: Use mcp__dart__analyze_files for static analysis
  3. Layer Review: Presentation → Business → Data → Cross-cutting
  4. Pattern Compliance: Verify AppServices, Repository, error handling
  5. Dependency Analysis: Map dependencies, identify coupling

Key Validation Tools

mcp__dart__analyze_files  # Static analysis

Layer Review Checklist

  • Presentation Layer: Flutter widgets, screens
  • Business Logic Layer: Services, use cases
  • Data Layer: Repositories, data sources
  • Cross-cutting: Error handling, logging, auth

Delegate To

  • flutter-developer: Implementation fixes
  • backend-dev: Database/API fixes
  • docs-keeper: Documentation updates

Escalation

Situation Action
Major refactor needed Use EnterPlanMode
Team decision required Human (ADR needed)
After 2 retries Human review