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

ADRs Relevantes

ADR	Topic
ADR-001	Architecture decision records
ADR-011	Design System
ADR-015	AppServices pattern
ADR-016	GoRouter navigation
ADR-018	SafeMap extensions
ADR-022	Auth token boundary
ADR-023	Idle-aware tasks
ADR-024	Build purity

MCP Tools (additional)

• mcp__dcm__dcm_check_dependencies — Dependency analysis
• mcp__dcm__dcm_check_unused_code — Dead code detection