complexity-assessment

Analyze codebases to reveal architecture, patterns, and production readiness.

2|2|Updated Oct 28, 2025
One-click install
npx skills add https://github.com/adolfoaranaes12/BMAD-ENHANCED --skill complexity-assessment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: complexity-assessment
Source: https://github.com/adolfoaranaes12/BMAD-ENHANCED/tree/main/.claude/skills/analyze-architecture/references/complexity-assessment.md
Command: npx skills add https://github.com/adolfoaranaes12/BMAD-ENHANCED --skill complexity-assessment

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This document defines a weighted approach to compute a complexity score for architecture depth recommendations.

Quick Start

Use the complexity assessment to determine ADR counts and documentation depth.

Frequently Asked Questions about complexity-assessment

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

FAQPage Schema
How do I assess project complexity to determine architecture depth?

Complexity assessment analyzes your codebase to reveal architectural structure, identify patterns, and compute a complexity score that guides how deep your architecture documentation and ADRs need to be. Scan your project to surface technology stack, quality dimensions, and production readiness, then use the score to tailor documentation effort.

When should I use complexity assessment on legacy or brownfield projects?

Use complexity assessment when inheriting, modernizing, or consolidating legacy systems and multi-repo monorepos. It discovers codebase structure, recognizes existing architectural patterns, and surfaces quality gaps across eight dimensions, so you know what architectural decisions need documenting before refactoring.

What does a complexity score tell me about ADR documentation requirements?

The complexity score indicates how many Architecture Decision Records you need and how thoroughly you should document architectural depth. Higher complexity projects benefit from more detailed ADRs; lower complexity may need fewer. The score directly guides your documentation strategy.

Can I use complexity assessment to evaluate production readiness?

Yes. The assessment computes a production readiness score across defined quality dimensions alongside the complexity score. It surfaces which dimensions need attention before deploying, helping you prioritize architectural improvements for production stability.

What output do I get from a complexity assessment?

You receive a comprehensive report containing the codebase structure, identified architectural patterns, technology stack with versions, eight quality dimension scores, an overall complexity score, a production readiness score, and actionable recommendations for architecture depth and documentation.

Does complexity assessment work with multi-repository monorepos?

Yes. Complexity assessment is designed for multi-repo monorepos and brownfield projects. It analyzes the overall structure across repositories, recognizes cross-repo patterns, and computes unified complexity and readiness scores for the entire system.