# manage-instances

Правило manage-instances для параллельного запуска нескольких изолированных стеков приложения в отдельных worktree, каждый со своей БД, Redis и портами.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 1216 у репозитория
- Автор: fcakyon
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/fcakyon/claude-codex-settings/tree/HEAD/plugins/polar-skills/skills/polar-local-environment/rules/manage-instances.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/manage-instances

## Что делает

Правило описывает модель инстансов для проекта Polar: каждый инстанс — это изолированный стек приложения в отдельном worktree, с собственными портами хоста, базой данных `polar_dev_<N>`, индексом Redis и S3-бакетами. Инфраструктура (Postgres, Redis, MinIO) общая для всех инстансов, дублируются только контейнеры API, воркера и веба. Порты хоста вычисляются по формуле: база 8100 для API и 3100 для веба, плюс номер инстанса (инстанс 0 использует legacy-порты 8000/3000).

Правило включает команды `dev docker set-instance`, `dev docker list`, `dev docker prune` для закрепления worktree за конкретным инстансом, просмотра зарегистрированных инстансов и очистки данных удалённых веток. Все команды поддерживают флаг `-i N` для явного указания инстанса. Два-три инстанса удобно держать на типичной машине; каждый добавляет около 2 ГБ и собственные тома сборки.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add fcakyon/claude-codex-settings
```
В чате агента (не в терминале):
```text
/plugin install polar-skills@claude-settings
```

2. **Вручную: положить файлы**
- Файл: `.claude/rules/manage-instances.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/manage-instances.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/manage-instances.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/manage-instances.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/manage-instances.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/fcakyon/claude-codex-settings/tree/HEAD/plugins/polar-skills/skills/polar-local-environment/rules/manage-instances.md

## Когда брать
- Запустить две ветки проекта параллельно, каждую в своём worktree
- Прогнать длинный тестовый прогон в одном инстансе, пока разрабатываешь в другом
- Сравнить поведение до и после изменения без остановки основного стека
- Закрепить worktree за фиксированным портом для интеграции с инструментами
- Очистить данные удалённых веток через `dev docker prune`

## Примеры запросов агенту
- Закрепи этот worktree за инстансом 5 и запусти стек
- Покажи все зарегистрированные инстансы и их статусы
- Удали данные инстансов, чьи worktree больше не существуют

## Похожие
- [alibabacloud-mongodb-instances-manage](https://affpapa.org/nevibecode/skills/alibabacloud-mongodb-instances-manage.md) — скилл · 174 установки
- [infisical-self-host](https://affpapa.org/nevibecode/skills/infisical-self-host.md) — скилл · 834 установки
- [docker-compose-production](https://affpapa.org/nevibecode/skills/docker-compose-production.md) — скилл · 487 установок
- [GitLab Stack Config Generator](https://affpapa.org/nevibecode/skills/gitlab-stack-config-generator.md) — скилл · 303 установки
- [railway](https://affpapa.org/nevibecode/skills/railway.md) — скилл · ★ 301 у репозитория
- [creating-amazon-aurora-db-cluster-with-instances](https://affpapa.org/nevibecode/skills/creating-amazon-aurora-db-cluster-with-instances.md) — скилл · 6800 установок

Из того же набора: [fcakyon/claude-codex-settings](https://affpapa.org/nevibecode/by/fcakyon/claude-codex-settings.md) — 113 карточек

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

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