Architecture Audit Plugin for Claude Code and Codex

SOLID covers class design. But architecture rot happens at a larger scale - tangled services, leaky abstractions, hidden coupling between modules, brittle failure propagation. By the time these problems surface, untangling them is far more expensive than fixing a single class.

So I built a second plugin.

beyond-solid-principles audits your codebase at the architecture level: modules, services, layers, and component boundaries. After installing, type /beyond-solid-principles and get an instant analysis covering ten system-level design principles:

• SoC - Separation of Concerns
• SRP-Sys - Single Responsibility (system-level)
• DRY - Don’t Repeat Yourself
• Demeter - Law of Demeter
• Coupling - Loose Coupling, High Cohesion
• Evolvability - Build for Change
• Resilience - Design for Failure
• KISS - Keep It Simple
• POLA - Principle of Least Surprise
• YAGNI - You Aren’t Gonna Need It

Each violation comes with a severity rating (HIGH / MEDIUM / LOW), the exact location, a clear explanation, and a concrete remediation suggestion. Want to focus on just one principle? Run /sw-dry or /sw-coupling. Want Claude to fix the violations? Ask it to refactor after the analysis.

The two plugins are designed to complement each other - solid-principles for class-level design, beyond-solid-principles for system-level architecture.

Works with any language and any architecture style - monoliths, microservices, serverless, event-driven, hexagonal.

claude plugin marketplace add florianbuetow/claude-code
claude plugin install beyond-solid-principles

Comment on LinkedIn

References

• beyond-solid-principles plugin on GitHub