skills.rest
TonyQ-AI
TonyQ-AICOMMUNITY
Explore all skills by this author →
GitHub

arch-review

Evaluate software architecture design and code structure through rule-based engineering analysis.

9|Updated Jul 3, 2026
Search Tags:#architecture#code review#refactoring#system design#technical debt#engineering
One-click install
npx skills add https://github.com/TonyQ-AI/agents-workflow --skill arch-review-tonyq-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arch-review
Source: https://github.com/TonyQ-AI/agents-workflow/tree/main/skills/arch-review
Command: npx skills add https://github.com/TonyQ-AI/agents-workflow --skill arch-review-tonyq-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the lack of objective, expert-level oversight in software architecture, helping teams identify design flaws, architectural decay, and technical debt before they become critical bottlenecks.

Core Features & Use Cases

  • Expert Simulation: Simulates feedback from industry-leading architects like Martin Fowler and Linus Torvalds to provide diverse, high-level design perspectives.
  • Rule-Based Auditing: Evaluates architecture against classic engineering principles covering modularity, coupling, testability, and interface design.
  • Automated Diagnostics: Generates interactive HTML reports with dependency visualizations and actionable improvement lists to guide refactoring efforts.

Quick Start

Trigger the arch-review skill to perform a comprehensive audit of the current project architecture and generate a health report.

Frequently Asked Questions about arch-review

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

FAQPage Schema
How do I assess software architecture health and identify technical debt?▼

Assess software architecture health by evaluating code structure against engineering principles for modularity, coupling, testability, and maintainability to identify technical debt and architectural decay.

What is the best way to validate system design before development starts?▼

Validate system design through pre-development architectural reviews that simulate expert feedback and apply rule-based engineering analysis to catch design flaws before they become critical bottlenecks.

Can I get expert-level architecture review feedback without hiring a consultant?▼

Get expert-level architecture review feedback through expert simulation that models perspectives from industry-leading architects like Martin Fowler and Linus Torvalds to provide high-level design insights.

How do I check code coupling and modularity in an existing project?▼

Check code coupling and modularity through post-coding architectural scanning that audits the codebase against classic engineering principles and generates interactive HTML reports with dependency visualizations.

Does this architecture audit work for both pre-development design and post-coding scanning?▼

This architecture audit works for pre-development design validation, post-coding architectural scanning, and technical debt assessment within a structured development workflow.

How do I generate an actionable refactoring plan for my codebase?▼

Generate an actionable refactoring plan by running automated diagnostics that produce interactive HTML reports containing dependency visualizations and structured improvement lists to guide refactoring efforts.

Related Skills

Explore More Software Engineering Skills→
cloud-native-toolscloud-native-tools

study-project

Analyze software repositories to generate architecture reports and UML diagrams.

Official
Advanced
ntaksh42ntaksh42
1

code-smell-detector

Detect code smells and provide refactoring recommendations for software projects.

Community
Intermediate
chipoto69chipoto69
1

web-design-guidelines

Validate web UI code against Web Interface Guidelines and report violations.

Community
Intermediate
amanhsnamanhsn

code-reviewer

Analyze pull requests for complexity, risk, and code quality issues.

Community
Advanced