# system-architecture

Скилл system-architecture помогает выбрать слои и границы модулей в связке FastAPI и React, а результат складывает в architecture.md и ADR.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 125 установок · ★ 8 у репозитория
- Автор: platform-team
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hieutrtr/ai1-skills/tree/HEAD/skills/system-architecture/SKILL.md
- Обновлён: 2026-02-06
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/system-architecture

## Что делает

Скилл ведёт проект через архитектурные решения: раскладывает бэкенд на роутеры, сервисы, репозитории и модели, а фронтенд — на страницы, лейауты, фичи, общие компоненты, хуки и api-слой. Импорты разрешены только в одну сторону: роутер видит сервис, сервис видит репозиторий, обратных зависимостей быть не должно.

Перед работой скилл ищет `plan.md` от `project-planner` и берёт объём задачи оттуда, иначе идёт от запроса. Дальше пять шагов: сформулировать проблему, собрать два-три варианта, прогнать их по таблице критериев (сопровождаемость и тестируемость весят больше всего), выбрать и записать решение вместе с отвергнутыми вариантами в ADR по шаблону `references/architecture-decision-record-template.md`. На выходе — `architecture.md` и файлы `docs/adr/ADR-NNN-<title>.md`.

Кода скилл не пишет. Из инструментов у него Read, Grep, Glob и Write, поэтому ни тестов, ни сборки он не запустит: реализация остаётся за `python-backend-expert` и `react-frontend-expert`, контракты API — за `/api-design-patterns`. Заявленная совместимость: Python 3.12+, FastAPI 0.115+, React 18+, SQLAlchemy 2.0+, TypeScript 5+.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hieutrtr/ai1-skills --skill system-architecture -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/system-architecture/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/system-architecture/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hieutrtr/ai1-skills --skill system-architecture -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/system-architecture/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hieutrtr/ai1-skills --skill system-architecture -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/system-architecture/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hieutrtr/ai1-skills skills/system-architecture
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/system-architecture/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hieutrtr/ai1-skills --skill system-architecture -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/hieutrtr/ai1-skills --path skills/system-architecture
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/system-architecture/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add hieutrtr/ai1-skills --skill system-architecture -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/hieutrtr/ai1-skills/tree/HEAD/skills/system-architecture/SKILL.md

## Когда брать
- Решить, где живёт бизнес-логика: в роутере или в сервисе
- Разложить React-приложение на страницы, фичи и общие компоненты
- Сравнить два варианта хранения состояния и зафиксировать выбор
- Записать принятое решение в ADR, чтобы через полгода не гадать
- Спланировать изменение схемы БД до того, как начнутся миграции

## Примеры запросов агенту
- Продумай архитектуру нового модуля заказов: какие слои, где границы, что писать в `architecture.md`
- Сравни два подхода к хранению состояния корзины и оформи решение как ADR в `docs/adr/`
- Опиши схему БД для подписок и риски изменения, потом запиши ADR

## Похожие
- [Python Backend Architecture Review](https://affpapa.org/nevibecode/skills/python-backend-architecture-review.md) — скилл · 528 установок
- [fastapi-production-architecture-cursorrules-prompt-file](https://affpapa.org/nevibecode/rules/fastapi-production-architecture-cursorrules-prompt-file.md) — правило · ★ 41178 у репозитория
- [System Architecture Reviewer](https://affpapa.org/nevibecode/agents/system-architecture-reviewer.md) — субагент · ★ 1627 у репозитория
- [enterprise-user-management-system-ai](https://affpapa.org/nevibecode/skills/enterprise-user-management-system-ai.md) — скилл · 249 установок
- [architecture-designer](https://affpapa.org/nevibecode/skills/architecture-designer.md) — скилл · 8500 установок
- [architecture](https://affpapa.org/nevibecode/skills/anthropics-architecture.md) — скилл · 7200 установок

Из того же набора: [hieutrtr/ai1-skills](https://affpapa.org/nevibecode/by/hieutrtr/ai1-skills.md) — 8 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
