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

Ready to run

npx skills add https://github.com/cuongnm-dev/team-ai-config --skill arch-review-cuongnm-dev

💬 Prompt for ChatGPT / Claude Chat▼

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.