К основному содержанию
скилл CX Codex

software-architecture — скилл для Claude Code

Скилл software-architecture для Claude Code разбирает код по слоям через SOLID и Clean Architecture, показывая, где класс берёт на себя лишнюю ответственность.

MIT 150 установок ★ 9 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Bbeierle12/Skill-MCP-Claude --skill software-architecture -a claude-code
Открыть на GitHub

Что делает software-architecture

Скилл задаёт агенту рамку для разбора. Каждый принцип SOLID показан парой «плохо/хорошо» на TypeScript: класс User, который сам пишет в базу, шлёт письма и печатает отчёт, разъезжается на сущность, репозиторий и два сервиса. Дальше Open/Closed, подстановка Лисков, разделение интерфейсов и инверсия зависимостей — тоже с кодом до и после.

Clean Architecture разложена на четыре слоя: фреймворки, адаптеры интерфейсов, приложение и домен. Зависимости идут только внутрь. В примерах есть сущность User с методом changeName, value object Email с проверкой формата, сценарий CreateUserUseCase с хешированием пароля и отправкой приветственного письма, контроллер и репозиторий на Prisma.

Код везде на TypeScript, а сохранение в примере идёт через Prisma. На другом стеке агенту придётся переносить формы классов самому, так что готового шаблона под Python или Go здесь нет.

Какие задачи решает

  • разложить класс, который и сохраняет, и шлёт письма, на слои
  • заменить if по типу фигуры на интерфейс с методом area()
  • вынести сценарий создания пользователя в отдельный use case
  • убрать из контроллера прямые вызовы Prisma
  • поймать наследника, который ломает контракт базового класса

Примеры запросов агенту

  • Разбери OrderService по SOLID и покажи, где нарушен принцип единственной ответственности.
  • Спроектируй слои для нового сервиса: домен, сценарии, адаптеры и репозиторий.
  • Убери вызовы Prisma из UserController в репозиторий.

Как установить software-architecture

1Через Skills CLI (Vercel)

npx skills add Bbeierle12/Skill-MCP-Claude --skill software-architecture -a claude-code

2Вручную: положить файлы

~/.claude/skills/software-architecture/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/software-architecture/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о software-architecture

Как установить software-architecture в Claude Code?

Выполните npx skills add Bbeierle12/Skill-MCP-Claude --skill software-architecture -a claude-code, файл скилла появится в ~/.claude/skills/software-architecture/SKILL.md.

Что делает software-architecture?

Описывает пять принципов SOLID и слои Clean Architecture, каждый с примером кода на TypeScript до и после правки. Агент опирается на эти примеры, когда проектирует структуру или ревьюит ваш код.

На каком языке примеры в скилле?

На TypeScript: классы, интерфейсы и репозиторий на Prisma. Для другого стека шаблоны переносятся вручную.

Исходный текст

SKILL.md · MIT
---
name: software-architecture
description: Implements design patterns including Clean Architecture, SOLID principles, and comprehensive software design best practices. Use when designing systems, reviewing architecture, establishing patterns, or making structural decisions.
---

# Software Architecture

## SOLID Principles

### Single Responsibility Principle (SRP)
A class should have only one reason to change.

```typescript
// ❌ Bad: Multiple responsibilities
class User {
  saveToDatabase() { }
  sendEmail() { }
  generateReport() { }
}

// ✅ Good: Single responsibility
class User { }
class UserRepository { save(user: User) { } }
class EmailService { send(to: string) { } }
class ReportGenerator { generate(user: User) { } }
```

### Open/Closed Principle (OCP)
Open for extension, closed for modification.

```typescript
// ❌ Bad: Requires modification for new types
function calculateArea(shape: Shape) {
  if (shape.type === 'circle') {
    return Math.PI * shape.radius ** 2;
  } else if (shape.type === 'rectangle') {
    return shape.width * shape.height;
  }
  // Need to modify for new shapes
}

// ✅ Good: Extend without modification
interface Shape {
  area(): number;
}

class Circle implements Shape {
  constructor(private radius: number) {}
  area() { return Math.PI * this.radius ** 2; }
}

class Rectangle implements Shape {
  constructor(private width: number, private height: number) {}
  area() { return this.width * this.height; }
}
```

### Liskov Substitution Principle (LSP)
Subtypes must be substitutable for their base types.

```typescript
// ❌ Bad: Square violates Rectangle's contract
class Rectangle {
  setWidth(w: number) { this.width = w; }
  setHeight(h: number) { this.height = h; }
}

class Square extends Rectangle {
  setWidth(w: number) { this.width = w; this.height = w; } // Violates LSP
}

// ✅ Good: Separate hierarchies
interface Shape {
  area(): number;
}

class Rectangle implements Shape { }
class Square implements Shape { }
```

### Interface Segregation Principle (ISP)
Clients shouldn't depend on interfaces they don't use.

