architecture-intelligence

Analyze codebases to detect architectural patterns and report violations.

47|10|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/gonzalezpazmonica/pm-workspace --skill architecture-intelligence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-intelligence
Source: https://github.com/gonzalezpazmonica/pm-workspace/tree/main/.claude/skills/architecture-intelligence
Command: npx skills add https://github.com/gonzalezpazmonica/pm-workspace --skill architecture-intelligence

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps identify architectural patterns in codebases, detect violations, and suggest improvements, ensuring better code quality and maintainability.

Core Features & Use Cases

  • Pattern Detection: Automatically identifies common architectural patterns like Clean Architecture, Hexagonal, DDD, CQRS, MVC, MVVM, and Microservices.
  • Adherence Scoring: Provides a score indicating how well the codebase adheres to the detected patterns.
  • Violation Reporting: Highlights specific rules or conventions that are broken within the identified patterns.
  • Language Support: Analyzes projects across 16 different programming languages.
  • Use Case: A tech lead can use this Skill to quickly assess the architectural health of a new project or a legacy system, identifying areas that need refactoring.

Quick Start

Analyze the current project's architecture and report any detected patterns and violations.

Frequently Asked Questions about architecture-intelligence

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect architectural patterns in an existing codebase?

Architectural pattern detection analyzes folder structure, import dependencies, naming conventions, and configuration files to identify patterns like Clean Architecture, Hexagonal, DDD, CQRS, MVC, MVVM, and Microservices while scoring adherence.

What architectural patterns can be automatically identified in source code?

Automatic identification detects Clean Architecture, Hexagonal, DDD, CQRS, MVC, MVVM, and Microservices patterns by examining import dependencies and folder structures to report violations and suggest refactoring improvements.

Can I analyze architectural adherence across different programming languages?

Architectural adherence analysis supports 16 different programming languages, allowing you to detect patterns and score compliance consistently across polyglot codebases.

How do I find architecture violations in a legacy project for refactoring?

Finding architecture violations involves scanning the codebase to highlight specific broken conventions within detected patterns, generating an adherence score and actionable recommendations to guide refactoring efforts.

Does architectural pattern detection work for microservices and DDD?

Architectural pattern detection explicitly supports both Microservices and Domain-Driven Design (DDD), evaluating folder structures and import dependencies to score adherence and report structural violations.

What is the best way to assess architectural health in a software project?

Assessing architectural health requires analyzing the codebase to detect established patterns, calculate an adherence score, and generate targeted recommendations for correcting structural violations and improving maintainability.