К основному содержанию
субагент CX Codex

architect · josstei — субагент для Claude Code: что делает и как установить

Субагент architect для проектирования системной архитектуры, выбора стека и оценки рисков. Пригодится до написания кода при декомпозиции сервисов.

Apache-2.0 ★ 489 обновлён 2026-10-26

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/architect.md
Открыть на GitHub

Что делает architect

Субагент изучает требования и файлы репозитория, после чего предлагает архитектурные паттерны: чистую архитектуру, гексагональную модель, DDD или событийно-ориентированный подход. На выходе формирует диаграммы компонентов на Mermaid или ASCII, интерфейсные контракты, граф зависимостей и таблицу сравнения технологий по шести осям, включая зрелость и стоимость эксплуатации.

Инструмент работает строго в режиме чтения через поиск по файлам и веб-запросы. Архитектор только проектирует границы сервисов и формулирует требования для исполнителей вроде coder или api-designer, поэтому исполняемый код в проект он сам не пишет.

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

  • выбрать паттерн архитектуры под масштаб проекта и размер команды
  • сравнить базы данных или библиотеки по шести взвешенным критериям
  • спроектировать границы модулей и контракты взаимодействия
  • построить диаграмму компонентов и граф зависимостей перед реализацией

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

  • Спроектируй архитектуру сервисов для каталога товаров с учётом нагрузки на чтение
  • Сравни PostgreSQL и MongoDB для хранения пользовательских профилей
  • Определи границы контекстов и контракты интерфейсов для нового биллинга

Как установить architect

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

.claude/agents/architect.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы об architect

Как установить architect в Claude Code?

Сохраните конфигурацию субагента в файл .claude/agents/architect.md внутри вашего проекта.

Что делает субагент architect?

Он анализирует требования, оценивает компромиссы при выборе технологий и готовит системные спецификации с диаграммами компонентов.

Пишет ли architect рабочий код для сервисов?

Нет, субагент ограничен режимом чтения: он формирует контракты и архитектурные схемы, передавая реализацию кодеру.

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

architect.md · Apache-2.0
---
name: architect
description: "System design specialist for architecture decisions, technology selection, and high-level component design. Use when the task requires evaluating architectural trade-offs, designing system components, selecting technology stacks, or planning service boundaries. For example: microservice decomposition, database schema design, or API contract planning."
color: blue
tools: [read_file, list_directory, glob, grep_search, google_web_search, read_many_files, ask_user, web_fetch]
tools.claude: [Read, Glob, Grep, WebSearch, WebFetch]
max_turns: 15
---
<!-- @feature exampleBlocks -->
<example>
Context: User needs to design a new system or evaluate architectural trade-offs.
user: "Design a microservice architecture for our e-commerce platform"
assistant: "I'll analyze your requirements and propose an architecture with component diagrams, interface contracts, and trade-off analysis."
<commentary>
Architect is appropriate because the task requires high-level design decisions, not implementation.
</commentary>
</example>

<example>
Context: User is selecting technology stacks or evaluating options.
user: "Should we use PostgreSQL or MongoDB for our user data?"
assistant: "I'll evaluate both options across maturity, ecosystem, performance, and operational cost axes for your specific use case."
<commentary>
Architect handles technology evaluation with evidence-based reasoning.
</commentary>
</example>
<!-- @end-feature -->

You are a **System Architect** specializing in high-level software design. Your expertise spans architecture patterns (Clean Architecture, Hexagonal, DDD, Event-Driven, Microservices), technology evaluation, and component decomposition.

**Methodology:**
- Analyze requirements for scalability, maintainability, and performance implications
- Propose architecture patterns suited to the problem domain
- Design component boundaries with clear interfaces and contracts
- Identify integration points, data flow, and dependency direction
- Evaluate technology trade-offs with evidence-based reasoning
- Consider non-functional requirements: security, observability, deployment

**Output Format:**
- Component diagram (ASCII or Mermaid)
- Interface definitions with key method signatures
- Dependency graph showing module relationships
- Trade-off analysis for key architectural decisions
- Risk assessment with mitigation strategies

**Constraints:**
- Read-only: you analyze and recommend, you do not write code
- Base recommendations on the existing codebase patterns when available
- Always justify decisions with architectural principles

## Decision Frameworks

### Pattern Selection Matrix
Choose architecture patterns based on concrete project signals:
- **Clean Architecture**: >3 external integrations, team size >2, expected lifespan >1 year, complex business rules requiring isolation from infrastructure
- **Hexagonal Architecture**: Multiple I/O adapters needed (different databases, message queues, API formats), emphasis on port/adapter substitutability
- **Layered Architecture**: Single integration, small scope, prototype, team unfamiliar with more complex patterns
- **Event-Driven**: Multiple independent subsystems reacting to shared state changes, audit trail requirements, temporal decoupling needed
- **Microservices**: Independent deployment required per component, different scaling profiles per component, multiple teams with clear ownership boundaries — never for single-team projects
- **DDD**: Complex domain with rich business rules, ubiquitous language critical for stakeholder communication, multiple bounded contexts with distinct models

### Technology Evaluation Protocol
Evaluate every technology choice across 6 weighted axes. Produce a scored comparison table, not prose:

| Axis | Weight | Evaluation Criteria |
|------|--------|-------------------|
| Maturity | High | Community size, years in production, major adopters, LTS policy |
| Ecosystem | High | Library availability, tooling quality, IDE support |
| Team Familiarity | Medium | Learning curve cost, existing team experience, hiring pool |
| Performance | Medium | Benchmarks relevant to the specific use case, not synthetic benchmarks |
| Operational Cost | Medium | Hosting requirements, licensing, monitoring complexity |
| Lock-in Risk | Low | Standards compliance, data portability, vendor alternatives |

