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

designing-architecture для Claude Code: выбрать паттерн архитектуры

Скилл designing-architecture для Claude Code помогает выбрать архитектурный паттерн, оценить размер проекта и команды и структурировать код. Включается при проектировании системы и принятии архитектурных решений.

MIT ★ 1 424 обновлён 2026-10-06

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add CloudAI-X/claude-workflow-v2
/plugin install project-starter@claude-workflow
Открыть на GitHub

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

Скилл предлагает пошаговый процесс: сначала оцениваешь требования и ограничения, потом размер проекта и возможности команды, затем выбираешь паттерн из пяти основных — от простой слоистой архитектуры до микросервисов и event-driven систем. Для каждого паттерна указаны размер кода и команды, когда его использовать.

Внутри скилла — таблицы для выбора по размеру проекта и состав команды, готовые структуры папок для feature-based и layer-based подходов, чек-лист валидации и шаблон для документирования trade-off'ов. Всё привязано к принципам: начинать просто, развиваться при необходимости, оптимизировать под команду и требования.

Для каждого решения есть диаграмма, описание когда использовать и как валидировать выбор.

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

  • выбрать архитектурный паттерн под размер проекта
  • структурировать папки в новом проекте
  • оценить, когда нужны микросервисы вместо монолита
  • задокументировать архитектурные решения и trade-off'ы
  • валидировать архитектуру перед началом разработки

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

  • Помогу выбрать архитектуру для нового проекта на React и Node.js для команды из пяти человек
  • Как структурировать папки в Next.js приложении, если я один разработчик
  • Нужны микросервисы для системы обработки заказов или хватит модульного монолита

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

1Через маркетплейс плагинов

/plugin marketplace add CloudAI-X/claude-workflow-v2
/plugin install project-starter@claude-workflow

Команда ставит плагин project-starter целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add CloudAI-X/claude-workflow-v2 --skill designing-architecture -a claude-code

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

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

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

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

Вопросы о designing-architecture

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

Запусти /plugin marketplace add CloudAI-X/claude-workflow-v2, потом /plugin install project-starter@claude-workflow. Или установи через npm: npx skills add CloudAI-X/claude-workflow-v2 --skill designing-architecture -a claude-code.

Что делает этот скилл?

Помогает выбрать подходящий архитектурный паттерн, валидирует его под требования проекта и команду, предлагает структуру папок и шаблон для документирования решений.

Когда использовать слоистую архитектуру, а когда Clean Architecture?

Слоистую архитектуру используй для простых CRUD-приложений и прототипов. Clean Architecture подходит для сложной бизнес-логики, долгоживущих проектов и когда тестируемость критична.

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

SKILL.md · MIT
---
name: designing-architecture
description: Designs software architecture and selects appropriate patterns for projects. Use when designing systems, choosing architecture patterns, structuring projects, making technical decisions, or when asked about microservices, monoliths, or architectural approaches.
---

# Designing Architecture

### When to Load

- **Trigger**: System design, module structure, new project scaffolding, choosing architecture patterns
- **Skip**: Simple bug fixes or minor code changes that don't affect architecture

## Architecture Decision Workflow

Copy this checklist and track progress:

```
Architecture Design Progress:
- [ ] Step 1: Understand requirements and constraints
- [ ] Step 2: Assess project size and team capabilities
- [ ] Step 3: Select architecture pattern
- [ ] Step 4: Define directory structure
- [ ] Step 5: Document trade-offs and decision
- [ ] Step 6: Validate against decision framework
```

## Pattern Selection Guide

### By Project Size

| Size              | Recommended Pattern               |
| ----------------- | --------------------------------- |
| Small (<10K LOC)  | Simple MVC/Layered                |
| Medium (10K-100K) | Clean Architecture                |
| Large (>100K)     | Modular Monolith or Microservices |

### By Team Size

