architectural-analysis

Automate architectural health reviews to detect dead code, duplication, and anti-patterns.

1|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/leonanpereirapinto/ai-utils --skill architectural-analysis-leonanpereirapinto
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architectural-analysis
Source: https://github.com/leonanpereirapinto/ai-utils/tree/main/skills/essentials/architectural-analysis
Command: npx skills add https://github.com/leonanpereirapinto/ai-utils --skill architectural-analysis-leonanpereirapinto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It performs a comprehensive architectural audit of a codebase to uncover dead code, duplication, architectural anti-patterns, and health issues that impede maintainability.

Core Features & Use Cases

  • Discovery & mapping of project structure and entry points to establish a baseline.
  • Dead code detection across files to identify unused exports, unreferenced types, and unreachable logic.
  • Duplication analysis to surface repeated implementations and encourage consolidation.
  • Anti-pattern identification to surface architectural smells such as God objects, tight coupling, and circular dependencies.
  • Reporting to generate an actionable architectural health report for planning refactors.

Quick Start

Run the architectural analysis workflow on your repository to generate a comprehensive health report.

Frequently Asked Questions about architectural-analysis

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

FAQPage Schema
How do I find dead code and duplication in a large codebase?▼

Architectural analysis automates dead code detection and duplication checks across files to identify unused exports, unreferenced types, and repeated implementations for consolidation.

What is the best way to plan a refactor for an enterprise-grade monorepo?▼

An architectural health audit generates an actionable report detailing anti-patterns, dead code, and duplication, providing a structured baseline to plan refactors across enterprise-grade monorepos.

How does an architectural review identify anti-patterns and code smells?▼

Architectural reviews identify anti-patterns by mapping project structure and entry points to surface architectural smells such as God objects, tight coupling, and circular dependencies.

Can I use an automated codebase health audit to check type hygiene?▼

Yes, a codebase health audit includes type hygiene checks as part of a multi-phase workflow that uncovers unreferenced types, dead code, and architectural anti-patterns.

Does architectural analysis work for monorepos and enterprise projects?▼

Architectural analysis is applicable to monorepos and enterprise-grade projects, performing discovery and mapping across modules to execute comprehensive architectural health reviews.