architect-detective

Analyze codebases with AST analysis and PageRank to map architectural layers.

278|29|Updated Nov 4, 2025
One-click install
npx skills add https://github.com/MadAppGang/claude-code --skill architect-detective-madappgang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect-detective
Source: https://github.com/MadAppGang/claude-code/tree/main/plugins/code-analysis/skills/architect-detective
Command: npx skills add https://github.com/MadAppGang/claude-code --skill architect-detective-madappgang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill performs architectural investigation using AST structural analysis and PageRank to map dependencies and layers.

Core Features & Use Cases

  • Architecture Discovery: map with PageRank
  • Layer Boundary Discovery: identify controllers, services, and data layers
  • Pattern Discovery: factory, repository, event-driven patterns
  • Dependency Analysis: inspect dependencies and usages

Quick Start

claudemem --nologo map "service layer architecture" --raw

Frequently Asked Questions about architect-detective

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

FAQPage Schema
How do I analyze a codebase to discover its architectural structure and dependencies?

Architectural discovery maps a codebase's structure using AST-based analysis and PageRank to identify core abstractions, dependencies, and layer boundaries. Use the claudemem map command to reveal controllers, services, data layers, and design patterns within your project.

What's the best way to identify dead code and unused dependencies in a large codebase?

Dead-code detection uses AST structural analysis to scan your codebase and flag unused components. The Skill applies PageRank-based ranking to distinguish active abstractions from unused code, helping you clean up bloated projects.

Can I use this to map layer boundaries like controllers, services, and data access layers?

Yes. Layer boundary discovery identifies separation between controllers, services, and data layers using dependency analysis. It reveals architectural patterns—factory, repository, event-driven—to validate or refactor your design structure.

How does PageRank help identify the most important components in my architecture?

PageRank computes importance scores based on dependency relationships, surfacing core abstractions and frequently-used modules. This ranking distinguishes central architectural elements from peripheral ones, highlighting design bottlenecks and critical paths.

What input formats and codebases does architectural analysis support?

AST-based structural analysis works with software projects using claudemem v0.3.0. It supports map, symbol, and dead-code workflows and forbids GREP, FIND, and GLOB usage to ensure precision in architectural discovery.

Does this approach work for detecting design patterns like factory or repository patterns?

Yes. Pattern discovery uses dependency and structural analysis to identify factory, repository, and event-driven patterns. It maps how components interact to reveal whether your codebase follows or deviates from recognized architectural patterns.