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

team-architecture — скилл для Claude Code: архитектура и установка

Скилл team-architecture для Claude Code помогает спроектировать архитектуру приложения: от модели данных и API до границ модулей и рисков. Подключается к запросам на техническое проектирование.

MIT ★ 71 обновлён 2026-11-13

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

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

team-architecture задаёт структуру архитектурного документа в Markdown: обзор, выбор технологий, модель данных, контракт API, границы модулей, масштабирование, безопасность и риски. Для каждого решения по технологиям требуется обоснование из контекста проекта; язык программирования и редактор в список решений не входят.

Скилл помогает описать поля и связи данных, правила удаления записей, методы API, ответы и ошибки, а также направление зависимостей между модулями. Для оценки масштабирования нужны конкретные пороги нагрузки. Если изменение схемы не сохраняет обратную совместимость, план миграции и отката обязателен.

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

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

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

  • Спроектируй архитектуру приложения и обоснуй выбор технологий контекстом проекта.
  • Опиши модель данных, контракт API и границы модулей для этого проекта.
  • Подготовь архитектурный документ с рисками, требованиями безопасности и порогами масштабирования.

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

1Через Skills CLI (Vercel)

npx skills add sametcelikbicak/opencode-team --skill team-architecture -a claude-code

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

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

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

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

Вопросы о team-architecture

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

Выполни npx skills add sametcelikbicak/opencode-team --skill team-architecture -a claude-code. Файл скилла находится по пути ~/.claude/skills/team-architecture/SKILL.md.

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

Помогает оформить проектную архитектуру: решения по технологиям, модель данных, контракт API, границы модулей, масштабирование, безопасность и риски. Результат оформляется в Markdown.

Когда нужен план отката схемы в team-architecture?

Если изменение схемы не сохраняет обратную совместимость, план миграции и отката обязателен.

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

SKILL.md · MIT
---
name: team-architecture
description: Technical architecture design methodology. Data model, API contract, module boundaries, technology selection rationale, scalability. The playbook of the architect role.
---

# Technical Architecture Design

## Core principle: the smallest working architecture

In an MVP, the architecture is the simplest structure that gets the job done. Every layer, every service, every abstraction must be a **proven need**.

Question: "What would happen without this?" → If the answer is "nothing would happen", delete that layer.

## 1. Technology selections

A table for each selection:

| Selection | Rationale | Alternative | Why the alternative was rejected |
|---|---|---|---|
| PostgreSQL | relational integrity, flexibility with JSONB | MongoDB | schema is less explicit, queries are not relational |

The rationale must come from **the project context**: "it will run on a single server, there will be 5 users, relational data integrity is essential". "Most popular" is not a rationale.

List only the selections that **require a decision**. Do not write decisions like the language choice, the editor, formatters.

## 2. Data model

- Entities, fields (type + requiredness + default), relationships, constraints
- For each table: delete behavior (cascade or restrict)
- **Enums**: free text or a controlled list?
- **Time**: UTC or local? Timestamp format?
- **Money**: decimal, or integer cents? Which currency, and how is currency conversion handled?
- **Schema history**: backward compatible from the first version? If not, a migration + rollback plan is mandatory

Identity: UUID or auto-incrementing integer? Use UUID if there is a privacy requirement.

## 3. API contract

For each endpoint:

| Method | Path | Body | Response | Errors | Authentication |
|---|---|---|---|---|---|

Rules:
- Resources use plural naming (`/invoices`, `/users`)
- The response envelope should be consistent (the same shape in every response)
- Pagination, sorting and filtering semantics should be defined
- Standard error body: `{ error: { code, message, details? } }` — `message` is shown to the user, `details` is logged
- **Idempotency**: is a repeated POST safe? If not, `Idempotency-Key` support is required
- Versioning: a `/v1` path or a header? What is the breaking change policy?

Show an example request/response for one endpoint. The contract is where the frontend will work from — leave no ambiguity.

## 4. Module boundaries

```
domain/     → business rules, framework independent
application/→ use cases, calls the domain
adapters/   → framework, DB, HTTP
```

The dependency direction must be **inward**: `adapters → application → domain`. The domain does not depend on anything outside itself.

Write a one-sentence responsibility for each module. If a module has a two-sentence responsibility, it should be split.

## 5. Scalability

When does it become a problem? Give concrete thresholds:

| Resource | Today | Problem threshold | Mitigation |
|---|---|---|---|
| DB connections | 5 | 50+ concurrent | connection pool |
| Single server CPU | 10% | 70% | horizontal scaling |
| File storage | 2 GB | 50 GB | CDN |

