Agent skill · software engineering · erichowens
code-architecture
Application architecture patterns and code organization — clean architecture, hexagonal architecture, feature-based structure, dependency inversion, module boundaries, SOLID principles at module
Why this skill is useful
Provides specific architectural patterns and module organization strategies that the AI wouldn't reliably generate on its own.
What it needs
About 8k tokens when loaded. Last updated 2026-07-14. 180 stars on the source repository.
What this skill does
Code Architecture Architecture patterns and code organization that survive contact with reality. The goal is code you can still understand, test, and change 18 months after it was written. This covers the decisions made at the module and application level — not how to split services, not how to design schemas, but how to organize the code within a single deployable unit. When to Use Use for: Choosing an architecture pattern for a new project (clean, hexagonal, feature-based, vertical slice) Diagnosing architectural problems in existing code (fat controllers, circular deps, tangled business logic) Applying dependency inversion to untangle tightly coupled code Deciding on folder structure and module organization Applying SOLID principles at the module scale (not just class scale) Setting up dependency injection containers Defining module boundaries and barrel exports Designing the test pyramid relative to architecture layers NOT for: Splitting a monolith into microservices (use microservices-patterns) Database schema design, normalization, query optimization (use database-design-patterns) Framework-specific routing or middleware setup CI/CD pipeline architecture --- Core Decision: Which Architecture Pattern? --- Clean Architecture Layers The classic onion — each ring depends only inward, never outward. Dependency rule: Source code dependencies point inward only. Entities know nothing about use cases. Use cases know nothing about controllers. Controllers know nothing about database drivers. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills erichowens/code-architecture