Architecture Anti Patterns

Identify and avoid common architectural mistakes. Recognize patterns of failure. Use when reviewing designs or learning from mistakes.

48 stars 10 forksSoftware Development Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add sethdford/claude-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sethdford/claude-skills --skill architecture-anti-patterns
Manual install
git 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-patterns

Personal 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.
Read the full skill on GitHub

Details

Skill name
architecture-anti-patterns
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

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.