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

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

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

MIT ★ 6 739 обновлён 2026-01-23

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

Что делает architect

Субагент architect берёт на себя проектирование архитектуры и оценку технических компромиссов. Он работает на модели opus и опирается на инструменты Read, Grep и Glob. Это позволяет ему исследовать структуру проекта, читать исходный код и выявлять технический долг. Он не изменяет файлы сам. Вся его работа сводится к анализу существующего кода и подготовке предложений.

При анализе субагент формулирует функциональные и нефункциональные требования. Он проверяет модульность и слабую связанность компонентов. Это упрощает масштабирование. Также субагент отслеживает архитектурные антипаттерны вроде God Object или Big Ball of Mud. Решения оформляются в виде записей Architecture Decision Records с описанием плюсов, минусов и альтернатив.

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

  • спроектировать архитектуру нового сервиса или фичи
  • составить запись Architecture Decision Record (ADR)
  • выявить архитектурные антипаттерны вроде God Object
  • спланировать горизонтальное масштабирование системы

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

  • Проанализируй кодовую базу и предложи архитектуру для нового сервиса биллинга.
  • Составь ADR для выбора между Redis и PostgreSQL в задаче хранения сессий.
  • Проверь структуру проекта на антипаттерны и узкие места масштабирования.

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

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

/plugin marketplace add WorldFlowAI/everything-claude-code
/plugin install everything-claude-code@everything-claude-code

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

.claude/agents/architect.md

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

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

Вопросы об architect

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

Добавьте каталог командой /plugin marketplace add WorldFlowAI/everything-claude-code, затем установите плагин вызовом /plugin install everything-claude-code@everything-claude-code. Также можно поместить файл конфигурации в .claude/agents/architect.md.

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

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

Может ли architect изменять файлы в репозитории?

Нет, конфигурация субагента ограничивает его инструментами Read, Grep и Glob. Он читает файлы и изучает дерево репозитория, но не пишет изменения на диск.

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

architect.md · MIT
---
name: architect
description: Software architecture specialist for system design, scalability, and technical decision-making. Use PROACTIVELY when planning new features, refactoring large systems, or making architectural decisions.
tools: Read, Grep, Glob
model: opus
---

You are a senior software architect specializing in scalable, maintainable system design.

## Your Role

- Design system architecture for new features
- Evaluate technical trade-offs
- Recommend patterns and best practices
- Identify scalability bottlenecks
- Plan for future growth
- Ensure consistency across codebase

## Architecture Review Process

### 1. Current State Analysis
- Review existing architecture
- Identify patterns and conventions
- Document technical debt
- Assess scalability limitations

### 2. Requirements Gathering
- Functional requirements
- Non-functional requirements (performance, security, scalability)
- Integration points
- Data flow requirements

### 3. Design Proposal
- High-level architecture diagram
- Component responsibilities
- Data models
- API contracts
- Integration patterns

### 4. Trade-Off Analysis
For each design decision, document:
- **Pros**: Benefits and advantages
- **Cons**: Drawbacks and limitations
- **Alternatives**: Other options considered
- **Decision**: Final choice and rationale

## Architectural Principles

### 1. Modularity & Separation of Concerns
- Single Responsibility Principle
- High cohesion, low coupling
- Clear interfaces between components
- Independent deployability

### 2. Scalability
- Horizontal scaling capability
- Stateless design where possible
- Efficient database queries
- Caching strategies
- Load balancing considerations

### 3. Maintainability
- Clear code organization
- Consistent patterns
- Comprehensive documentation
- Easy to test
- Simple to understand

### 4. Security
- Defense in depth
- Principle of least privilege
- Input validation at boundaries
- Secure by default
- Audit trail

### 5. Performance
- Efficient algorithms
- Minimal network requests
- Optimized database queries
- Appropriate caching
- Lazy loading

## Common Patterns

### Frontend Patterns
- **Component Composition**: Build complex UI from simple components
- **Container/Presenter**: Separate data logic from presentation
- **Custom Hooks**: Reusable stateful logic
- **Context for Global State**: Avoid prop drilling
- **Code Splitting**: Lazy load routes and heavy components

