architecture-audit

Audit codebase architecture to identify structural risks and drift.

Updated Aug 20, 2025
One-click install
npx skills add https://github.com/BRANDNEWSHVT/mercora --skill architecture-audit-brandnewshvt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-audit
Source: https://github.com/BRANDNEWSHVT/mercora/tree/main/storefront-nuxt/.agents/skills/architecture-audit
Command: npx skills add https://github.com/BRANDNEWSHVT/mercora --skill architecture-audit-brandnewshvt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Evaluate the structural health of a codebase — patterns, coupling, cohesion, and alignment between what the code claims to be and what it actually is.

Core Features & Use Cases

  • Map the directory structure and identify architectural patterns (e.g., layered, hexagonal, microservices)
  • Verify dependency direction and detect circular or improper couplings
  • Assess cohesion, boundaries, and potential god modules
  • Highlight cross-cutting concerns (auth, logging, config) and architectural debt

Quick Start

Map the target codebase and run the architecture audit to reveal structural health and actionable recommendations.

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 for structural risks and drift?

To audit codebase architecture, map the directory structure to identify patterns, verify dependency direction, assess coupling and cohesion, and highlight cross-cutting concerns to deliver actionable findings.

What is architectural drift and how does it affect a codebase?

Architectural drift occurs when a codebase's actual structure diverges from its intended design. An architecture audit detects this by checking dependency direction, pattern usage, and cross-cutting concerns against structural expectations.

Can I use an architecture audit for mid-to-large codebases during refactoring?

Yes, architecture audits are specifically applicable to mid-to-large codebases during major refactors. They evaluate structural health by identifying god modules, improper couplings, and architectural debt to guide refactoring efforts.

How do I detect circular dependencies and improper couplings in my code?

Detect circular dependencies by mapping the codebase and verifying dependency direction. The audit checks for improper couplings and boundary violations to reveal structural risks across languages and platforms.

What is the best way to assess cohesion and identify god modules in a codebase?

The best way to assess cohesion is through an architecture audit that maps directory structure and evaluates boundaries. It identifies god modules and cross-cutting concerns like auth and logging to ensure alignment.

Does an architecture audit work across different programming languages and platforms?

Yes, the architecture audit works across languages and platforms. It evaluates structural health by checking pattern usage, dependency direction, coupling, and cohesion regardless of the underlying technology stack.