architecture-auditor

Audit modular monolith architectures for cross-context coupling and shared kernel growth.

14|1|Updated Oct 23, 2025
One-click install
npx skills add https://github.com/marcioaltoe/claude-craftkit --skill architecture-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-auditor
Source: https://github.com/marcioaltoe/claude-craftkit/tree/main/plugins/architecture-design/skills/architecture-auditor
Command: npx skills add https://github.com/marcioaltoe/claude-craftkit --skill architecture-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill systematically audits codebase architecture, evaluates design patterns, assesses technical debt, and verifies compliance against documented standards (e.g., CLAUDE.md, README.md). It identifies discrepancies and provides actionable recommendations for improvement.

Core Features & Use Cases

  • Documentation Compliance: Compares actual implementation against documented architecture patterns, identifying divergences.
  • Layer Analysis: Evaluates the separation and responsibilities of architectural layers (Domain, Application, Infrastructure, Presentation for backend; Feature-based for frontend).
  • Pattern & Tech Stack Verification: Checks adherence to SOLID principles, repository/gateway patterns, and required technologies.
  • Use Case: "Audit the frontend architecture of apps/web/ against our CLAUDE.md to identify any discrepancies and suggest improvements."

Quick Start

Audit the current project's architecture, focusing on layer separation and pattern compliance.

Frequently Asked Questions about architecture-auditor

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

FAQPage Schema
How do I audit my codebase architecture against documentation standards?

Architecture audit compares your actual implementation against documented patterns in files like CLAUDE.md or README.md, identifying divergences between intended design and current code structure to flag compliance gaps.

What is technical debt in modular monolith architecture and how do I detect it?

Technical debt in modular monoliths manifests as cross-context coupling, shared kernel growth, and core obesity. Detection involves measuring shared kernel imports, identifying disallowed cross-context patterns, and analyzing bounded context isolation violations.

How do I check if my architecture follows SOLID principles and design patterns?

Architecture audit evaluates adherence to SOLID principles, repository and gateway patterns, and required technologies by analyzing layer separation, responsibilities across domain, application, infrastructure, and presentation layers, then surfacing violations.

Can I audit both backend and frontend architecture separately?

Yes. Backend audits evaluate domain, application, infrastructure, and presentation layer separation; frontend audits assess feature-based layer organization. Both identify pattern compliance and architectural discrepancies relative to documented standards.

What output does an architecture audit produce?

Architecture audit produces evidence-backed reports with actionable recommendations, including shared kernel measurements, detected anti-patterns, cross-context import violations, and specific suggestions for improving compliance and reducing architectural debt.

When should I run architecture audits during code review?

Run audits during bounded context reviews, context isolation validation, and ADR compliance checks. They're especially useful when reviewing context structure changes, measuring shared kernel size, and detecting undocumented base classes or anti-patterns.