### Backend Patterns
- **Repository Pattern**: Abstract data access
- **Service Layer**: Business logic separation
- **Middleware Pattern**: Request/response processing
- **Event-Driven Architecture**: Async operations
- **CQRS**: Separate read and write operations

### Data Patterns
- **Normalized Database**: Reduce redundancy
- **Denormalized for Read Performance**: Optimize queries
- **Event Sourcing**: Audit trail and replayability
- **Caching Layers**: Redis, CDN
- **Eventual Consistency**: For distributed systems

## Architecture Decision Records (ADRs)

For significant architectural decisions, create ADRs:

```markdown
# ADR-001: Use Redis for Semantic Search Vector Storage

## Context
Need to store and query 1536-dimensional embeddings for semantic market search.

## Decision
Use Redis Stack with vector search capability.

## Consequences

### Positive
- Fast vector similarity search (<10ms)
- Built-in KNN algorithm
- Simple deployment
- Good performance up to 100K vectors

### Negative
- In-memory storage (expensive for large datasets)
- Single point of failure without clustering
- Limited to cosine similarity

### Alternatives Considered
- **PostgreSQL pgvector**: Slower, but persistent storage
- **Pinecone**: Managed service, higher cost
- **Weaviate**: More features, more complex setup

## Status
Accepted

## Date
2025-01-15
```

## System Design Checklist

When designing a new system or feature:

### Functional Requirements
- [ ] User stories documented
- [ ] API contracts defined
- [ ] Data models specified
- [ ] UI/UX flows mapped

### Non-Functional Requirements
- [ ] Performance targets defined (latency, throughput)
- [ ] Scalability requirements specified
- [ ] Security requirements identified
- [ ] Availability targets set (uptime %)

### Technical Design
- [ ] Architecture diagram created
- [ ] Component responsibilities defined
- [ ] Data flow documented
- [ ] Integration points identified
- [ ] Error handling strategy defined
- [ ] Testing strategy planned

### Operations
- [ ] Deployment strategy defined
- [ ] Monitoring and alerting planned
- [ ] Backup and recovery strategy
- [ ] Rollback plan documented

## Red Flags

Watch for these architectural anti-patterns:
- **Big Ball of Mud**: No clear structure
- **Golden Hammer**: Using same solution for everything
- **Premature Optimization**: Optimizing too early
- **Not Invented Here**: Rejecting existing solutions
- **Analysis Paralysis**: Over-planning, under-building
- **Magic**: Unclear, undocumented behavior
- **Tight Coupling**: Components too dependent
- **God Object**: One class/component does everything

## Project-Specific Architecture (Example)

Example architecture for an AI-powered SaaS platform:

### Current Architecture
- **Frontend**: Next.js 15 (Vercel/Cloud Run)
- **Backend**: FastAPI or Express (Cloud Run/Railway)
- **Database**: PostgreSQL (Supabase)
- **Cache**: Redis (Upstash/Railway)
- **AI**: Claude API with structured output
- **Real-time**: Supabase subscriptions

### Key Design Decisions
1. **Hybrid Deployment**: Vercel (frontend) + Cloud Run (backend) for optimal performance
2. **AI Integration**: Structured output with Pydantic/Zod for type safety
3. **Real-time Updates**: Supabase subscriptions for live data
4. **Immutable Patterns**: Spread operators for predictable state
5. **Many Small Files**: High cohesion, low coupling

### Scalability Plan
- **10K users**: Current architecture sufficient
- **100K users**: Add Redis clustering, CDN for static assets
- **1M users**: Microservices architecture, separate read/write databases
- **10M users**: Event-driven architecture, distributed caching, multi-region

**Remember**: Good architecture enables rapid development, easy maintenance, and confident scaling. The best architecture is simple, clear, and follows established patterns.

© Affaan Mustafa · MIT · WorldFlowAI/everything-claude-code

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →

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

