architecture-review

Analyze codebase architecture and design patterns for maintainability and scalability.

5|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/SteveFeldman/agents-skills --skill architecture-review-stevefeldman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/SteveFeldman/agents-skills/tree/main/skills/architecture-review
Command: npx skills add https://github.com/SteveFeldman/agents-skills --skill architecture-review-stevefeldman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps identify potential issues and areas for improvement in a codebase's architecture, ensuring maintainability, scalability, and adherence to best practices.

Core Features & Use Cases

  • Comprehensive Analysis: Evaluates various aspects of architecture including structure, data flow, resilience, security, and testability.
  • Targeted Reviews: Allows focusing the review on specific areas like data flow or security.
  • Use Case: A development team can use this skill before a major refactor to get a clear, objective assessment of their current architecture's strengths and weaknesses.

Quick Start

Run the architecture-review skill to perform a full review of the current codebase.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I analyze codebase architecture for maintainability and scalability?

To analyze codebase architecture, evaluate structure, data flow, resilience, security, and testability to assess maintainability and scalability. This process generates a scored report highlighting key strengths, critical issues, and actionable recommendations for architectural evolution.

Can I scope an architecture review to focus only on data flow or security?

Yes, you can scope an architecture review to focus on specific areas like data flow or security. This targeted review assesses design patterns and best practices within the chosen domain, providing a scored report with relevant critical issues and actionable recommendations.

What is the best way to assess design patterns before a major refactor?

The best way to assess design patterns before a major refactor is to perform a comprehensive architecture analysis. This evaluates adherence to best practices and maintainability, yielding an objective scored report of current strengths and weaknesses to guide refactoring efforts.

Does an architecture review provide actionable recommendations for code evolution?

An architecture review does provide actionable recommendations for code evolution. It analyzes design patterns and scalability to produce a scored report detailing key strengths and critical issues, ensuring maintainability and guiding the codebase's future development.

How do I evaluate codebase testability and resilience as part of an architecture review?

To evaluate codebase testability and resilience, perform a comprehensive architecture analysis. This review assesses these specific aspects alongside structure and data flow, delivering a scored report with critical issues and actionable recommendations for improvement.