architecture-review

Analyze a codebase and generate an architecture_overview.md with Mermaid diagrams.

Updated Sep 13, 2025
One-click install
npx skills add https://github.com/nobelk/claude-tools --skill architecture-review-nobelk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/nobelk/claude-tools/tree/main/skills/architecture-review
Command: npx skills add https://github.com/nobelk/claude-tools --skill architecture-review-nobelk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams systematically analyze a codebase to produce an architecture overview document that captures structure, patterns, and quality attributes.

Core Features & Use Cases

  • Map codebase structure and boundaries, identifying modules, layers, and dependencies.
  • Detect architectural patterns, anti-patterns, and design decisions to inform refactoring.
  • Produce an architecture_overview.md with diagrams, evidence traces, and actionable recommendations.

Quick Start

Generate an architecture_overview.md for the current codebase.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I generate an architecture overview document for my codebase?

To generate an architecture overview document, you analyze the codebase to map structure, detect design patterns, and produce an architecture_overview.md with evidence-backed findings and Mermaid diagrams.

What is the best way to analyze codebase structure before a refactor?

The best way to analyze codebase structure for refactoring is to systematically map module boundaries, dependencies, and anti-patterns, producing actionable recommendations aligned to an analysis framework.

Can I use architecture analysis to assess risks in a microservices codebase?

Yes, you can use architecture analysis to assess risks in a microservices codebase by evaluating quality attributes like extensibility, robustness, and maintainability across distributed service boundaries.

How does codebase architecture analysis identify design patterns and anti-patterns?

Codebase architecture analysis identifies design patterns and anti-patterns by systematically examining module layers and dependencies, documenting the findings with evidence traces in the generated overview document.

Does architecture review work for both monoliths and microservices?

Architecture review works for both monoliths and microservices, assessing structural boundaries and quality attributes to deliver concrete recommendations for various codebase architectures.

What should an architecture overview document contain for planning codebase changes?

An architecture overview document for planning changes should contain mapped codebase structure, detected patterns, Mermaid diagrams, evidence traces, and concrete refactor recommendations.