Analyze Code Structure

Examine code organization, dependencies, and architectural patterns to understand how modules are organized.

When to Use

• Reviewing module design before implementation
• Understanding how components connect
• Identifying structural improvements needed
• Planning refactoring strategies

Quick Reference

# Analyze Python file structure
python3 << 'EOF'
import ast
import sys

def analyze_structure(filepath):
    with open(filepath) as f:
        tree = ast.parse(f.read())

    classes = [n.name for n in ast.walk(tree) if isinstance(n, ast.ClassDef)]
    functions = [n.name for n in ast.walk(tree) if isinstance(n, ast.FunctionDef)]
    print(f"Classes: {classes}")
    print(f"Functions: {functions}")

analyze_structure(sys.argv[1])
EOF

Workflow

1. Identify module components: List classes, functions, and major imports
2. Map dependencies: Trace how modules import and reference each other
3. Analyze layers: Categorize code into logical layers (interface, business logic, persistence)
4. Document patterns: Note recurring architectural patterns (factory, singleton, observer)
5. Propose improvements: Identify coupling issues or missing separation of concerns

Output Format

Structured analysis report:

• Component inventory (classes, functions, data structures)
• Dependency graph (which modules import which)
• Layer organization (presentation, business, data)
• Design patterns identified
• Recommendations for improvement

References

• See CLAUDE.md > Modularity section for design principles
• See identify-architecture skill for full architecture analysis
• See CLAUDE.md > SOLID principles for structural best practices