Часть экосистемы Forge DevKit
◇ forge-worktree
Параллельные ветки, ноль конфликтов портов
Проблема
Feature-ветки конфликтуют на localhost
Две ветки, один порт 3000. Убиваете один сервер, чтобы запустить другой. Контекст потерян.
Docker-контейнеры борются за порты
Backend на 5432, Redis на 6379 - но второй worktree хочет те же порты.
Ручная настройка worktree чревата ошибками
Копировать .env, перемаппить порты, поправить Docker Compose, не забыть почистить. Каждый раз.
Как это работает
Установка
Одна команда добавляет forge-worktree в ваше окружение.
Аудит
Определяет тип проекта: Docker backend, frontend или generic. Сканирует порты, env-файлы, compose-конфиги.
Генерация
Создаёт скилл управления worktree с офсетами портов, ремаппингом env и скриптами очистки.
Использование
Создавайте worktree одной командой. Каждый получает изолированные порты, свой Docker-стек, безопасную очистку.
Ключевые возможности
◇3 шаблона проектов
Docker backend, Frontend, Non-Docker (Node, Python, Go). Каждый с изоляцией портов и обработкой env под тип проекта.
◇Ноль конфликтов портов
Автоматический офсет портов по worktree. Main на 3000, worktree-1 на 3100, worktree-2 на 3200.
◇Изоляция Docker
Каждый worktree получает своё имя Docker Compose проекта, тома и пространство сетей.
◇Безопасная очистка
Одна команда останавливает контейнеры, удаляет тома и чистит worktree. Никаких orphaned-ресурсов.
◇Авто-очистка при merge
Когда ветка смерджена, worktree и его ресурсы очищаются автоматически. Никаких осиротевших Docker-ресурсов на вашей машине.
Для кого это
Docker Backend Dev
Каждый worktree получает изолированные порты и свой Docker-стек - без конфликтов.
Команда с параллельными PR
Запускайте несколько feature-веток одновременно без убийства серверов.
CI/CD-инженер
Автоматический lifecycle worktree с безопасной очисткой - без orphaned-ресурсов.
forge-worktree vs Ручные git worktree
| Критерий | Ручные git worktree | Forge DevKit |
|---|---|---|
| Управление портами | Ручной ремаппинг портов для каждой ветки | Автоматический офсет (3000 -> 3100 -> 3200) |
| Работа с Docker | Общие контейнеры, ручные compose-переопределения | Изолированные имена проектов, тома, сети |
| Очистка | Вручную: стоп контейнеров, удаление worktree, надежда что ничего не осталось | Одна команда: контейнеры, тома, worktree - всё чисто |
| Время настройки | 15-30 мин на worktree (копировать env, ремаппить, тестить) | Одна команда, автонастройка |