Architecture Anti Patterns
Identify and avoid common architectural mistakes. Recognize patterns of failure. Use when reviewing designs or learning from mistakes.
Install
/plugin marketplace add sethdford/claude-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add sethdford/claude-skills --skill architecture-anti-patternsgit clone --depth 1 https://github.com/sethdford/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/architect/architect-toolkit/skills/architecture-anti-patterns ~/.claude/skills/architecture-anti-patternsPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Architecture Anti-Patterns Recognize and avoid common architectural mistakes that lead to fragility, complexity, or failure. ## Context You are reviewing an architecture and want to spot common anti-patterns. Patterns of failure repeat across organizations. Learn them, recognize them, guide teams away from them. ## Domain Context Based on architecture and design anti-patterns research: - **God Object**: One class/service responsible for too much. Hard to change, test, understand. - **Big Ball of Mud**: No clear architecture. Code accretion with no structure. Hard to modify without breaking things. - **Circular Dependency**: A depends on B, B depends on A. Can't use A without B, vice versa. Breaks modularity. - **Database as Integration Point**: Services share database schema. Schema changes break all services. No independence. - **Premature Optimization**: Design for 10x scale when you have 1x. Overcomplex, unmaintainable. ## Instructions 1. **Common Anti-Patterns and Recognition**: - **Monolith Bloat**: Hundreds of thousands of lines in one service. Deploys take 30 min. Hard to test. Fix: decompose into services by business domain. - **Tight Coupling**: Service A calls Service B calls Service C synchronously. Cascade failure: A down → B unavailable → C affected. Fix: async, timeouts, circuit breakers, fallbacks.
Details
- Skill name
architecture-anti-patterns- Repository
- sethdford/claude-skills
- Path
architect/architect-toolkit/skills/architecture-anti-patterns/SKILL.md- License
- MIT
- Repo updated
- 11 March 2026
FAQ
What does the Architecture Anti Patterns skill do?
Identify and avoid common architectural mistakes. Recognize patterns of failure. Use when reviewing designs or learning from mistakes.
How do I install the Architecture Anti Patterns skill?
Claude Code plugin: /plugin marketplace add sethdford/claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Architecture Anti Patterns popular?
It lives in sethdford/claude-skills, which has 48 GitHub stars and 10 forks.
Related skills
A B Test Design
48sethdford/claude-skills
Design rigorous A/B tests with hypotheses, variants, metrics, and sample size calculations.
A B Test Design Pm
48sethdford/claude-skills
Analytics and experimentation skill for product managers.
Abuse Case Design
48sethdford/claude-skills
Design abuse cases (negative use cases) showing how attackers misuse system features. Use when identifying attacks that exploit intended functionality or business logic flaws.
Architecture Brief
48sethdford/claude-skills
Write concise executive summaries of architecture. Communicate decisions and tradeoffs to non-technical stakeholders. Use when presenting to leadership or documenting decisions.
API Versioning Strategy
48sethdford/claude-skills
Backward compatibility, deprecation policies, versioning schemes (URL, header, media type).
Architecture Decision Record
48sethdford/claude-skills
Document architectural decisions using ADR format. Use when making significant architectural choices that affect future development.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.