skills.rest
jeffabailey
jeffabaileyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

review-architecture

Analyze codebases for architectural fitness and generate remediation reports.

3|Updated Feb 21, 2026
Search Tags:#architecture#code review#refactoring#design patterns#maintainability#software quality
One-click install
npx skills add https://github.com/jeffabailey/skills --skill review-architecture-jeffabailey
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-architecture
Source: https://github.com/jeffabailey/skills/tree/main/src/review-architecture
Command: npx skills add https://github.com/jeffabailey/skills --skill review-architecture-jeffabailey

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill identifies and quantifies architectural weaknesses in codebases, helping to improve maintainability, scalability, and overall software quality.

Core Features & Use Cases

  • Automated Code Analysis: Scans code for common architectural anti-patterns.
  • Scoring Dimensions: Provides scores (1-10) across Coupling, Cohesion, Layering, Modularity, Naming, API Design, and Maintainability.
  • Use Case: Before a major refactor, use this Skill to get an objective assessment of the current architecture's health, pinpointing the most critical areas for improvement.

Quick Start

Use the review-architecture skill to analyze the current codebase for architectural fitness.

Frequently Asked Questions about review-architecture

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

FAQPage Schema
How do I assess my codebase for architectural fitness before a major refactor?▼

Assess architectural fitness by scanning your codebase to generate scores across coupling, cohesion, layering, modularity, naming, API design, and maintainability. This identifies structural problems and design violations with specific file:line evidence to pinpoint critical areas for improvement.

What is architectural fitness analysis and how does it improve software quality?▼

Architectural fitness analysis quantifies weaknesses in software codebases to improve maintainability and scalability. It evaluates code for common anti-patterns, generating a detailed report of structural problems and maintainability risks to guide remediation efforts.

How do I identify design violations and maintainability risks in my code?▼

Identify design violations and maintainability risks by analyzing your codebase for architectural anti-patterns. The process highlights structural problems with specific file:line evidence and severity levels, producing an actionable report for remediation.

Can I use an automated code analysis to score coupling and cohesion?▼

Yes, automated code analysis can score coupling and cohesion. It evaluates your software codebase across key dimensions, providing a 1-10 score for each to give an objective assessment of your current architecture's health.

What's the best way to generate an actionable report for code remediation?▼

Generate an actionable report for remediation by running a checklist-based architectural review on your codebase. This produces specific file:line evidence and severity levels for structural problems, creating a clear guide for fixing design violations.

When do I need to check my codebase for architectural anti-patterns?▼

Check your codebase for architectural anti-patterns when you need an objective assessment of your current architecture's health before a major refactor. This identifies structural problems and maintainability risks early, ensuring targeted improvements.

Related Skills

Explore More Software Engineering Skills→
mamu7211mamu7211

architecture-analysis

Analyze .NET codebase structure and dependency patterns for architectural reviews.

Community
Intermediate
AbdullahMalik17AbdullahMalik17
9

evaluation

Evaluate agent performance with weighted multi-dimensional rubric scores.

Community
Advanced
kriscendobotkriscendobot
3

coverage-driven-testing

Increase test coverage and identify unreachable code in a monorepo.

Community
Advanced
nayyirahsannayyirahsan

critique

Analyze design visual hierarchy, information architecture, and cognitive load with quantitative scoring.

Community
Advanced