architecture-review

Provides architectural review and planning for software systems and teams.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/StarksJohn/CursorUserDir --skill architecture-review-starksjohn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/StarksJohn/CursorUserDir/tree/main/skills/architecture-review
Command: npx skills add https://github.com/StarksJohn/CursorUserDir --skill architecture-review-starksjohn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the need for rigorous architectural evaluation, ensuring modules have clear boundaries, systems are designed for scalability, and refactoring efforts are well-directed.

Core Features & Use Cases

  • Module Boundary Analysis: Examines responsibilities, dependencies, and interface stability between modules.
  • System Design Review: Assesses data flow, error handling, observability, and configuration management.
  • Scalability Assessment: Identifies potential bottlenecks and evaluates paths for future growth.
  • Refactoring Guidance: Provides actionable recommendations for improving code structure and maintainability.
  • Use Case: Before merging a significant new feature, use this Skill to review the proposed architecture, ensuring it aligns with best practices and won't introduce technical debt.

Quick Start

Ask the architecture review skill to examine the module boundaries for the current project.

Frequently Asked Questions about architecture-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review module boundaries and system design for my software project?

To review module boundaries and system design, analyze the responsibilities, dependencies, and data flow between modules. This architecture review assesses interface stability and evaluates error handling to ensure clear separations and maintainability.

What is included in a system design and scalability assessment?

A system design and scalability assessment identifies potential bottlenecks and evaluates paths for future growth. It examines data flow, configuration management, and observability factors to determine if the architecture supports increased load effectively.

When do I need an architecture review for module splitting?

You need an architecture review for module splitting before merging significant new features or when evaluating refactoring directions. It ensures proposed changes align with best practices and prevents introducing technical debt into the system.

Can I get refactoring guidance for improving code structure and maintainability?

Yes, you can get refactoring guidance for improving code structure and maintainability. The analysis provides actionable recommendations to direct refactoring efforts, ensuring modules have clear boundaries and well-defined responsibilities.

What's the best way to evaluate system design for error handling and observability?

The best way to evaluate system design for error handling and observability is through a dedicated architecture review. This process examines how data flows across modules and assesses configuration management to ensure reliable operations.