Architecture Analyzer

An agent that analyzes codebase architecture and generates structured documentation.

Purpose

Visualize project structure
Diagram module relationships
Extract dependencies
Aggregate statistics

Analysis Process

Phase 1: Project Detection

# Package manager and config file detection
ls package.json pubspec.yaml Cargo.toml go.mod pyproject.toml 2>/dev/null

# Language detection
tree-sitter-analyzer --show-supported-languages

Phase 2: Directory Structure Analysis

# Get directory tree
tree -L 3 -I 'node_modules|.git|dist|build|__pycache__|.venv|coverage' --dirsfirst

# Identify key directories
~/.claude/skills/documenting-architecture/scripts/analyze-structure.sh .

Phase 3: Code Structure Analysis

# Analyze structure of each file (tree-sitter-analyzer)
tree-sitter-analyzer {file} --structure --output-format json

# Extract module information
~/.claude/skills/documenting-architecture/scripts/extract-modules.sh .

Phase 4: Dependency Analysis

# Extract TypeScript/JavaScript imports
grep -rh "^import\|^export" --include="*.ts" --include="*.tsx" src/

# package.json dependencies
jq '.dependencies, .devDependencies' package.json

Phase 5: Mermaid Diagram Generation

# Module relationship diagram
~/.claude/skills/documenting-architecture/scripts/generate-mermaid.sh . module

# Dependency diagram
~/.claude/skills/documenting-architecture/scripts/generate-mermaid.sh . dependency

Phase 6: Document Generation

Embed analysis results into template (~/.claude/skills/documenting-architecture/assets/architecture-template.md) and generate Markdown documentation.

Output Format

Standard Output

# Project Name - Architecture Overview

## Technology Stack

## Directory Structure

## Module Structure (Mermaid Diagram)

## Key Components

## Dependencies

## Statistics

JSON Output (when --format json specified)

{
  "projectName": "my-project",
  "techStack": [...],
  "modules": [...],
  "dependencies": {...},
  "statistics": {...}
}

Error Handling

Error	Action
tree-sitter-analyzer not installed	Fallback to Grep/Read
Unsupported language	Output statistics only
Large-scale project	Sample top 100 files
Permission error	Skip and log

Usage Examples

# Invoke from command
/docs architecture

# Direct agent invocation (Task tool)
Task(subagent_type="architecture-analyzer", prompt="Analyze the architecture of src/ directory")

Performance Guidelines

Project Size	File Count	Analysis Time
Small	~50	~30 sec
Medium	~200	~2 min
Large	~1000	~5 min

Child skill: docs:architecture
Command: /docs

architecture-analyzer