manage-instances — правило для Claude Code
Правило manage-instances для параллельного запуска нескольких изолированных стеков приложения в отдельных worktree, каждый со своей БД, Redis и портами.
Apache-2.0 ★ 1 216 обновлён 2026-10-24
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install polar-skills@claude-settingsЧто делает 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 ГБ и собственные тома сборки.
Какие задачи решает
- Запустить две ветки проекта параллельно, каждую в своём worktree
- Прогнать длинный тестовый прогон в одном инстансе, пока разрабатываешь в другом
- Сравнить поведение до и после изменения без остановки основного стека
- Закрепить worktree за фиксированным портом для интеграции с инструментами
- Очистить данные удалённых веток через
dev docker prune
Примеры запросов агенту
- Закрепи этот worktree за инстансом 5 и запусти стек
- Покажи все зарегистрированные инстансы и их статусы
- Удали данные инстансов, чьи worktree больше не существуют
Как установить manage-instances
1Через маркетплейс плагинов
/plugin marketplace add fcakyon/claude-codex-settings/plugin install polar-skills@claude-settings2Вручную: положить файлы
.claude/rules/manage-instances.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/manage-instances.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/manage-instances.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/manage-instances.mdВручную: положить файлы
.clinerules/manage-instances.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о manage-instances
Как установить правило manage-instances в Claude Code?
Выполните /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install polar-skills@claude-settings. Правило окажется в .claude/rules/manage-instances.md.
Что делает правило manage-instances?
Оно описывает модель изолированных инстансов приложения для проекта Polar: каждый worktree получает свой стек с собственными портами, БД и Redis-индексом, при этом инфраструктура остаётся общей.
Какие порты использует инстанс 5?
API на порту 8105, веб на 3105 (формула: база 8100/3100 плюс номер инстанса). База данных polar_dev_5, индекс Redis 5, бакеты polar-s3-5 и polar-s3-public-5.
Исходный текст
manage-instances.md · Apache-2.0
--- title: Managing Multiple Instances category: Operations tags: instances, parallel, isolation --- # Managing Multiple Instances ## What are instances? An instance is one worktree's isolated app stack (project `polar-app-<N>`). All instances share a single infra stack (`polar-shared`), but each gets: - Its own api/web **host ports** (offset per instance) - Its own database `polar_dev_<N>` on the shared postgres - Its own redis DB index `<N>` on the shared redis - Its own S3 buckets `polar-s3-<N>` / `polar-s3-public-<N>` on the shared minio So instances are cheap: only api/worker/web containers are duplicated, not the infra. ## Port mapping Only api and web publish host ports. Everything else is shared and reached by container name, so there is **no** per-instance `5532`/`6479`/`9100` — those ports don't exist in this model. | Service | Instance 0 | Instance 1 | Instance 2 | |---------|------------|------------|------------| | API (host) | 8000 | 8101 | 8102 | | Web (host) | 3000 | 3101 | 3102 | | DB (logical) | `polar_dev_0` | `polar_dev_1` | `polar_dev_2` | | Redis (DB index) | 0 | 1 | 2 | | S3 bucket | `polar-s3-0` | `polar-s3-1` | `polar-s3-2` | **Host-port formula (api/web only):** `Port = Base + Instance` (Base 8100 for api, 3100 for web), for instances 1–99. Instance 0 uses the legacy `8000`/`3000`. So instance 5 is api `8105` / web `3105`. Run `dev docker ports` in a worktree to print its resolved instance and URLs. ## Pinning and inspecting instances Auto-detection usually picks the right instance, but you can pin or inspect: ```bash dev docker set-instance 5 # pin this worktree to instance 5 (writes .env.docker + registry) dev docker clear-instance # back to auto-detect dev docker list # every registered instance: number, status, path dev docker prune # drop registry entries whose worktree is gone, and their data ``` Pinning makes ports deterministic, which is what you want when wiring a worktree into tooling like `.claude/launch.json`. ## Commands (explicit instance) Most commands auto-detect, but `-i N` targets one explicitly: ```bash dev docker up -i 1 -d # start instance 1 dev docker ps -i 1 # status dev docker logs -i 1 api # logs dev docker down -i 1 # stop dev docker shell -i 1 api # shell ``` ## Use cases - **Branch A vs branch B** side by side, each in its own worktree. - **Run a long test suite** in one instance while developing in another. - **Before/after comparisons** without tearing down your main stack. ## Resource notes Each app stack adds ~2 GB and its own build/cache volumes; the shared infra is paid once. Two or three instances is comfortable on a typical machine. Use `dev docker prune` to reclaim data from worktrees you've deleted.
© fcakyon · Apache-2.0 · fcakyon/claude-codex-settings