skills.rest
shakhovskiya-create
shakhovskiya-createCOMMUNITY
Explore all skills by this author →
GitHub

architecture-audit

Identify architectural quality gaps in Python, JS, and Go codebases.

Updated May 5, 2026
Search Tags:#architecture#adr#c4#layering#dependency-graph#code-structure
One-click install
npx skills add https://github.com/shakhovskiya-create/shakhoff-claude-marketplace --skill architecture-audit-shakhovskiya-create
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture-audit
Source: https://github.com/shakhovskiya-create/shakhoff-claude-marketplace/tree/main/plugins/sdlc-audit/skills/architecture-audit
Command: npx skills add https://github.com/shakhovskiya-create/shakhoff-claude-marketplace --skill architecture-audit-shakhovskiya-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture audits translate code structure into architecture-level insights to reveal gaps, bottlenecks, and misalignments that threaten maintainability and scalability.

Core Features & Use Cases

  • C4 reverse-engineering diagrams inferred from code (context, container, component).
  • ADR gap analysis and coverage tracking to ensure architectural decisions are documented.
  • Deep module and layering violation checks to surface architectural smells.
  • Cyclic dependency detection and visualization to prevent brittle coupling.
  • Use Case: assess a monorepo to surface module boundaries and dependency flows for refactoring.

Quick Start

Run the architecture audit for your project to generate C4-inspired diagrams and ADR coverage checks.

Frequently Asked Questions about architecture-audit

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

FAQPage Schema
How do I audit codebase architecture to find maintainability and scalability gaps?▼

To audit codebase architecture, you can run an architecture audit that translates code structure into architecture-level insights. This process validates C4 model alignment, ADR coverage, layering rules, and dependency graphs to reveal bottlenecks and misalignments.

How do I reverse engineer a C4 model diagram from existing source code?▼

You can reverse engineer C4 model diagrams by analyzing your codebase structure. The architecture audit infers context, container, and component diagrams directly from code, generating Mermaid diagrams to visualize your system.

Can I use this architecture audit on Python, JavaScript, and Go projects?▼

Yes, architecture audits apply across Python, JS, and Go projects. You can use it during architecture reviews, codebase audits, and onboarding to validate layering rules and dependency graphs in these environments.

What is the best way to detect cyclic dependencies and layering violations in a monorepo?▼

The best way to detect cyclic dependencies and layering violations is through a deep module audit. This surfaces architectural smells, visualizes dependency flows, and highlights module boundaries to prevent brittle coupling in monorepos.

How does ADR gap analysis work during a codebase audit?▼

ADR gap analysis checks your codebase to ensure architectural decisions are documented. It tracks ADR coverage to identify missing decision records, helping you maintain alignment between implemented code structure and architectural intent.

Related Skills

Explore More Software Engineering Skills→
bejranondabejranonda
27

ast-analyzer

Parse Python, JavaScript, and TypeScript code into ASTs for structural analysis.

Community
Intermediate
nsalvacaonsalvacao

Architecture Coherence

Detect architecture drift by comparing declared architecture with actual code structure and dependencies.

Community
Advanced
GainInsightDevGainInsightDev

af-decide-architecture

Create and manage Architecture Decision Records with templates and an index.

Official
Advanced
VictorSmaniottoVictorSmaniotto

code-analyzer

Analyze PHP code for smells, complexity, duplications, and pattern violations.

Community
Intermediate