What is architecture drift?

Architecture drift occurs when the actual implementation of a codebase diverges from its intended design, leading to hidden dependencies and maintenance challenges.

How does this skill detect boundary violations?

It analyzes import patterns and directory structures to ensure that layers (like domain or infrastructure) are not improperly coupled or importing internal logic they shouldn't access.

Does it require existing architecture documentation?

While it can use ARCHITECTURE.md or ADRs, the skill can also infer intended architecture from directory naming and package structures if documentation is missing.

Can it help with refactoring legacy code?

Yes, it identifies 'god modules', dead code paths, and excessive coupling, providing specific file locations and suggested fixes to guide your refactoring efforts.

Which programming languages are supported?

The skill uses language-appropriate patterns for major ecosystems including JavaScript/TypeScript, Python, Go, and Rust.

Architecture Coherence Audit

Name: Architecture Coherence Audit
Author: nsalvacao

bynsalvacao

0•

Developer Tools

Audits codebase structure to detect architectural drift, boundary violations, and structural debt.

Architecture Coherence is a specialized skill for Claude Code designed to identify discrepancies between a project's intended design and its actual implementation. It maps module boundaries, traces import graphs, and analyzes dependency directions to uncover silent issues like circular dependencies or layering violations. By evaluating coupling metrics and responsibility distribution, this skill helps developers maintain structural integrity, prevent technical debt, and ensure that the code matches the intended architectural patterns as the project scales.

Key Features

01Automatically maps module boundaries and dependency directions across multiple languages.

02Calculates coupling metrics (Afferent/Efferent) to pinpoint fragile or over-burdened modules.

030 GitHub stars

04Detects 'architecture drift' where code organization diverges from design documents or ADRs.

05Identifies circular dependencies and layer violations like cross-boundary imports.

06Provides a structural integrity score with specific, actionable refactoring recommendations.

Use Cases

01Auditing a legacy codebase to understand current structural debt before a major refactor.

02Automating architectural reviews during development to ensure new features respect existing boundaries.

03Validating that a monorepo or microservices project follows established dependency rules.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nsalvacao/nsalvacao-claude-code-plugins architecture-coherence

For use in Claude.ai and ChatGPT

Key Features

01Automatically maps module boundaries and dependency directions across multiple languages.

02Calculates coupling metrics (Afferent/Efferent) to pinpoint fragile or over-burdened modules.

030 GitHub stars

04Detects 'architecture drift' where code organization diverges from design documents or ADRs.

05Identifies circular dependencies and layer violations like cross-boundary imports.

06Provides a structural integrity score with specific, actionable refactoring recommendations.

Use Cases

01Auditing a legacy codebase to understand current structural debt before a major refactor.

02Automating architectural reviews during development to ensure new features respect existing boundaries.

03Validating that a monorepo or microservices project follows established dependency rules.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nsalvacao/nsalvacao-claude-code-plugins architecture-coherence

For use in Claude.ai and ChatGPT