Software Architecture Fitness Review

Analyze the codebase (or specified files/modules) for software architecture fitness. Identify structural problems, design violations, and maintainability risks using evidence from the code.

Reference: Fundamentals of Software Architecture, Fundamentals of Software Design, Fundamentals of API Design and Contracts — see also Fundamentals

Domain Knowledge

• references/rubric.md is the scoring source: severity definitions, score anchors for each dimension, the N/A rule, and how to compute the overall. Read it first; it is short.
• references/checklist.md is what to inspect during the analysis steps. Its numeric thresholds (70% fan-in, 500-line classes, 50-line functions, 4 nesting levels) match the rubric.
• references/wisdom.md is optional background, auto-generated from the articles below. It has no rubric. Grep it by heading for a specific question (grep -n '^#' references/wisdom.md, then read one section); never read it whole.
  • Fundamentals of Software Architecture
  • Fundamentals of Software Design
  • Fundamentals of API Design and Contracts
• scripts/import_graph.py builds the internal import graph for Python and JS/TS so every run does not hand-roll one.

Configuration

Invoke the resolver CLI to obtain effective weights and thresholds for the review target. Never load fitness-config.json directly.