```typescript
// ❌ Bad: Fat interface
interface Worker {
  work(): void;
  eat(): void;
  sleep(): void;
}

// ✅ Good: Segregated interfaces
interface Workable { work(): void; }
interface Eatable { eat(): void; }
interface Sleepable { sleep(): void; }

class Human implements Workable, Eatable, Sleepable { }
class Robot implements Workable { }
```

### Dependency Inversion Principle (DIP)
Depend on abstractions, not concretions.

```typescript
// ❌ Bad: High-level depends on low-level
class UserService {
  private database = new MySQLDatabase();
}

// ✅ Good: Both depend on abstraction
interface Database {
  save(data: any): Promise<void>;
  find(id: string): Promise<any>;
}

class UserService {
  constructor(private database: Database) {}
}

// Now can inject any implementation
const service = new UserService(new MySQLDatabase());
const testService = new UserService(new MockDatabase());
```

## Clean Architecture

```
┌─────────────────────────────────────────────────┐
│                  Frameworks                      │
│  (Express, React, Database Drivers)              │
├─────────────────────────────────────────────────┤
│              Interface Adapters                  │
│  (Controllers, Presenters, Gateways)            │
├─────────────────────────────────────────────────┤
│              Application Layer                   │
│  (Use Cases, Application Services)              │
├─────────────────────────────────────────────────┤
│                Domain Layer                      │
│  (Entities, Value Objects, Domain Services)     │
└─────────────────────────────────────────────────┘

Dependencies point INWARD only.
Inner layers know nothing about outer layers.
```

### Domain Layer (Innermost)

```typescript
// entities/User.ts
export class User {
  constructor(
    public readonly id: string,
    public readonly email: Email,
    public name: string,
    private password: HashedPassword
  ) {}

  changeName(newName: string): void {
    if (newName.length < 2) {
      throw new DomainError('Name too short');
    }
    this.name = newName;
  }

  verifyPassword(plaintext: string): boolean {
    return this.password.verify(plaintext);
  }
}

// value-objects/Email.ts
export class Email {
  constructor(private readonly value: string) {
    if (!this.isValid(value)) {
      throw new DomainError('Invalid email');
    }
  }

  private isValid(email: string): boolean {
    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
  }

  toString(): string {
    return this.value;
  }
}
```

### Application Layer (Use Cases)

```typescript
// use-cases/CreateUser.ts
interface CreateUserInput {
  email: string;
  password: string;
  name: string;
}

interface CreateUserOutput {
  id: string;
  email: string;
  name: string;
}

export class CreateUserUseCase {
  constructor(
    private userRepository: UserRepository,
    private passwordHasher: PasswordHasher,
    private emailService: EmailService
  ) {}

  async execute(input: CreateUserInput): Promise<CreateUserOutput> {
    // Validate email uniqueness
    const existing = await this.userRepository.findByEmail(input.email);
    if (existing) {
      throw new ApplicationError('Email already exists');
    }

    // Create domain object
    const hashedPassword = await this.passwordHasher.hash(input.password);
    const user = new User(
      generateId(),
      new Email(input.email),
      input.name,
      hashedPassword
    );

    // Persist
    await this.userRepository.save(user);

    // Side effects
    await this.emailService.sendWelcome(user.email);

    return {
      id: user.id,
      email: user.email.toString(),
      name: user.name,
    };
  }
}
```

### Interface Adapters

```typescript
// controllers/UserController.ts
export class UserController {
  constructor(private createUserUseCase: CreateUserUseCase) {}

  async create(req: Request, res: Response): Promise<void> {
    const result = await this.createUserUseCase.execute({
      email: req.body.email,
      password: req.body.password,
      name: req.body.name,
    });

    res.status(201).json(result);
  }
}

// repositories/PrismaUserRepository.ts
export class PrismaUserRepository implements UserRepository {
  async save(user: User): Promise<void> {
    await prisma.user.create({
      data: {
        id: user.id,
        email: user.email.toString(),
        name: user.name,
      },
    });
  }

  async findByEmail(email: string): Promise<User | null> {
    const data = await prisma.user.findUnique({
      where: { email },
    });
    return data ? this.toDomain(data) : null;
  }

  private toDomain(data: PrismaUser): User {
    return new User(
      data.id,
      new Email(data.email),
      data.name,
      new HashedPassword(data.password)
    );
  }
}
```

## Design Patterns

### Repository Pattern
```typescript
interface Repository<T> {
  findById(id: string): Promise<T | null>;
  findAll(): Promise<T[]>;
  save(entity: T): Promise<void>;
  delete(id: string): Promise<void>;
}
```

### Factory Pattern
```typescript
interface PaymentProcessor {
  process(amount: number): Promise<void>;
}

class PaymentProcessorFactory {
  create(type: 'stripe' | 'paypal'): PaymentProcessor {
    switch (type) {
      case 'stripe': return new StripeProcessor();
      case 'paypal': return new PayPalProcessor();
    }
  }
}
```

