# architecture-feature-first

Скилл architecture-feature-first задаёт слоистую feature-first архитектуру для Flutter: где лежит UI, где данные и когда нужен доменный слой.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 674 у репозитория
- Автор: Ivanna Kaceviča
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/evanca/flutter-ai-rules/tree/HEAD/skills/architecture-feature-first/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/architecture-feature-first

## Что делает

Скилл описывает, как делить Flutter-приложение на UI-слой, слой данных и опциональный доменный слой с use cases, и как раскладывать файлы не по типу, а по фиче — всё, что относится к `auth` или `profile`, лежит в одной папке с подкаталогами `data/`, `ui/` и, если нужно, `domain/`.

Он не привязан к конкретному стейт-менеджменту: держатель бизнес-логики в UI-слое может называться ViewModel, Cubit, Controller или Notifier, правила слоёв одинаковы для всех. Репозиторий — единственный источник правды для данных, UI не может менять их напрямую и не обращается к сервисам, минуя репозиторий.

Отдельно расписан порядок внедрения зависимостей: сервисы передаются в репозитории через конструктор, репозитории — в держатели логики, а регистрация идёт через DI-контейнер вроде get_it. Для простых CRUD-приложений доменный слой с use cases скилл советует не добавлять.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add evanca/flutter-ai-rules
```
В чате агента (не в терминале):
```text
/plugin install flutter-ai-skills@flutter-ai-rules
```
Команда ставит плагин flutter-ai-skills целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
npx skills add evanca/flutter-ai-rules --skill architecture-feature-first -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add evanca/flutter-ai-rules --skill architecture-feature-first -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add evanca/flutter-ai-rules --skill architecture-feature-first -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install evanca/flutter-ai-rules skills/architecture-feature-first
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add evanca/flutter-ai-rules --skill architecture-feature-first -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/evanca/flutter-ai-rules --path skills/architecture-feature-first
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

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

## Когда брать
- разложить код Flutter-проекта по фичам, а не по типу файлов
- решить, в каком слое должна жить конкретная логика
- настроить передачу зависимостей через конструкторы для репозиториев и держателей логики
- понять, когда нужен доменный слой с use cases, а когда он лишний
- описать роли View, Repository и Service при переходе на слоистую архитектуру

## Примеры запросов агенту
- Спроектируй структуру папок для новой фичи `profile` по feature-first подходу
- Реши, в какой слой вынести логику кэширования для `AuthRepository`
- Опиши, как связать `AuthRepository` и `AuthApiService` через конструктор

## Похожие
- [flutter-architecture](https://affpapa.org/nevibecode/skills/flutter-architecture.md) — скилл · 1700 установок
- [flutter-apply-architecture-best-practices](https://affpapa.org/nevibecode/skills/flutter-apply-architecture-best-practices.md) — скилл · 47000 установок
- [swift-architecture-skill](https://affpapa.org/nevibecode/skills/swift-architecture-skill.md) — скилл · 2100 установок
- [flutter-development-guidelines-cursorrules-prompt-file](https://affpapa.org/nevibecode/rules/flutter-development-guidelines-cursorrules-prompt-file.md) — правило · ★ 41178 у репозитория
- [flutter](https://affpapa.org/nevibecode/rules/flutter.md) — правило · ★ 3589 у репозитория
- [ios-uikit-architecture](https://affpapa.org/nevibecode/skills/ios-uikit-architecture.md) — скилл · 145 установок

Из того же набора: [evanca/flutter-ai-rules](https://affpapa.org/nevibecode/by/evanca/flutter-ai-rules.md) — 39 карточек

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