comprehensive-architecture-review

Analyze an entire codebase to surface architectural risks and improvement opportunities.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Expanly/expanly-claude-code-agents --skill comprehensive-architecture-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comprehensive-architecture-review
Source: https://github.com/Expanly/expanly-claude-code-agents/tree/main/plugins/gemini-codebase-architect/skills/comprehensive-architecture-review
Command: npx skills add https://github.com/Expanly/expanly-claude-code-agents --skill comprehensive-architecture-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a comprehensive, multi-phase architecture review of an entire codebase to surface structural issues, debt, and strategic improvements, enabling teams to plan refactors and document architectural decisions.

Core Features & Use Cases

  • Discovery & Mapping: Rapidly map project structure, tech stack, and dependencies to establish a clear baseline.
  • Phase-driven Analysis: Conducts discovery, mapping, clarifying questions, deep Gemini analysis, ADR creation, and actionable roadmaps.
  • Output & Guidance: Generates an Architecture Decision Record (ADR), health scores, debt inventory, and a prioritized improvement plan suitable for onboarding, refactors, or scale preparation.
  • Use Case: Ideal for onboarding new team members to an unfamiliar codebase or preparing for a major refactor or due diligence.

Quick Start

Load the comprehensive-architecture-review skill and run it against your repository with the Gemini CLI, e.g.: gemini -p comprehensive-architecture-review --path /path/to/your/repo

Frequently Asked Questions about comprehensive-architecture-review

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

FAQPage Schema
How do I analyze an entire codebase to surface architectural risks and tech debt?

To analyze an entire codebase for architectural risks and tech debt, you can use a multi-phase Gemini workflow that maps project structure, conducts deep analysis, and generates an ADR with a prioritized improvement plan.

How do I generate an Architecture Decision Record from an existing repository?

Generating an Architecture Decision Record from an existing repository involves mapping dependencies, evaluating structural health, and documenting decisions. A seven-phase analysis workflow outputs the ADR alongside actionable improvement roadmaps.

What is the best way to plan a major refactor across a multi-service repository?

Planning a major refactor across a multi-service repository requires establishing a clear baseline of the tech stack, identifying structural issues, and creating a debt inventory to guide a prioritized improvement plan before making changes.

Can I use a Gemini CLI workflow for onboarding new teams to an unfamiliar codebase?

Yes, you can use a Gemini CLI workflow for onboarding new teams to an unfamiliar codebase by running a comprehensive architecture review that maps the project structure and delivers health scores and improvement guidance.

Does a comprehensive architecture review work for both monoliths and multi-service repositories?

A comprehensive architecture review works for both monoliths and multi-service repositories, applying a seven-phase analysis workflow to map dependencies, surface structural issues, and produce an actionable improvement plan regardless of architecture style.

When do I need a dependency audit and architectural health scores before scaling?

You need a dependency audit and architectural health scores before scaling when preparing for due diligence or major refactors, ensuring you have a clear baseline of tech stack dependencies and a prioritized improvement plan to address structural debt.