# feature-arch

Разбирает React-проект по фичам и выдаёт blueprint целевой архитектуры с деревом каталогов, публичными API и планом миграции.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 412 установок · ★ 218
- Автор: pproenca
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/pproenca/dot-skills/tree/HEAD/skills/.curated/feature-arch/SKILL.md
- Обновлён: 2026-08-15
- HTML: https://affpapa.org/nevibecode/skills/pproenca-feature-arch

## Что делает

Скилл задаёт правила организации React-приложения по фичам: 43 правила в 8 категориях, от структуры каталогов и импортов до тестов и нейминга. Приоритеты расставлены по влиянию — сначала критичное, потом мелочи вроде имён.

Когда агент вызывает скилл на реальном проекте, на выходе один файл `docs/architecture/FEATURE-ARCH-TARGET.md`. Внутри — контекст проекта, список фич, подтверждённый у пользователя, дерево каталогов с настоящими путями, точные экспорты каждого `index.ts`, матрица импортов N×N со значениями `allowed` / `forbidden` / `via app` / `via events`, владельцы состояния и данных, политика связи между фичами и нумерованный план миграции с оценками S/M/L. Каждый раздел ссылается на конкретные правила скилла, чтобы blueprint не превращался в отдельный свод.

Порядок работы такой: собрать контекст из `package.json`, дерева `src/`, README, `CLAUDE.md` и `openspec/`, выделить кандидатов в фичи, подтвердить список через `AskUserQuestion`, заполнить шаблон `assets/templates/feature-arch-target.md.template` и передать результат. Миграцию в том же ответе агент не запускает — сначала человек смотрит план. Для проектов меньше примерно 10 исходных файлов вместо полного blueprint выдаётся одностраничная заготовка структуры, а полный документ советует делать после второй-третьей фичи. Учтите: без `AskUserQuestion` шаг подтверждения списка фич не пройдёт, так что скилл рассчитан на платформы с этим инструментом.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill feature-arch -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill feature-arch -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill feature-arch -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pproenca/dot-skills feature-arch
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill feature-arch -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/pproenca/dot-skills --path skills/.curated/feature-arch
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add pproenca/dot-skills --skill feature-arch -a opencode
```

### Claude.ai

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

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

## Когда брать
- разложить React-проект по фичам вместо папок по типам файлов
- запретить импорты между фичами и описать границы матрицей
- зафиксировать публичный API каждой фичи через `index.ts`
- составить пошаговый план миграции с оценкой трудозатрат
- проверить код на нарушения архитектуры при ревью

## Примеры запросов агенту
- Сгенерируй blueprint целевой архитектуры для этого React-проекта по скиллу feature-arch
- Разбери структуру src/ и предложи, какие фичи выделить, потом подтверди список со мной
- Проверь импорты между фичами и покажи, где нарушены границы

## Похожие
- [arch-check](https://affpapa.org/nevibecode/skills/arch-check.md) — скилл · 2800 установок
- [avoid-feature-creep](https://affpapa.org/nevibecode/skills/avoid-feature-creep.md) — скилл · 1300 установок
- [feature-sliced-design](https://affpapa.org/nevibecode/skills/feature-sliced-design.md) — скилл · 23600 установок
- [cleaning-up-stale-feature-flags](https://affpapa.org/nevibecode/skills/cleaning-up-stale-feature-flags.md) — скилл · 434 установки
- [arch](https://affpapa.org/nevibecode/plugins/arch.md) — плагин · ★ 40418
- [breakdown-epic-arch](https://affpapa.org/nevibecode/skills/breakdown-epic-arch.md) — скилл · 9000 установок

## Другие версии с тем же именем
- [feature-arch · pymodel](https://affpapa.org/nevibecode/skills/feature-arch.md) — 473 установки

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

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