skills.rest
cuongnm-dev
cuongnm-devCOMMUNITY
Explore all skills by this author →
GitHub

arch-review

Analyze software architecture and write reports to docs/architecture/{arch-id}.md.

Updated Aug 27, 2026
Search Tags:#architecture#documentation#analysis#code-quality#technical-debt#architecture-report
One-click install
npx skills add https://github.com/cuongnm-dev/team-ai-config --skill arch-review-cuongnm-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arch-review
Source: https://github.com/cuongnm-dev/team-ai-config/tree/main/cursor/skills/arch-review
Command: npx skills add https://github.com/cuongnm-dev/team-ai-config --skill arch-review-cuongnm-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides teams to survey project architecture and register technical debt, enabling informed decisions and targeted improvements.

Core Features & Use Cases

  • Dual-mode analysis: review mode (architecture survey) and tech-debt mode (debt catalog and prioritization). Outputs include a structured architecture report and a prioritized improvement plan. Use cases include evaluating large codebases, onboarding new engineers, and planning refactors across modules and services.

Quick Start

Provide the required inputs and run arch-review to generate the architecture report for your project.

Frequently Asked Questions about arch-review

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

FAQPage Schema
How do I analyze software architecture to identify technical debt?▼

To analyze software architecture and identify technical debt, you run an architecture review. This surveys project strengths, weaknesses, and debt across multi-module or multi-service codebases to generate a structured report.

Can I generate an architecture report for a multi-service codebase?▼

Yes, you can generate an architecture report for a multi-service codebase. The analysis evaluates multi-module and multi-service codebases, writing the final architecture report directly to docs/architecture/{arch-id}.md.

What is the best way to document technical debt for prioritized refactoring?▼

The best way to document technical debt for refactoring is using a dedicated tech-debt analysis mode. It catalogs existing debt and outputs a prioritized improvement plan to drive targeted refactor decisions across teams.

Does architecture review work for onboarding new engineers to a large codebase?▼

Yes, architecture review works for onboarding new engineers to a large codebase. The generated architecture report provides a comprehensive survey of project structure, enabling faster understanding of multi-module systems.

How do I start an architecture survey to plan improvements across modules?▼

To start an architecture survey, provide the required project inputs and run the review mode. It analyzes your codebase architecture and writes a structured report to docs/architecture/{arch-id}.md to guide improvement roadmaps.

Related Skills

Explore More Software Engineering Skills→
channingwaltonchanningwalton
3

BugMagnet

Analyze code modules to discover edge cases and coverage gaps.

Community
Advanced
tachyon-beeptachyon-beep
14

using-system-architect

Assess architecture quality and catalog technical debt from archaeologist outputs.

Community
Advanced
zhangzhang-111-izhangzhang-111-i
2

tech-debt-tracker

Scan codebases to identify, prioritize, and track technical debt.

Community
Advanced
HomericIntelligenceHomericIntelligence
18

detect-code-smells

Detect code smells and complexity issues in codebases.

Official
Intermediate