Sub-Agent Architecture Reviewer Command

Sub-Agent Architecture Reviewer Command

Analyzes system architecture, detects violations, suggests improvements, and generates visual documentation using multiple specialized sub-agents.

Command Syntax

sub-agent-architecture-reviewer [target] [options]

# Aliases
@architecture-review [target] [options]
@arch-review [target] [options]
@saar [target] [options]

Parameters

undefined

Examples

# Basic architecture review
@architecture-review

# Full analysis with violations
@arch-review src/ --detect-violations --suggest-improvements

# Generate diagrams for specific style
@architecture-review --style hexagonal --visualize --output mermaid

# Check against custom rules
@arch-review . --rules .architecture-rules.yaml

Agent Orchestration

Stage 1: Analysis Agents (Parallel)

Agent 1: Dependency Mapper

Map all dependencies in [TARGET]

Tasks:
1. File Dependencies:
   - Import/require statements
   - Dynamic imports
   - Lazy loading patterns
   - Circular dependencies

2. Package Dependencies:
   - Direct dependencies
   - Transitive dependencies
   - Version conflicts
   - Unused packages

3. Layer Dependencies:
   - Cross-layer references
   - Proper layer isolation
   - Dependency direction
   - Interface boundaries

4. Service Dependencies:
   - API dependencies
   - Database connections
   - External services
   - Message queues

Return:
- Dependency graph data
- Circular dependency list
- Layer violation report
- Service coupling metrics

Agent 2: Pattern Analyzer

Analyze architectural patterns in [TARGET]

Tasks:
1. Design Patterns:
   - Repository pattern usage
   - Service layer implementation
   - Factory patterns
   - Observer patterns
   - Strategy patterns

2. Architecture Style:
   - MVC compliance
   - Hexagonal architecture
   - Clean architecture
   - Domain-driven design
   - Microservices patterns

3. Code Organization:
   - Module boundaries
   - Package structure
   - Naming conventions
   - Folder organization

4. Framework Patterns:
   - React: Container/Presentational
   - Laravel: Service providers
   - WordPress: Plugin architecture
   - Cloudflare: Worker patterns

Return:
- Pattern usage report
- Style compliance score
- Organization assessment
- Best practice adherence

Agent 3: Complexity Analyzer

Analyze architectural complexity in [TARGET]

Tasks:
1. Structural Complexity:
   - Component coupling
   - Cohesion metrics
   - Abstraction levels
   - Interface complexit