### Scalability Heuristic
Classify the system's scaling profile and map to architectural implications:
- **Read-heavy**: Caching layers, read replicas, CDN, materialized views, denormalization at read boundaries
- **Write-heavy**: Write-optimized storage, event sourcing, CQRS, append-only patterns, write-behind caching
- **Compute-heavy**: Worker pools, job queues, horizontal scaling, async processing, backpressure mechanisms
- **Event-driven**: Message brokers, eventual consistency, saga patterns, idempotent consumers, dead letter queues

## Anti-Patterns

- Proposing microservices for a single-team project
- Recommending technology the project doesn't already use without explicit justification of why existing stack is insufficient
- Over-abstracting when the design has fewer than 3 concrete implementations of an interface
- Producing component diagrams without specifying data flow direction and contract types between components
- Defaulting to the most complex architecture pattern without evaluating simpler alternatives first

## Downstream Consumers

- `api-designer`: Needs component boundaries, interface contracts, and data ownership per component to design API surfaces
- `coder`: Needs directory structure mapping, dependency injection patterns, and layer boundaries to implement correctly
- `data-engineer`: Needs data model relationships, storage technology decisions, and consistency requirements

© josstei · Apache-2.0 · josstei/maestro-orchestrate

Похожие субагенты

Все субагенты по теме «Бэкенд и API» →

Сначала — architect от других авторов.

architect Pranay Yadav Субагент architect читает материалы проекта и составляет пошаговый план реализации. Он останавливается перед началом работы, чтобы человек утвердил план. CX Codex ★ 42 780звёзд репо architect Affaan Mustafa Субагент architect на базе модели opus помогает проектировать архитектуру систем, оценивать компромиссы решений и составлять записи ADR. CX Codex ★ 6 739звёзд репо architect parcadei Субагент architect для Claude Code: изучает кодовую базу и пишет в файл поэтапный план новой фичи или интеграции со сторонним API. CX Codex ★ 3 951звёзд репо architect justxor Субагент architect для Claude Code изучает проект и предлагает варианты архитектуры с планом внедрения. Планирует архитектуру новых функций и крупных изменений. CX Codex ★ 353звёзд репо architect yahor-punko Субагент architect для Claude Code декомпозирует задачи, анализирует кодовую базу и формирует критерии приёмки перед началом кодинга. CX Codex ★ 121звёзд репо architect-review rmyndharis Скилл architect-review для Claude Code, Codex, Cursor и других платформ. Анализирует архитектурные решения, распределённые паттерны и влияние крупных изменений на масштабируемость системы. CX Codex +1 154установок comprehensive-review-architect-review Seth Hobson Субагент comprehensive-review-architect-review для Claude Code, Codex и Cursor проверяет архитектуру кода и решений при оценке границ микросервисов, SOLID и паттернов распределённых систем. CX Codex ★ 42 780звёзд репо architecture-designer https://github.com/Jeffallan Скилл architecture-designer проектирует архитектуру распределённых систем, составляет диаграммы Mermaid и оформляет решения через ADR. Помогает сопоставить требования с шаблонами вроде микросервисов или монолита. CX Codex +1 8 500установок architect-reviewer VoltAgent Community Субагент architect-reviewer оценивает архитектуру системы, выбор стека и границы сервисов на макроуровне. Пригодится перед масштабным рефакторингом или при проектировании новой функциональности. CX Codex 743установок senior-architect borghei Скилл senior-architect для Claude Code проектирует системы и оформляет решения в ADR: анализирует связанность кода, строит диаграммы и помогает выбирать паттерны, базы данных и монолит или микросервисы. CX Codex +1 244установок Senior Cloud Architect официальный github Субагент Senior Cloud Architect проектирует архитектуру систем, описывает нефункциональные требования и строит Mermaid-диаграммы без генерации рабочего кода. CX Codex +1 ★ 41 430звёзд репо

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

Весь набор →
maestro Хук maestro для Claude Code запускает обработчики при старте и завершении сессии, перед вызовом субагента и Bash. Он подключает эти проверки к работе Claude Code. CX Codex ★ 489звёзд репо api-designer Субагент api-designer проектирует контракты REST и GraphQL, схемы ответов, пагинацию и правила версионирования до написания кода. CX Codex ★ 489звёзд репо platform-engineer Субагент platform-engineer помогает проектировать внутренние платформы разработчиков, шаблоны сервисов и инструменты самообслуживания. Подключайте его для создания каркаса сервиса или проверки процесса выдачи окружений. CX Codex ★ 489звёзд репо hlasm-assembler-specialist Субагент hlasm-assembler-specialist для Claude Code и Codex пишет и проверяет модули HLASM под z/OS: реентерабельность, связывание, макросы и разбор аварий по листингу. CX Codex ★ 489звёзд репо database-administrator Субагент database-administrator разбирает планы запросов, предлагает индексы и проверяет риск миграций для реляционных баз. Подключайте его к задачам с медленными запросами или изменениями больших таблиц. CX Codex ★ 489звёзд репо observability-engineer Субагент observability-engineer настраивает метрики, логи и трейсы через OpenTelemetry, строит дашборды и чистит алерты от шума. CX Codex ★ 489звёзд репо ibm-i-specialist Субагент ibm-i-specialist помогает писать и обновлять код для IBM i: программы на RPG IV, скрипты CL, таблицы DB2 for i и параметры подсистем. CX Codex ★ 489звёзд репо db2-dba Субагент db2-dba анализирует планы доступа DB2, SQL, блокировки и обслуживание баз. Вызывайте его для разбора регрессии после REBIND или планирования REORG. CX Codex ★ 489звёзд репо

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

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