software-architecture-review

Analyze software architecture through a three-phase Discovery, Analysis, and Recommendations process.

346|50|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/liza-mas/liza --skill software-architecture-review-liza-mas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: software-architecture-review
Source: https://github.com/liza-mas/liza/tree/main/skills/software-architecture-review
Command: npx skills add https://github.com/liza-mas/liza --skill software-architecture-review-liza-mas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a disciplined framework for evaluating software architectures, surfacing design trade-offs, boundary violations, and risks to guide reliable system evolution.

Core Features & Use Cases

  • Phase-driven evaluation: Discovery, Analysis, and Recommendations to structure insights and decisions.
  • Boundary and risk analysis: Identify data flow, dependency boundaries, coupling hotspots, and potential failure modes.
  • Documentation output: Produce a central design-review artifact (REVIEW_FILE) with prioritized issues and a concise summary for stakeholders.

Quick Start

Use the Skill to perform an architecture review on a new project: start with a high-level overview, collect phase 1 findings, proceed to phase 2 analysis, then generate phase 3 recommendations and an updated review document.

Frequently Asked Questions about software-architecture-review

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

FAQPage Schema
What is software architecture review and when do I need it?

Software architecture review evaluates system design trade-offs, boundaries, and risks. You need it for new system evaluations, major refactors, and architecture health checks across codebases to guide reliable system evolution.

How do I perform an architecture review on an existing codebase?

Perform an architecture review using a three-phase process: Discovery to collect findings, Analysis to identify coupling hotspots and failure modes, and Recommendations to generate an updated review document with prioritized issues.

Can I use this architecture review process for major refactoring projects?

Yes, the architecture review process applies to major refactors. It evaluates dependency boundaries, data flow, and design trade-offs to produce a central design-review artifact with a concise summary for stakeholders.

What's the best way to document architecture risks and boundary violations?

The best way to document architecture risks is generating a REVIEW_FILE during the evaluation. This artifact captures prioritized findings, boundary violations, and a final summary to communicate design issues to stakeholders.

Does architecture review require any specific frameworks or dependencies?

No, architecture review requires no specific frameworks or dependencies. It provides a disciplined framework applicable across codebases to surface design trade-offs and potential failure modes without external tooling.