### Strategy Pattern
```typescript
interface PricingStrategy {
  calculate(basePrice: number): number;
}

class RegularPricing implements PricingStrategy {
  calculate(basePrice: number) { return basePrice; }
}

class PremiumPricing implements PricingStrategy {
  calculate(basePrice: number) { return basePrice * 0.9; }
}

class Order {
  constructor(private pricingStrategy: PricingStrategy) {}
  
  getTotal(basePrice: number) {
    return this.pricingStrategy.calculate(basePrice);
  }
}
```

### Observer Pattern
```typescript
interface Observer<T> {
  update(data: T): void;
}

class EventEmitter<T> {
  private observers: Observer<T>[] = [];

  subscribe(observer: Observer<T>): void {
    this.observers.push(observer);
  }

  notify(data: T): void {
    this.observers.forEach(o => o.update(data));
  }
}
```

## Architecture Decision Records (ADR)

Document significant decisions:

```markdown
# ADR-001: Use PostgreSQL for Primary Database

## Status
Accepted

## Context
Need to choose a primary database for user data storage.

## Decision
Use PostgreSQL.

## Consequences
### Positive
- Strong consistency guarantees
- Rich query capabilities
- Well-supported ORMs

### Negative
- Requires more operational overhead than SQLite
- Horizontal scaling more complex than NoSQL
```

## Anti-Patterns to Avoid

### God Object
❌ One class that does everything

### Spaghetti Code
❌ No clear structure or flow

### Golden Hammer
❌ Using same solution for every problem

### Premature Optimization
❌ Optimizing before measuring

### Cargo Cult Programming
❌ Using patterns without understanding why

© Bbeierle12 · MIT · Bbeierle12/Skill-MCP-Claude

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
clean-architecture wondelai Скилл clean-architecture держит бизнес-правила отдельно от фреймворка и базы: исходники зависят только от внутренних слоёв, и это проверяется по чек-листу. CX Codex +1 8 000установок design-patterns-implementation aj-geddes Скилл design-patterns-implementation для Claude Code и Codex подбирает и применяет паттерны проектирования к архитектурным задачам. Включается при рефакторинге, на код-ревью архитектуры и при построении расширяемых систем. CX Codex +1 601установок architecture-patterns OrchestKit Скилл architecture-patterns проверяет соблюдение чистой архитектуры, деление бэкенда на слои и глубину вложенности папок. Включается при проектировании границ сервисов и рефакторинге. CX Codex +1 236установок code-architecture curiositech Скилл code-architecture с паттернами организации кода внутри одного приложения: чистая и гексагональная архитектура, структура по фичам, инверсия зависимостей и границы модулей. CX Codex +1 169установок software-design-principles databricks-solutions Скилл software-design-principles для Claude Code задаёт правила архитектурного ревью, планирования рефакторинга и проверки зависимостей. Помогает согласовать слои и зоны ответственности перед слиянием PR. CX Codex +1 ★ 38звёзд репо nestjs-oop-design-patterns amirtaherkhani Скилл nestjs-oop-design-patterns для Claude Code помогает применять ООП, SOLID и паттерны проектирования в NestJS и TypeScript. Подключается при написании и рефакторинге кода или поиске проблем в объектной модели. CX Codex +1 560установок

Из того же набора19

Весь набор →
particles-gpu Скилл particles-gpu генерирует системы частиц на GPU через Three.js и React Three Fiber. Помогает рендерить эффекты от 10 тысяч до миллионов точек без просадки кадров. CX Codex +1 173установок shader-fundamentals Скилл shader-fundamentals объясняет основы GLSL: шейдеры вершин и фрагментов, типы данных, координаты и передачу значений. Нужен при создании и отладке эффектов. CX Codex +1 173установок gsap-sequencing Скилл gsap-sequencing для Claude Code помогает собирать сложные последовательности GSAP с метками, вложенными таймлайнами и колбэками для анимации интерфейса. CX Codex +1 163установок audio-analysis Скилл audio-analysis для Claude Code помогает разбирать аудиосигнал через Tone.js и Web Audio API. Подключается для визуализаций, поиска битов и реактивных аудиоэффектов. CX Codex +1 151установок particles-physics Скилл particles-physics для Claude Code задаёт движение частиц через силы и поля. В анимациях можно использовать гравитацию, ветер, притяжение и турбулентность. CX Codex +1 134установок r3f-fundamentals Скилл r3f-fundamentals помогает настраивать сцены React Three Fiber, управлять камерами, источниками света и циклом рендеринга через декларативный синтаксис JSX. CX Codex +1 125установок shader-noise Скилл shader-noise для Claude Code даёт GLSL-функции процедурного шума для генерации текстур, ландшафтов, облаков и клеточных узоров в шейдерах. CX Codex +1 121установок form-ux-patterns Скилл form-ux-patterns для Claude Code помогает проектировать сложные формы: группировать поля, строить пошаговые сценарии и показывать условные поля. Охватывает оформление заказа и онбординг. CX Codex +1 120установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой