How do I install the Architecture Analyzer skill?

Run npx skillmds add majiayu000/architecture-analyzer in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Architecture Analyzer safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Architecture Analyzer?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Architecture Analyzer free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Architecture Analyzer?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Architecture Analyzer by majiayu000

Name: Architecture Analyzer
Rating: 4.666666666666667 (3 reviews)
Author: majiayu000

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.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>

majiayu000 a7cce51 2 files · 3.4 KB Updated Sep 9, 2026 567 repo stars

File contents

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

Architectural Analysis: Examine code structure, modules, dependencies
Violation Detection: Find anti-patterns and architectural violations
Improvement Recommendations: Suggest actionable improvements
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

Context: Review ARCHITECTURE.md and related docs
MCP Tools: Use mcp__dart__analyze_files for static analysis
Layer Review: Presentation → Business → Data → Cross-cutting
Pattern Compliance: Verify AppServices, Repository, error handling
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

---name: architecture-analyzerdescription: 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 ```bash 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 |

Frequently asked questions