skills.rest
adolfoaranaes12
adolfoaranaes12COMMUNITY
Explore all skills by this author →
WebsiteGitHub

analyze-architecture

Analyze existing codebases to produce architecture reports with quality scores.

2|2|Updated Oct 28, 2025
Search Tags:#patterns#architecture analysis#brownfield#NFRs#ADRs
One-click install
npx skills add https://github.com/adolfoaranaes12/BMAD-ENHANCED --skill analyze-architecture
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: analyze-architecture
Source: https://github.com/adolfoaranaes12/BMAD-ENHANCED/tree/main/.claude/skills/analyze-architecture
Command: npx skills add https://github.com/adolfoaranaes12/BMAD-ENHANCED --skill analyze-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires document-project, ADR catalog, and includes references (resource) and scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill analyzes an existing codebase to discover structure, identify patterns, assess quality, and provide actionable modernization recommendations.

Core Features & Use Cases

  • Discover codebase structure and project type
  • Identify architecture patterns and technology stack
  • Produce a production-readiness score and recommendations
  • Generate a report with ADRs and NFR considerations

Quick Start

Analyze a brownfield codebase and generate a comprehensive architecture report.

Frequently Asked Questions about analyze-architecture

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

FAQPage Schema
How do I analyze an existing codebase to discover its architecture and structure?▼

Architecture analysis examines your codebase to identify structural patterns, project type, and technology stack. This Skill automatically discovers these elements in brownfield projects—legacy monorepos and undocumented systems—producing a detailed report with quality metrics and modernization recommendations.

Can I assess code quality and production readiness across multiple dimensions?▼

Yes. The Skill computes quality scores across eight dimensions and calculates a production-readiness score, giving you quantified insights into your system's current state alongside architectural findings.

How do I document non-functional requirements and architectural decisions for a legacy project?▼

The Skill generates a comprehensive report that includes Architecture Decision Records (ADRs) and non-functional requirement (NFR) considerations, capturing decisions and constraints for projects lacking formal documentation.

What's required before analyzing a codebase with this Skill?▼

You need your project documented through the document-project dependency and access to an ADR catalog. The Skill then processes your codebase structure to produce the comprehensive analysis.

Does this approach work for monorepos and undocumented legacy systems?▼

Yes. This Skill is specifically designed for brownfield scenarios including legacy monorepos and projects with minimal documentation, automatically discovering structure and patterns where formal records don't exist.

What should I do after generating an architecture analysis report?▼

Use the modernization recommendations and ADRs from the report to plan refactoring initiatives, document technical decisions, and establish a roadmap for incrementally improving code quality and production readiness.

Related Skills

Explore More Software Engineering Skills→
AnvinX1AnvinX1

architecture

Provide a structured ADR framework for architecture decisions.

Community
Intermediate
JamkrisJamkris
86

architecture-decision-records

Document architectural decisions as ADRs in a version-controlled format.

Community
Advanced
foomakersfoomakers
6

pair-capability-record-decision

Record technical decisions as ADRs or ADLs and update adoption files.

Official
Advanced
adolfoaranaes12adolfoaranaes12
2

production-readiness-checklist

Analyze brownfield codebases to identify architecture patterns and production readiness.

Community
Basic