design-patterns

Design Patterns ⚡

An agentic AI skill that scans your codebase, detects architectural debt, and generates production-ready refactored code using professional design patterns.

How It Works

When you invoke /design-patterns, it doesn't lecture you about theory. It runs a 4-phase process on your actual code:

DETECT → DIAGNOSE → DESIGN → DELIVER

1. Detect — Scans your file tree, maps imports, scores complexity, generates a "Heat Map" of architectural debt.
2. Diagnose — Classifies anti-patterns (God Object, Logic Leakage, Tight Coupling) with file:line evidence.
3. Design — Selects the optimal pattern from a 3-scale matrix (Code → Architecture → System).
4. Deliver — Generates production-ready boilerplate code specific to your framework.

Every recommendation comes with evidence. No pattern without pain.

The Iron Laws

1. NO PATTERN WITHOUT PAIN — Don't apply Factory just because textbooks say so.
2. EVIDENCE BEFORE ELEGANCE — If current code works and is testable: LEAVE IT ALONE.
3. INCREMENTAL OVER REVOLUTIONARY — One pattern, one module, one PR.

Requirements

This skill works with any of these AI coding tools:

Platform	Minimum Version
Claude Code (Anthropic)	Any version supporting plugins
Cursor	Any version supporting .cursor rules
Codex (OpenAI)	Any version supporting instruction URLs
OpenCode	Any version supporting .opencode

No dependencies to install. This is a pure prompt/instructions skill.

Installation

Install once. Works across Claude Code, Cursor, Codex, and OpenCode.

Claude Code

/plugin marketplace add VoDaiLocz/design-patterns
/plugin install design-patterns@design-patterns

Cursor

Copy the skill file into your project or global rules directory:

# Option A: Project-level (applies only to this project)
cp -r skills/design-patterns/ .cursor/rules/design-patterns/

# Option B: Clone and reference in Cursor settings → Rules → Add rule file
git clone https://github.com/VoDaiLocz/Design-Patterns.git
# Then add: skills/design-patterns/SKILL.md as a rule

Codex

Fetch and follow instructions from https://raw.githubusercontent.com/VoDaiLocz/Design-Patterns/main/.codex/INSTALL.md

OpenCode

Fetch and follow instructions from https://raw.githubusercontent.com/VoDaiLocz/Design-Patterns/main/.opencode/INSTALL.md

Manual (Any AI tool with file context)

# Copy the skill folder anywhere your AI tool reads context from
cp -r skills/design-patterns/ ~/.gemini/antigravity/skills/design-patterns/
# Or attach SKILL.md directly as a context file in your AI tool

Usage

/design-patterns <target>

Examples:

/design-patterns src/api/users         → Analyze specific module
/design-patterns "order processing"    → Analyze a feature
/design-patterns                       → Analyze entire project

Example Output

Input: /design-patterns src/api/routes.ts

## 📊 Architecture Health Score: 7/20

## 🔍 Detected Anti-Patterns
| # | Anti-Pattern      | File:Line           | Severity | Evidence                              |
|---|-------------------|---------------------|----------|---------------------------------------|
| 1 | Logic Leakage     | src/api/routes.ts:45| 🔴 High  | DB query inside route handler         |
| 2 | God Object        | src/api/routes.ts   | 🔴 High  | 450 lines, 12 functions, mixed logic  |
| 3 | Tight Coupling    | src/api/routes.ts:12| 🟡 Med   | Direct PrismaClient import            |

## 💡 Recommended Patterns
| Anti-Pattern   | → Pattern        | Scale        | Impact    |
|---------------|------------------|--------------|-----------|
| Logic Leakage | Service Layer    | Architecture | 3 files   |
| God Object    | SRP + Strategy   | Code         | 4 files   |
| Tight Coupling| Repository       | Architecture | 2 files   |

## 🏗️ Implementation Plan
Step 1: Create UserService, extract business logic from routes.ts
Step 2: Create UserRepository, move all Prisma calls
Step 3: Create OrderService + OrderRepository
Step 4: Thin routes.ts to HTTP-only controller

## 📝 Generated Code
[Framework-specific boilerplate for Next.js/FastAPI/NestJS...]

What's Inside

3-Scale Pattern Coverage

Scale	Patterns	Reference
🔬 Code-Level	23 GoF Patterns + 5 SOLID Principles	references/code-patterns.md
🏗️ Architecture	Clean, Hexagonal, DDD, CQRS, Service Layer, Repository	references/architecture-patterns.md
🌐 System	Microservices, Event-Driven, Circuit Breaker, Saga, API Gateway	references/system-patterns.md

Additional Capabilities (v1.1.0)