К основному содержанию
правило CX Codex

manage-instances — правило для Claude Code

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

Apache-2.0 ★ 1 216 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install polar-skills@claude-settings
Открыть на GitHub

Что делает 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-settings

2Вручную: положить файлы

.claude/rules/manage-instances.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: 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

Похожие правила IDE

Все правила IDE по теме «DevOps и инфраструктура» →
alibabacloud-mongodb-instances-manage aliyun Скилл alibabacloud-mongodb-instances-manage управляет кластерами и базами ApsaraDB for MongoDB в Alibaba Cloud через агент. Пригодится при настройке реплик, шардов, сетевых доступов и бэкапов. CX Codex +1 174установок infisical-self-host Infisical Скилл infisical-self-host помогает развернуть и настроить серверную платформу Infisical в Docker Compose или Kubernetes. Пригодится при настройке базы данных PostgreSQL, очередей Redis и параметров безопасности. CX Codex +1 834установок docker-compose-production TheBushidoCollective Скилл docker-compose-production готовит конфигурации Docker Compose для продакшена: задаёт лимиты ресурсов, проверки healthcheck, ротацию логов, секреты и изоляцию сетей. CX Codex +1 487установок GitLab Stack Config Generator rknall Скилл GitLab Stack Config Generator раскладывает конфиги nginx, PostgreSQL и Redis по ./config для GitLab-стека, тянет значения из .env и проверяет, что секреты не попали в файлы. CX Codex +1 303установок railway hoodini Разворачивает приложения на Railway, подключает базы данных и настраивает сервисы. Работает с контейнерными проектами и несколькими компонентами. CX Codex +1 ★ 301звёзд репо creating-amazon-aurora-db-cluster-with-instances aws Скилл creating-amazon-aurora-db-cluster-with-instances создаёт Aurora-кластер с инстансами, настраивает пароль через Secrets Manager и следит за статусом с повторами. Для MySQL и PostgreSQL. CX Codex +1 6 800установок

Из того же набора113

Весь набор →
shell-and-workflows Правило shell-and-workflows описывает работу с Docker-сервисами проекта, типовые команды и порядок запуска тестов. Помогает выбрать, где выполнять фронтенд- и бэкенд-проверки. CX Codex +1 ★ 1 216звёзд репо js-request-idle-callback Правило js-request-idle-callback учит агента уводить аналитику, сохранение состояния и предзагрузку в простой браузера, чтобы интерфейс не подвисал на кликах. CX Codex +1 ★ 1 216звёзд репо pr-comment-resolver Субагент pr-comment-resolver находит неразрешённые замечания в пуллреквесте, исправляет код и готовит черновики ответов рецензентам. Помогает закрыть ревью без ручного разбора тредов. CX Codex ★ 1 216звёзд репо list-performance-item-types Правило list-performance-item-types для Claude Code задаёт типы элементов в списках с разной разметкой. Оно подключается при работе с такими списками и настраивает раздельное переиспользование компонентов. CX Codex +1 ★ 1 216звёзд репо test-audit Скилл test-audit проверяет новые и изменённые тесты, а также помогает находить дубли и низкоценные проверки. Пригодится перед добавлением тестов и при аудите тестового набора. CX Codex +1 ★ 1 216звёзд репо webmcp-gen Скилл webmcp-gen собирает рабочий процесс сайта в WebMCP-инструмент и проверяет, что он ведёт себя так же, как существующий интерфейс. CX Codex +1 ★ 1 216звёзд репо start-environment Правило start-environment для Claude Code описывает запуск локального окружения через dev docker up: ожидание готовности сервисов и определение назначенных портов. CX Codex +1 ★ 1 216звёзд репо service-architecture Правило service-architecture описывает архитектуру Docker-сервисов Polar: общую инфраструктуру и отдельный стек приложения для каждого worktree. Помогает агенту учитывать связи между контейнерами и их адреса. CX Codex +1 ★ 1 216звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой