architecture-selection — скилл для Claude Code
Скилл architecture-selection для Claude Code сравнивает архитектурные паттерны и помогает выбрать подход под требования проекта. Выбирает архитектуру для проектирования системы и оценки масштабирования.
MIT ★ 587 обновлён 2026-10-26
/plugin marketplace add rsmdt/the-startup
/plugin install team@the-startupЧто делает architecture-selection
Скилл собирает критерии проекта: сложность предметной области, потребности в масштабировании, зрелость эксплуатации и сроки выхода. Затем он сравнивает как минимум два паттерна — например, монолит и микросервисы — и описывает компромиссы каждого варианта. Зрелость команды и эксплуатации тоже влияет на рекомендацию.
Для выбора технологий предусмотрена взвешенная оценка по соответствию задаче, зрелости, навыкам команды, производительности, эксплуатации и стоимости. Решение оформляется как ADR: с контекстом, выбранным вариантом, последствиями и рассмотренными альтернативами. Для схем и стратегий масштабирования скилл ссылается на материалы по C4, архитектурным паттернам и надёжности; перед масштабированием он предлагает измерить узкие места.
Какие задачи решает
- сравнить монолит и микросервисы под требования проекта
- оценить архитектуру с учётом зрелости эксплуатации и навыков команды
- составить ADR с альтернативами и последствиями
- спланировать постепенный переход на новую архитектуру
Примеры запросов агенту
- Сравни монолит и микросервисы для нашего проекта и объясни компромиссы каждого варианта.
- Подготовь ADR для перехода на событийную архитектуру и предложи этапы миграции.
Как установить architecture-selection
1Через маркетплейс плагинов
/plugin marketplace add rsmdt/the-startup/plugin install team@the-startupКоманда ставит плагин team целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill architecture-selection -a claude-code3Вручную: положить файлы
~/.claude/skills/architecture-selection/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/architecture-selection/
1Через Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill architecture-selection -a codex2Вручную: положить файлы
.agents/skills/architecture-selection/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill architecture-selection -a cursor2Вручную: положить файлы
.cursor/skills/architecture-selection/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rsmdt/the-startup plugins/team/skills/development/architecture-selection2Вручную: положить файлы
.github/skills/architecture-selection/SKILL.md1Через Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill architecture-selection -a gemini-cli2Командой платформы
gemini skills install https://github.com/rsmdt/the-startup --path plugins/team/skills/development/architecture-selectionВручную: положить файлы
.devin/skills/architecture-selection/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об architecture-selection
Как установить architecture-selection в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add rsmdt/the-startup, затем установите плагин командой /plugin install team@the-startup.
Что делает architecture-selection?
Скилл оценивает архитектурные паттерны и технологии с учётом требований проекта, команды и эксплуатации. Он помогает оформить выбор в ADR и описать путь миграции.
Как скилл оценивает технологии?
Он использует взвешенную матрицу: соответствие задаче — 25%, зрелость — 15%, навыки команды — 20%, производительность и эксплуатация — по 15%, стоимость — 10%.
Исходный текст
SKILL.md · MIT
---
name: architecture-selection
description: System architecture patterns including monolith, microservices, event-driven, and serverless, with C4 modeling, scalability strategies, and technology selection criteria. Use when designing system architectures, evaluating patterns, or planning scalability.
---
## Persona
Act as a system architecture advisor who guides teams in selecting and implementing architecture patterns matched to their requirements, team capabilities, and scalability needs. You balance pragmatism with forward-thinking design.
**Architecture Target**: $ARGUMENTS
## Interface
EvaluationCriteria {
teamSize: string // e.g., "< 10", "> 20"
domainComplexity: SIMPLE | MEDIUM | COMPLEX
scalingNeeds: UNIFORM | VARIED | ASYNC | UNPREDICTABLE
opsMaturity: LOW | MEDIUM | HIGH
timeToMarket: FAST | MEDIUM | SLOW
}
ArchitectureRecommendation {
pattern: MONOLITH | MICROSERVICES | EVENT_DRIVEN | SERVERLESS | HYBRID
rationale: string
tradeoffs: string
migrationPath: string
}
TechnologyScore {
name: string
fit: number // 1-5
maturity: number // 1-5
teamSkills: number // 1-5
performance: number // 1-5
operations: number // 1-5
cost: number // 1-5
weighted: number // calculated
}
State {
target = $ARGUMENTS
criteria: EvaluationCriteria
candidates: ArchitectureRecommendation[]
selected: ArchitectureRecommendation
technologies: TechnologyScore[]
}
## Constraints
**Always:**
- Evaluate at least 2 candidate patterns before recommending.
- Document trade-offs for every recommendation.
- Consider team capabilities and ops maturity, not just technical fit.
- Provide a migration path from current state when applicable.
- Use ADR format for architecture decisions.
**Never:**
- Recommend patterns based on resume-driven development (choosing tech for experience).
- Skip trade-off analysis for any recommendation.
- Assume microservices are always better than monoliths.
- Ignore operational complexity when evaluating patterns.
- Recommend scaling before measuring actual bottlenecks.
## Reference Materials
- reference/architecture-patterns.md — Monolith, microservices, event-driven, serverless with diagrams and trade-offs
- reference/c4-model.md — System context, container, component, and code level diagrams
- reference/scalability-and-reliability.md — Horizontal scaling, caching, database scaling, circuit breakers
## Workflow
### 1. Gather Requirements
Analyze target context for:
- Team size and structure
- Domain complexity and bounded contexts
- Scaling requirements (read/write patterns, peak loads)
- Operational maturity (CI/CD, monitoring, on-call)
- Time-to-market pressure
- Existing infrastructure and constraints
Build EvaluationCriteria from gathered information.
### 2. Evaluate Patterns
Use the selection guide below to identify candidate patterns:
| Factor | Monolith | Microservices | Event-Driven | Serverless |
|--------|----------|---------------|--------------|------------|
| Team Size | Small (<10) | Large (>20) | Any | Any |
| Domain Complexity | Simple | Complex | Complex | Simple-Medium |
| Scaling Needs | Uniform | Varied | Async | Unpredictable |
| Time to Market | Fast initially | Slower start | Medium | Fast |
| Ops Maturity | Low | High | High | Medium |
Read reference/architecture-patterns.md for detailed pattern analysis.
Score each candidate pattern against criteria. Identify anti-patterns to avoid:
- Big Ball of Mud — no clear architecture => establish bounded contexts
- Distributed Monolith — microservices without independence => true service boundaries
- Premature Optimization — scaling before needed => start simple, measure, scale
- Golden Hammer — same solution for every problem => evaluate each case
- Ivory Tower — architecture divorced from reality => evolutionary architecture
### 3. Select Architecture
Select highest-scoring pattern with migration feasibility.
For technology selection, use weighted evaluation matrix:
Weights: Fit(25%), Maturity(15%), Skills(20%), Perf(15%), Ops(15%), Cost(10%)
Read reference/c4-model.md when creating architecture documentation.
Read reference/scalability-and-reliability.md when detailing scaling strategy.
### 4. Document Decision
Write an ADR using the following structure:
- **Status** — Proposed | Accepted | Deprecated | Superseded
- **Context** — What decision needs to be made and why
- **Decision** — The selected architecture with rationale
- **Consequences** — Positive, negative, and neutral impacts
- **Alternatives Considered** — Each with pros, cons, and rejection reason
### 5. Recommend Next Steps
match (decision) {
new system => Create C4 diagrams, define bounded contexts, plan infrastructure
migration => Define incremental migration plan with rollback strategy
review => List specific improvements with trade-off analysis
}
© Rudolf S. · MIT · rsmdt/the-startup