architect-detective

Analyze software architecture using AST structural analysis to map layers and dependencies.

2|Updated Dec 25, 2025
One-click install
npx skills add https://github.com/tianzecn/myclaudecode --skill architect-detective
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect-detective
Source: https://github.com/tianzecn/myclaudecode/tree/main/plugins/code-analysis/skills/architect-detective
Command: npx skills add https://github.com/tianzecn/myclaudecode --skill architect-detective

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires claudemem, and includes references (resource) components.

What problem does it solve?

This Skill analyzes code structure to reveal architecture, dependencies, and core abstractions, helping you understand system boundaries and central pillars.

Core Features & Use Cases

  • Architecture Discovery: identify core abstractions and layers with PageRank.
  • Layer Mapping: visualize presents/business/data boundaries.
  • Dependency Context: understand which symbols are central and what depends on them.

Quick Start

Use the architect-detective skill to generate an architectural map for the repository and identify the top abstractions.

Frequently Asked Questions about architect-detective

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

FAQPage Schema
How do I analyze software architecture and identify core dependencies in my codebase?

Architecture analysis reveals system boundaries, layers, and central abstractions by examining code structure with AST parsing. Architect-detective uses PageRank to rank symbol importance and maps dependency relationships, showing which abstractions are foundational and what depends on them.

Can I visualize business logic, presentation, and data layers in my code?

Layer mapping identifies boundaries between presentation, business, and data layers by analyzing structural dependencies. Architect-detective reveals how symbols cross these boundaries, helping you spot architectural drift or tightly coupled components.

What do I need to run architecture analysis on my repository?

Architecture analysis requires claudemem v0.3.0 as a prerequisite dependency. The Skill runs AST-only analysis, so you need a repository indexed with claudemem commands (map, symbol, callers, callees, context, dead-code) to generate architectural insights.

How does AST-based analysis differ from static dependency scanning?

AST analysis examines code structure deeply to identify patterns, abstractions, and design relationships beyond simple import tracking. This approach surfaces architectural principles and core pillars by ranking symbol centrality and mapping functional boundaries.

Can I detect dead code and unused abstractions during architecture review?

Dead-code detection runs as part of architectural analysis, identifying symbols with no callers or dependencies. This helps you spot unused abstractions and prune code that no longer serves the system's core design.