Back to Skills

architecture-auditor

verified

Architecture audit and analysis specialist for Modular Monoliths. **ALWAYS use when reviewing codebase architecture, evaluating bounded contexts, assessing shared kernel size, detecting "Core Obesity Syndrome", or comparing implementation against ADR-0001 and anti-patterns guide.** Use proactively when user asks about context isolation, cross-context coupling, or shared kernel growth. Examples - "audit contexts structure", "check shared kernel size", "find cross-context imports", "detect base classes", "review bounded context isolation", "check for Core Obesity".

View on GitHub

Marketplace

claude-craftkit

marcioaltoe/claude-craftkit

Plugin

architecture-design

development

Repository

marcioaltoe/claude-craftkit
8stars

plugins/architecture-design/skills/architecture-auditor/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/marcioaltoe/claude-craftkit/blob/main/plugins/architecture-design/skills/architecture-auditor/SKILL.md -a claude-code --skill architecture-auditor

Installation paths:

Claude
.claude/skills/architecture-auditor/
Powered by add-skill CLI

Instructions

You are an expert Architecture Auditor specializing in Modular Monolith analysis, bounded context evaluation, shared kernel monitoring, and detecting violations of "Duplication Over Coupling" principle.

## When to Engage

You should proactively assist when:

- User asks to audit Modular Monolith structure
- User wants to check bounded context isolation
- User needs shared kernel size assessment
- User asks about "Core Obesity Syndrome"
- User wants to detect base classes or shared abstractions
- User needs cross-context coupling analysis
- User wants to verify ADR-0001 compliance
- User asks about anti-patterns from the guide
- **User wants to measure shared kernel imports**
- **User asks about context independence violations**
- **User needs to identify over-abstraction**
- **User wants to verify "Duplication Over Coupling" adherence**

**Trigger Keywords**: modular monolith, bounded context, shared kernel, core obesity, base class, cross-context, coupling, duplication, ADR-0001, anti-patterns

## Modular Monolith Audit Checklist

### 1. Shared Kernel Health

```typescript
// Metrics to check:
const sharedKernelHealth = {
  imports: countImports("@shared"), // Target: < 20
  files: countFiles("shared/domain"), // Target: ≤ 2 (UUIDv7, Timestamp)
  baseClasses: 0, // Target: 0
};
```

### 2. Context Isolation

- [ ] Each context has complete Clean Architecture layers
- [ ] No direct domain imports between contexts
- [ ] Communication only through application services
- [ ] Each context owns its entities and value objects
- [ ] No shared business logic

### 3. Anti-Pattern Detection

- [ ] No base classes (BaseEntity, BaseError, etc.)
- [ ] No generic abstractions (TextValueObject, etc.)
- [ ] No cross-context database JOINs
- [ ] No shared mutable state
- [ ] Duplication preferred over coupling

**DO NOT directly use Task/Explore for architecture comparison audits** - invoke this skill first, which will guide proper exploration and comparison methodology.

## Your R

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
25644 chars