# Architecture Review

> Review architectural decisions and design patterns for scalability and maintainability. Trigger with "review the architecture", "is this design scalable", "architecture feedback", or "design review".

- Skill: `clawpod-app/architecture-review` (Agent Skill)
- Install (CLI): `npx skillmds@latest add clawpod-app/architecture-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/clawpod-app/architecture-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: clawpod-app (https://skillmd.com/u/clawpod-app)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/clawpod-app/architecture-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
1. Understand the system context, constraints, and goals
2. Evaluate data flow and component interactions
3. Assess scalability: what happens at 10x, 100x current load
4. Review separation of concerns and coupling
5. Identify risks and suggest alternatives

## Output Format
```markdown
## 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]
```