architectural-analysis

Audit a codebase for dead code, duplication, anti-patterns, and code smells.

567|82|Updated Mar 15, 2026

Search Tags:#code analysis #refactoring #technical debt #code smells #duplication #dead code #architectural audit

Ready to run

npx skills add https://github.com/pedronauck/skills --skill architectural-analysis-pedronauck

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architectural-analysis
Source: https://github.com/pedronauck/skills/tree/main/skills/architectural-analysis
Command: npx skills add https://github.com/pedronauck/skills --skill architectural-analysis-pedronauck

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill identifies critical issues within a codebase, such as dead code, duplicated logic, architectural anti-patterns, type confusion, and general code smells, to improve maintainability and reduce technical debt.

Core Features & Use Cases

Dead Code Detection: Pinpoints unused functions, classes, and variables.
Duplication Analysis: Finds repeated code blocks and logic across files.
Anti-Pattern Identification: Detects issues like God Objects and circular dependencies.
Type Safety Audit: Locates misuse of any, type assertions, and @ts-ignore.
Code Smell Reporting: Flags long methods, complex conditionals, and magic numbers.
Use Case: When a project feels bloated and hard to maintain, use this Skill to get a comprehensive report on areas that need refactoring, leading to a cleaner, more robust codebase.

Quick Start

Run a full architectural analysis on the current project directory.

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 duplicated logic in my codebase?▼

An architectural audit systematically scans codebase structure and entry points to detect dead code and duplicated logic, generating a detailed report with actionable cleanup recommendations for your project.

What is an architectural anti-pattern and how do I detect God Objects?▼

Architectural anti-patterns like God Objects and circular dependencies are structural flaws reducing maintainability. A comprehensive code analysis detects these issues by evaluating codebase structure and categorizing them for targeted refactoring.

How do I audit type safety to locate misuse of any and ts-ignore?▼

To audit type safety and locate misuse of `any` or `@ts-ignore`, perform a comprehensive codebase analysis that systematically detects type confusion and flags these violations in a detailed quality report.

Can I use this code analysis to identify technical debt and code smells?▼

Yes, you can use this code analysis to identify technical debt by flagging code smells like long methods, complex conditionals, and magic numbers, which improves project maintainability and reduces accumulated debt.

When should I run a full architectural audit on my project directory?▼

Run a full architectural audit when your project feels bloated and hard to maintain, using systematic detection of dead code and anti-patterns to generate actionable recommendations for a cleaner codebase.