Overview
architecture-patterns is an open-source workflow skill for Claude Code and compatible agents, published by wshobson. Its author describes it as: “Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use this skill when designing clean architecture for a new microservice, when refactoring…”. The project has 39k stars on GitHub and is available under the MIT license. Add it to your setup with `/plugin marketplace add wshobson/agents`.
What architecture-patterns does
Master proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design to build maintainable, testable, and scalable systems.
What’s inside
The SKILL.md for architecture-patterns is organised into these sections:
- When to Use This Skill
- Core Concepts
- 1. Clean Architecture (Uncle Bob)
- 2. Hexagonal Architecture (Ports and Adapters)
- 3. Domain-Driven Design (DDD)
- Detailed patterns and worked examples
- Testing — In-Memory Adapters
- Troubleshooting
- Use case tests require a running database
- Circular imports between layers
- Framework decorators appearing in domain entities
- All logic ending up in controllers
Installation
Add architecture-patterns to your agent with:
/plugin marketplace add wshobson/agentsReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — ships a claude code plugin marketplace
- Codex — declared in the repository topics
- Cursor — declared in the repository topics
- OpenCode — declared in the repository topics
- GitHub Copilot — declared in the repository topics
- Antigravity — declared in the repository topics
License
architecture-patterns is published under the MIT license.
Strengths
- Clear MIT license — safe to read and adapt within its terms
- Ships in wshobson/agents, an established project with 39,066 GitHub stars
- Works with Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, Antigravity
- Actively maintained — repository updated in the last 90 days
- Its repository gained 669 GitHub stars over the last 24 days
Author
Topics
Frequently asked questions
- What does architecture-patterns do?
- Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use this skill when designing clean architecture for a new microservice, when refactoring a monolith to use bounded contexts, when implementing hexagonal or onion architecture patterns, or when debugging dependency cycles between application layers.
- How do I install architecture-patterns?
- Run /plugin marketplace add wshobson/agents in your agent, then reload your skills. Review the source at https://github.com/wshobson/agents before installing.
- Is architecture-patterns free to use?
- Yes. architecture-patterns is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.
- Which agents does architecture-patterns work with?
- architecture-patterns lists Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Antigravity — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does architecture-patterns come from?
- architecture-patterns ships inside wshobson/agents, a repository that contains 54 catalogued skills in total. The repository's 39,066 GitHub stars apply to that whole collection, not to this skill on its own.