Write a mitigation **only** if the threshold is genuinely close. Hypothetical scale-out design is the most common waste in an MVP.

## 6. Security boundaries

- Where is the authentication boundary? (session, token, OAuth provider)
- Authorization model: role, resource ownership, or both?
- Where do secrets live, who can access them, and how are they rotated?
- Which data is personal data, and which regulation applies (KVKK, GDPR)?

## 7. Risks

| Risk | Impact | Early signal | Mitigation |
|---|---|---|---|

## Common mistakes

| Mistake | The right way |
|---|---|
| Extracting microservices | Monolith + clean module boundaries |
| "It might change in the future" abstraction | No abstract class without a concrete need |
| Listing technologies without writing a decision | A rationale for every selection |
| A schema change without a rollback plan | A rollback plan is mandatory |
| Solving a scale problem that does not exist | Write a concrete threshold |

## Output format

Markdown. Sections: Overview / Technology selections / Data model / API contract / Module boundaries / Scalability / Security boundaries / Risks.

Explanations in the user's language (Turkish or English), schema/SQL/type definitions in English.

© sametcelikbicak · MIT · sametcelikbicak/opencode-team

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

Все скиллы по теме «Бэкенд и API» →
frontend-architecture manutej Скилл frontend-architecture для Claude Code и пяти других агентов: проектирует слои фронтенда, паттерны и границы модулей. Структурирует приложение до того, как кодовая база разрослась. CX Codex +1 729установок design-expert personamanagmentlayer Скилл design-expert даёт агенту паттерны системного дизайна, масштабирования и распределённых систем с готовыми примерами кода на Python. CX Codex +1 178установок architecture-well-architected-commerce vtex Скилл architecture-well-architected-commerce оценивает сквозную архитектуру проектов на VTEX по трём фундаментальным опорам. Помогает выбирать между готовыми функциями платформы и заказной разработкой. CX Codex +1 1 300установок enterprise-architecture-patterns manutej Скилл enterprise-architecture-patterns для Claude Code даёт агенту справочник по архитектурным паттернам для проектирования микросервисов. CX Codex +1 530установок prd-to-spec smallnest Скилл prd-to-spec преобразует PRD в технический SPEC с архитектурой, API, моделью данных и контрактами реализации. Нужен перед началом разработки. CX Codex +1 522установок dotnet-architecture-patterns wshaddix Скилл dotnet-architecture-patterns помогает проектировать Minimal API на .NET: настраивает вертикальные срезы, группы маршрутов, пайплайны и обработку ошибок. CX Codex +1 125установок

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

Весь набор →
team-qa Скилл team-qa для Claude Code превращает критерии приёмки в тесты и задаёт стратегию QA. Он помогает проверить граничные случаи, основные пользовательские сценарии и найденные баги. CX Codex +1 ★ 71звёзд репо team-ux Скилл team-ux для Claude Code составляет UX-спецификации интерфейсов без кода: описывает сценарии экранов, состояния, доступность по WCAG 2.1 AA и поведение на мобильных устройствах. CX Codex +1 ★ 71звёзд репо team-marketing Скилл team-marketing для Claude Code помогает спланировать маркетинг и запуск продукта: от позиционирования до календаря публикаций. Он подключается к задачам по подготовке сообщений, каналов продвижения и измеримых метрик. CX Codex +1 ★ 71звёзд репо team-market-research Скилл team-market-research для Claude Code проводит исследование рынка, конкурентов и аудитории. Включается при разборе ниши, проверке гипотезы продукта или анализе рисков. CX Codex +1 ★ 71звёзд репо team-security-review Скилл team-security-review для Claude Code проводит аудит безопасности кодовой базы. Он проверяет аутентификацию, права доступа, валидацию данных и утечки секретов. CX Codex +1 ★ 71звёзд репо team-backlog Скилл team-backlog для Claude Code разбивает PRD на вертикальные тикеты с критериями приёмки и зависимостями. После согласования он записывает их в .team/03-backlog.md. CX Codex +1 ★ 71звёзд репо team-release Скилл team-release для Claude Code ведёт выпуск по шагам: Semver с обоснованием, CHANGELOG, стадии CI, команды деплоя и план отката. Подключается, когда проект пора тегировать и выкатывать. CX Codex +1 ★ 71звёзд репо team-discipline Скилл team-discipline для Claude Code задаёт инженерные правила для каждой задачи с кодом. Он требует сначала разобраться в проекте, а затем внести минимальное полное изменение и проверить его. CX Codex +1 ★ 71звёзд репо

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

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