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.