review-architecture

Name: review-architecture
Availability: InStock
Author: rockandrolla

Analyze codebase imports and dependencies to produce a scored architecture diagnostic report.

Updated Feb 26, 2026

Search Tags:#architecture #codebase #dependencies #review #scoring #diagnostic #boundaries

Ready to run

npx skills add https://github.com/rockandrolla13/blueprint --skill review-architecture-rockandrolla13

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: review-architecture
Source: https://github.com/rockandrolla13/blueprint/tree/main/review-architecture
Command: npx skills add https://github.com/rockandrolla13/blueprint --skill review-architecture-rockandrolla13

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Evaluate and diagnose the architectural integrity of an existing codebase, identifying boundaries, dependencies, and abstraction fitness to guide safe evolution.

Core Features & Use Cases

Codebase Summary: concise narrative of the system, its modules, and entry points.
Dimension Scoring: provides a multi-dimensional assessment (boundary quality, dependencies, abstraction, DRY, extensibility, testability, parallelisation) with actionable findings.
Dependency Graph: Mermaid diagram of import relationships with notes on violations.
Cadence & Handoff: recommended review cycles and when to re-run evaluation after major changes.

Quick Start

Point the skill at the repository root and request an architecture health assessment.

Frequently Asked Questions about review-architecture

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

FAQPage Schema

How do I audit codebase architecture to identify boundary violations and dependency issues?▼

To audit codebase architecture, the skill traces actual file imports, entry points, and tests to evaluate structural boundaries and dependency directions, producing a scored diagnostic report with a Mermaid dependency graph and concrete improvement guidance.

What is architectural fitness scoring and how does it evaluate codebase health?▼

Architectural fitness scoring evaluates codebase health across dimensions like boundary quality, dependencies, abstraction, DRY, extensibility, testability, and parallelisation, generating a multi-dimensional scorecard with actionable findings grounded in real file analysis.

How do I generate a dependency graph from existing codebase imports?▼

Generating a dependency graph from codebase imports involves tracing actual file relationships and entry points, which this skill does automatically, outputting a Mermaid diagram of import relationships with notes highlighting architectural violations.

Can I use this architecture review tool on any codebase without specific framework dependencies?▼

Yes, you can use this architecture review tool on any codebase by pointing it at the repository root. It requires no external dependencies or components, reading actual files directly to ground its diagnostic findings in reality.

When should I re-run a codebase architecture health assessment after major changes?▼

You should re-run a codebase architecture health assessment after major structural changes, as the skill provides recommended review cycles and handoff guidance indicating optimal cadences for re-evaluating dependency directions and abstraction fitness.

What is the best way to diagnose architectural integrity issues in an existing repository?▼

The best way to diagnose architectural integrity is reading actual repository files to trace imports, entry points, and tests, evaluating boundaries and abstraction fitness to produce a comprehensive codebase summary with scored findings and improvement guidance.