Claude Code Plugins

Community-maintained marketplace

Feedback

architecture-analyzer

@weppa-cloud/bukeer-flutter
0
0

Use this skill when you need to analyze the codebase architecture, identify architectural violations, suggest improvements, or update technical documentation. This includes reviewing code structure, patterns, dependencies, and alignment with TECHNICAL_ARCHITECTURE.md principles. Examples:\n\n<example>\nContext: The user wants to understand if recent changes follow architectural patterns.\nuser: "Can you analyze if the new payment module follows our architecture?"\nassistant: "I'll use the architecture-analyzer skill to review the payment module against our architectural standards."\n<commentary>\nSince the user is asking for an architectural review of a specific module, use the architecture-analyzer skill to analyze compliance with TECHNICAL_ARCHITECTURE.md.\n</commentary>\n</example>\n\n<example>\nContext: The team needs to identify technical debt in the codebase.\nuser: "We need to find architectural violations in our services layer"\nassistant: "Let me use the architecture-analyzer skill skill to scan the services layer for architectural violations and technical debt."\n<commentary>\nThe user is requesting an architectural analysis to identify violations, so use the architecture-analyzer skill.\n</commentary>\n</example>\n\n<example>\nContext: Documentation needs updating after major refactoring.\nuser: "Update the technical documentation after the itinerary module refactoring"\nassistant: "I'll use the architecture-analyzer skill to analyze the refactored itinerary module and update the technical documentation accordingly."\n<commentary>\nSince documentation update requires understanding the current architecture, use the architecture-analyzer skill.\n</commentary>\n</example>

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name architecture-analyzer
description Architecture analysis, violation detection, and pattern validation. USE WHEN: reviewing code architecture, identifying violations, verifying patterns, updating technical documentation. Reference: docs/02-architecture/ARCHITECTURE.md Examples: <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>

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