| name | architecture-review |
| description | Review architectural decisions and design patterns for scalability and maintainability. Trigger with "review the architecture", "is this design scalable", "architecture feedback", or "design review". |
Architecture Review
Review system design and architectural decisions.
When to Use
- Evaluating a new feature's design before implementation
- Reviewing existing architecture for scaling concerns
- Assessing technical debt and refactoring priorities
Steps
- Understand the system context, constraints, and goals
- Evaluate data flow and component interactions
- Assess scalability: what happens at 10x, 100x current load
- Review separation of concerns and coupling
- Identify risks and suggest alternatives
Output Format
## Architecture Review -- [System/Feature]
### Context
[Understanding of the design being reviewed]
### Strengths
- [What is well-designed]
### Concerns
| Priority | Concern | Impact | Recommendation |
|----------|---------|--------|----------------|
| High | [concern] | [impact] | [recommendation] |
| Medium | [concern] | [impact] | [recommendation] |
### Scalability Assessment
- **Current load**: [Handles well / Struggling]
- **10x**: [What breaks first]
- **100x**: [What needs redesigning]
### Recommendations
1. [Highest priority architectural change]
2. [Second priority]