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

1.1 KiB

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)?