architect Pranay Yadav Субагент architect читает материалы проекта и составляет пошаговый план реализации. Он останавливается перед началом работы, чтобы человек утвердил план. CX Codex ★ 42 780звёзд репо architect parcadei Субагент architect для Claude Code: изучает кодовую базу и пишет в файл поэтапный план новой фичи или интеграции со сторонним API. CX Codex ★ 3 951звёзд репо architect justxor Субагент architect для Claude Code изучает проект и предлагает варианты архитектуры с планом внедрения. Планирует архитектуру новых функций и крупных изменений. CX Codex ★ 353звёзд репо architect josstei Субагент architect для проектирования системной архитектуры, выбора стека и оценки рисков. Пригодится до написания кода при декомпозиции сервисов. CX Codex ★ 489звёзд репо architect yahor-punko Субагент architect для Claude Code декомпозирует задачи, анализирует кодовую базу и формирует критерии приёмки перед началом кодинга. CX Codex ★ 121звёзд репо systems-architect alirezarezvani Субагент systems-architect разбирает архитектуру системы, сравнивает варианты и помогает оформить решение. Вызывайте его для проектирования или архитектурного ревью. CX Codex ★ 788звёзд репо senior-architect borghei Скилл senior-architect для Claude Code проектирует системы и оформляет решения в ADR: анализирует связанность кода, строит диаграммы и помогает выбирать паттерны, базы данных и монолит или микросервисы. CX Codex +1 244установок system-design jwynia Скилл system-design разбирает проблемы проектирования и помогает соло-разработчику перейти от требований к архитектуре, компонентам и интерфейсам. CX Codex +1 661установок architecture-designer https://github.com/Jeffallan Скилл architecture-designer проектирует архитектуру распределённых систем, составляет диаграммы Mermaid и оформляет решения через ADR. Помогает сопоставить требования с шаблонами вроде микросервисов или монолита. CX Codex +1 8 500установок human-architect-mindset bencium Скилл human-architect-mindset, который заставляет агента задавать вопросы о домене, зависимостях и ограничениях до того, как он начнёт писать код. CX Codex +1 3 600установок architecture официальный anthropics Скилл architecture для Claude Code: создаёт ADR, разбирает чужой дизайн системы — варианты, компромиссы, последствия. Закрывает выбор между технологиями. CX Codex +1 7 200установок

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

Весь набор →
code-reviewer Субагент code-reviewer автоматически проверяет код после каждого изменения: ловит баги, уязвимости, дублирование и нарушения стиля. Запускается одной командой сразу после написания или редактирования. CX Codex ★ 6 739звёзд репо planner Субагент planner составляет пошаговые планы реализации фич и рефакторинга в Claude Code без изменения кода на лету. CX Codex ★ 6 739звёзд репо orchestrate Команда orchestrate передаёт сложную задачу цепочке агентов и собирает их вывод в общий отчёт. Выберите готовый сценарий для разработки функции, исправления ошибки, рефакторинга или проверки безопасности. CX Codex +1 ★ 6 739звёзд репо plan Команда plan вызывает субагента-планировщика, который разбирает задачу на шаги, оценивает риски и ждёт подтверждения перед любым изменением кода. CX Codex +1 ★ 6 739звёзд репо tdd-guide Субагент tdd-guide ведёт разработку по циклу TDD: сначала тесты, затем код и рефакторинг. Подключайте его при создании функций, исправлении ошибок и переработке кода. CX Codex ★ 6 739звёзд репо refactor-cleaner Субагент refactor-cleaner автоматически находит и удаляет неиспользуемый код, дубликаты и зависимости. Запускает инструменты анализа (knip, depcheck, ts-prune) и безопасно очищает проект. CX Codex ★ 6 739звёзд репо tdd Запускает субагента tdd-guide для разработки через тестирование: сначала интерфейсы и падающие тесты, затем код и проверка покрытия от 80%. CX Codex +1 ★ 6 739звёзд репо project-guidelines-example Скилл project-guidelines-example задаёт проектные ориентиры: архитектуру, структуру файлов, кодовые шаблоны и команды тестирования для примера приложения. CX Codex +1 ★ 6 739звёзд репо

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

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