claude-code-ultimate-guide/examples/rules/architecture-review.md
Florian BRUNIAUX 7d43b67bcd docs: add review-plan command + rules templates (inspired by Garry Tan)
Structured plan review across 4 axes (architecture, code quality, tests,
performance) as a reusable custom command with separate rules files.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 20:34:33 +01:00

33 lines
1.1 KiB
Markdown

---
description: "Architecture review criteria for plan and code reviews"
---
# Architecture Review Criteria
When reviewing architecture (plans or code), evaluate these dimensions:
## System Design
- Are component boundaries clear and well-defined?
- Does each component have a single, well-understood responsibility?
- Are interfaces between components minimal and well-documented?
## Dependencies
- Is the dependency graph acyclic and manageable?
- Are there circular dependencies that need breaking?
- Are external dependencies justified and up-to-date?
## Data Flow
- Is data ownership clear (which component is source of truth)?
- Are there potential bottlenecks in the data pipeline?
- Is data transformation happening at the right layer?
## Scaling
- What are the single points of failure?
- Where will the system break under 10x load?
- Are stateless and stateful components properly separated?
## Security
- Are authentication and authorization properly layered?
- Is data access controlled at the right boundaries?
- Are API boundaries validated (input sanitization, rate limiting)?
- Are secrets properly managed (no hardcoded values)?