| Team      | Recommended                  |
| --------- | ---------------------------- |
| 1-3 devs  | Monolith with clear modules  |
| 4-10 devs | Modular Monolith             |
| 10+ devs  | Microservices (if justified) |

## Common Patterns

### 1. Layered Architecture

```
┌─────────────────────────────┐
│       Presentation          │  ← UI, API Controllers
├─────────────────────────────┤
│       Application           │  ← Use Cases, Services
├─────────────────────────────┤
│         Domain              │  ← Business Logic, Entities
├─────────────────────────────┤
│      Infrastructure         │  ← Database, External APIs
└─────────────────────────────┘
```

**Use when**: Simple CRUD apps, small teams, quick prototypes

### 2. Clean Architecture

```
┌─────────────────────────────────────┐
│            Frameworks & Drivers      │
│  ┌─────────────────────────────┐    │
│  │     Interface Adapters       │    │
│  │  ┌─────────────────────┐    │    │
│  │  │   Application       │    │    │
│  │  │  ┌─────────────┐    │    │    │
│  │  │  │   Domain    │    │    │    │
│  │  │  └─────────────┘    │    │    │
│  │  └─────────────────────┘    │    │
│  └─────────────────────────────┘    │
└─────────────────────────────────────┘
```

**Use when**: Complex business logic, long-lived projects, testability is key

### 3. Hexagonal (Ports & Adapters)

```
        ┌──────────┐
        │ HTTP API │
        └────┬─────┘
             │ Port
    ┌────────▼────────┐
    │                 │
    │   Application   │
    │     Core        │
    │                 │
    └────────┬────────┘
             │ Port
        ┌────▼─────┐
        │ Database │
        └──────────┘
```

**Use when**: Need to swap external dependencies, multiple entry points

### 4. Event-Driven Architecture

```
Producer → Event Bus → Consumer
              │
              ├─→ Consumer
              │
              └─→ Consumer
```

**Use when**: Loose coupling needed, async processing, scalability

### 5. CQRS (Command Query Responsibility Segregation)

```
┌─────────────┐      ┌─────────────┐
│  Commands   │      │   Queries   │
│  (Write)    │      │   (Read)    │
└──────┬──────┘      └──────┬──────┘
       │                    │
       ▼                    ▼
  Write Model          Read Model
       │                    │
       └────────┬───────────┘
                ▼
           Event Store
```

**Use when**: Different read/write scaling, complex domains, event sourcing

## Directory Structure Patterns

### Feature-Based (Recommended for medium+)

```
src/
├── features/
│   ├── users/
│   │   ├── api/
│   │   ├── components/
│   │   ├── hooks/
│   │   ├── services/
│   │   └── types/
│   └── orders/
│       ├── api/
│       ├── components/
│       └── ...
├── shared/
│   ├── components/
│   ├── hooks/
│   └── utils/
└── app/
    └── ...
```

### Layer-Based (Simple apps)

```
src/
├── controllers/
├── services/
├── models/
├── repositories/
└── utils/
```

## Decision Framework

When making architectural decisions, evaluate against these criteria:

1. **Simplicity** - Start simple, evolve when needed
2. **Team Skills** - Match architecture to team capabilities
3. **Requirements** - Let business needs drive decisions
4. **Scalability** - Consider growth trajectory
5. **Maintainability** - Optimize for change

## Trade-off Analysis Template

Use this template to document architectural decisions:

```markdown
## Decision: [What we're deciding]

### Context

[Why this decision is needed now]

### Options Considered

1. Option A: [Description]
2. Option B: [Description]

### Trade-offs

| Criteria         | Option A | Option B |
| ---------------- | -------- | -------- |
| Complexity       | Low      | High     |
| Scalability      | Medium   | High     |
| Team familiarity | High     | Low      |

### Decision

We chose [Option] because [reasoning].

### Consequences

- [What this enables]
- [What this constrains]
```

## Validation Checklist

After selecting an architecture, validate against:

