architecture-review

Architecture Review Command

2. **Component Documentation**
   - Document individual component responsibilities
   - Map component dependencies and interfaces
   - Analyze coupling and cohesion patterns
   - Identify reusable components and libraries

3. **Technical Debt Assessment**
   - Identify architectural inconsistencies
   - Analyze code quality and maintainability
   - Document technical debt and improvement opportunities
   - Assess scalability and performance bottlenecks

4. **Documentation Generation**
   - Create architecture diagrams and visualizations
   - Generate component interaction diagrams
   - Document API contracts and interfaces
   - Create deployment and infrastructure diagrams

5. **Review and Recommendations**
   - Assess architecture against industry best practices
   - Identify improvement opportunities
   - Document architectural decisions and rationale
   - Create roadmap for architectural evolution

6. **Knowledge Sharing**
   - Create architecture overview presentations
   - Document onboarding materials for new developers
   - Establish architecture review processes
   - Create decision logs and ADRs

# Generated documentation:
# - System overview diagrams
# - Component documentation
# - Technical debt analysis
# - Improvement recommendations
```

```bash
# Review specific architecture layer
/docs:architecture-review --layer=data-layer

# Layer-specific review:
# - Data architecture analysis
# - Database design review
# - Data flow documentation
# - Performance optimization
```

```bash
# Architecture review for scaling
/docs:architecture-review --focus=scalability

# Scalability-focused review:
# - Performance bottlenecks
# - Scaling strategies
# - Load balancing options
# - Infrastructure requirements
```