```
Architecture Validation:
- [ ] Matches project size and complexity
- [ ] Aligns with team skills and experience
- [ ] Supports current requirements
- [ ] Allows for anticipated growth
- [ ] Dependencies flow inward (core has no external deps)
- [ ] Clear boundaries between modules/layers
- [ ] Testing strategy is feasible
- [ ] Trade-offs are documented
```

If validation fails, reconsider the pattern selection or adjust the implementation approach.

© CloudAI-X · MIT · CloudAI-X/claude-workflow-v2

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

Все скиллы по теме «Бэкенд и API» →
architecture-modernizer davila7 Субагент architecture-modernizer для Claude Code проектирует разбиение монолита, микросервисы и событийные потоки. Вызывайте его для анализа границ модулей и планирования модернизации архитектуры. CX Codex 1 768установок architecture-designer https://github.com/Jeffallan Скилл architecture-designer проектирует архитектуру распределённых систем, составляет диаграммы Mermaid и оформляет решения через ADR. Помогает сопоставить требования с шаблонами вроде микросервисов или монолита. CX Codex +1 8 500установок design-expert personamanagmentlayer Скилл design-expert даёт агенту паттерны системного дизайна, масштабирования и распределённых систем с готовыми примерами кода на Python. CX Codex +1 178установок design-code-architecture wondelai Скилл design-code-architecture для Claude Code, Cursor и других платформ проводит вас через восемь фаз архитектурного проектирования — от границ и доменной модели через выбор данных до отказоустойчивости. CX Codex +1 2 700установок decomposition-planning-roadmap tech-leads-club Скилл decomposition-planning-roadmap для Claude Code создаёт план декомпозиции монолита и дорожную карту миграции. Он подключается к задачам по выбору порядка выделения сервисов и отслеживанию работ. CX Codex +1 322установок software-patterns bobmatnyc Скилл software-patterns для Claude Code и Codex: ведёт по дереву решений к паттерну под конкретную проблему — связанность, отказоустойчивость, границы сервисов. Разбирает код с запахами и циклическими вызовами между сервисами. CX Codex +1 390установок

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

Весь набор →
designing-apis Скилл designing-apis в Claude Code проектирует REST и GraphQL API: структурирует эндпоинты, описывает форматы запросов и ответов, настраивает обработку ошибок и версионирование. CX Codex +1 ★ 1 424звёзд репо parallel-analyze Команда parallel-analyze запускает четыре субагента разом: архитектура, безопасность, производительность и тесты. Сводит их находки в один отчёт с приоритетами. CX Codex +1 ★ 1 424звёзд репо managing-git Скилл managing-git помогает Claude Code вести ветки по GitHub Flow или Git Flow, оформлять коммиты по Conventional Commits и готовить пулл-реквесты по чек-листам. CX Codex +1 ★ 1 424звёзд репо code-reviewer Субагент code-reviewer для Claude, который читает изменённые файлы и выдаёт разбор по severity: логика, безопасность, производительность, тесты. CX Codex ★ 1 424звёзд репо optimizing-performance Скилл optimizing-performance для Claude Code пошагово диагностирует и ускоряет фронтенд, бэкенд и базы данных: сначала профилирует, затем ищет узкие места и проверяет результат по метрикам. CX Codex +1 ★ 1 424звёзд репо designing-tests Скилл designing-tests помогает спланировать тесты, подобрать их тип и проверить покрытие. Подключайте его, когда добавляете тесты или разбираете сбои. CX Codex +1 ★ 1 424звёзд репо debugger Субагент debugger ищет первопричину падений тестов, утечек памяти и сбоев в коде. Субагент проверяет гипотезы через воспроизведение и логирование, избегая слепых правок. CX Codex ★ 1 424звёзд репо docs-writer Субагент docs-writer читает код перед тем, как писать или обновлять документацию. Подключайте его для README, описаний API и инструкций к изменениям кода. CX Codex ★ 1 424звёзд репо

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

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