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

docker-watch-mode-2025 — скилл для Claude Code: hot reload в Compose

Скилл docker-watch-mode-2025 настраивает watch в Docker Compose: правки исходников уезжают в контейнер без пересборки, а манифесты зависимостей пересобирают образ.

MIT 166 установок ★ 66 обновлён 2026-06-18

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add JosiahSiegel/claude-plugin-marketplace --skill docker-watch-mode-2025 -a claude-code
Открыть на GitHub

Что делает docker-watch-mode-2025

Скилл разбирает watch-режим Docker Compose: какому каталогу нужен sync, что отдавать в rebuild, а где хватит sync+restart. Внутри порядок действий из шести шагов, справочник по действиям и чек-лист для случаев, когда изменения не долетают до контейнера.

В примере YAML sync смотрит на ./frontend/src с ignore на node_modules/, .git/ и dist/, а для ./frontend/package.json заведено отдельное правило rebuild. Запуск — docker compose up --watch. Правила ignore скилл советует держать узкими: зависимости, артефакты сборки, кеши и секреты в синхронизацию пускать не надо.

Сначала убедитесь, что приложение поднимается обычным docker compose up — иначе добавлять правила watch нечего отлаживать. Для горячей перезагрузки внутри контейнера должен работать свой watcher: Compose только копирует файлы, подхватить их должно само приложение. Когда правила watch пересекаются с зависимостями сервисов, профилями или томами, скилл предлагает ставить рядом compose-patterns-2025.

Какие задачи решает

  • перевести фронтенд на hot reload без bind mount всего проекта
  • отделить синхронизацию исходников от пересборки при смене зависимостей
  • исключить node_modules и артефакты сборки из наблюдаемых путей
  • найти причину, по которой правка файла не доходит до контейнера
  • выбрать между sync+restart и обычным sync для конфигов

Примеры запросов агенту

  • Настрой watch для сервиса frontend: sync на ./frontend/src, rebuild на package.json.
  • Правка в src/App.tsx не долетает до контейнера — пройдись по чек-листу из скилла.
  • Добавь ignore для node_modules/, .git/ и dist/ в правило синхронизации.

Как установить docker-watch-mode-2025

1Через Skills CLI (Vercel)

npx skills add JosiahSiegel/claude-plugin-marketplace --skill docker-watch-mode-2025 -a claude-code

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

~/.claude/skills/docker-watch-mode-2025/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/docker-watch-mode-2025/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о docker-watch-mode-2025

Как установить docker-watch-mode-2025 в Claude Code?

Выполните npx skills add JosiahSiegel/claude-plugin-marketplace --skill docker-watch-mode-2025 -a claude-code. Файл скилла появится по пути ~/.claude/skills/docker-watch-mode-2025/SKILL.md.

Что делает docker-watch-mode-2025?

Описывает три действия watch в Compose: sync для фреймворков с собственной перезагрузкой, rebuild для скомпилированных языков и изменений зависимостей, sync+restart для конфигов, которые читаются только при старте процесса.

Нужен ли nodemon, если есть Compose watch?

Да, если приложение само не следит за файлами. Watch только доставляет изменённые файлы в контейнер, перезапуск внутри делает уже сам рантайм, поэтому без своего watcher горячая перезагрузка не сработает.

Исходный текст

SKILL.md · MIT
---
name: docker-watch-mode-2025
description: |
  Docker Compose Watch mode for hot reload during local development (2025 GA).
  PROACTIVELY activate for: (1) docker compose watch setup, (2) watch action types (sync, rebuild, sync+restart, sync+exec), (3) configuring path filters and ignore patterns, (4) hot-reload for Node/Python/Go/Rust apps in Compose, (5) sync-only vs rebuild trade-offs, (6) using watch with profiles, (7) debugging watch mode (verbose logs), (8) integrating watch with bind mounts, (9) Compose watch vs nodemon/air/cargo-watch.
  Provides: watch action reference, per-language hot-reload examples, path filter patterns, and troubleshooting steps.
---

# Docker Compose Watch Mode (2025 GA)

Docker Compose Watch enables automatic hot reload during local development by synchronizing file changes instantly without manual container restarts.

## Three Watch Actions

### 1. sync - Hot Reload
For frameworks with hot reload (React, Next.js, Node.js, Flask).
Copies changed files directly into running container.

### 2. rebuild - Compilation
For compiled languages (Go, Rust, Java) or dependency changes.
Rebuilds image and recreates container when files change.

### 3. sync+restart - Config Changes
For configuration files requiring restart.
Syncs files and restarts container.

## Core Procedure

1. Confirm the app already starts with `docker compose up` before adding watch rules.
2. Prefer `sync` for source directories when the runtime already reloads files.
3. Use `rebuild` for dependency manifests, Dockerfiles, compiled artifacts, or base-image changes.
4. Use `sync+restart` for configuration files that are read only at process startup.
5. Add narrow `ignore` rules for dependency folders, build outputs, VCS folders, caches, secrets, and generated files.
6. Run `docker compose up --watch` and verify both fast source edits and dependency changes.

## Usage

```yaml
services:
  frontend:
    build: ./frontend
    develop:
      watch:
        - action: sync
          path: ./frontend/src
          target: /app/src
          ignore: [node_modules/, .git/, dist/]
        - action: rebuild
          path: ./frontend/package.json
```

Start with: `docker compose up --watch`.

## Troubleshooting Checklist

- Change not detected: verify the watched path is relative to the Compose file and not excluded by `ignore`.
- Hot reload not firing: confirm the application inside the container has its own watcher enabled.
- Container restarts too often: split source `sync` from manifest `rebuild` rules.
- File ownership issues: prefer named volumes for dependency directories and sync only application code.
- Slow sync: narrow watched paths and exclude build outputs or large generated folders.

## References

Use `docker compose watch --help` and Docker's Compose Watch documentation for the current action set and CLI flags. Pair this skill with `compose-patterns-2025` when watch rules interact with service dependencies, profiles, networks, or volumes.

## Benefits
- Better performance than broad bind mounts
- Fewer host/container file permission issues
- Intelligent syncing with rebuild capability
- Works across supported Docker Desktop and Compose platforms

© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
docker-patterns affaan-m Скилл docker-patterns с проверенными шаблонами Dockerfile и Docker Compose: локальная разработка, сети, тома, безопасность контейнеров. CX Codex +1 8 600установок docker-compose-orchestration manutej Скилл docker-compose-orchestration помогает описывать многоконтейнерные приложения в Docker Compose: сервисы, сети, тома, healthcheck и порядок запуска. CX Codex +1 3 000установок docker-compose-patterns docker Скилл docker-compose-patterns для Claude Code задаёт правила сборки, отладки и связывания сервисов в compose.yaml. Настраивает проверки готовности, тома и оверрайды для локальной разработки. CX Codex +1 2 900установок docker-project-foundations docker Скилл docker-project-foundations настраивает первичное окружение Docker для нового проекта. Он сразу создаёт базовую тройку файлов: .dockerignore, Dockerfile и compose.yaml. CX Codex +1 1 700установок docker Mindrally Задаёт правила сборки легковесных контейнеров, многоэтапных Dockerfile и конфигураций Docker Compose. CX Codex +1 1 200установок docker-containerization aj-geddes Скилл docker-containerization для Claude Code: multi-stage сборки, минимальный образ, безопасная конфигурация. Превращает приложение в Docker-образ и приводит в порядок существующие Dockerfile. CX Codex +1 683установок

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

Весь набор →
adf-validation-rules Скилл adf-validation-rules проверяет ограничения Azure Data Factory: вложенность активностей, лимиты пайплайнов и типовые ошибки валидации. Пригодится при сборке и отладке ADF. CX Codex +1 168установок azure-openai-2025 Скилл azure-openai-2025 собирает справочник по моделям Azure OpenAI 2025 года, деплою через az, SKU и квотам, а также Python SDK. Помогает при переносе работы с моделями в Azure. CX Codex +1 167установок github-actions-2025 Скилл github-actions-2025 помогает настроить пайплайны с новыми возможностями GitHub Actions: раннерами на 1 vCPU, неизменяемыми релизами и переходом на Node24. CX Codex +1 166установок defender-for-devops Скилл defender-for-devops для Claude Code помогает добавить проверки безопасности в Azure Pipelines. Активируется при настройке MSDO, сканировании кода, зависимостей, контейнеров и IaC. CX Codex +1 166установок windows-git-bash-compatibility Скилл windows-git-bash-compatibility устраняет сбои путей и переменных окружения при сборке проектов Azure Data Factory в эмуляторе Git Bash на Windows. CX Codex +1 165установок windows-git-bash-testing Скилл windows-git-bash-testing разбирает падения тестов Vitest, Playwright и MSW, которые случаются только на Windows и в Git Bash: пути, снимки, браузеры. CX Codex +1 164установок git-2025-features Скилл git-2025-features для Claude Code и других платформ описывает возможности Git 2.48–2.49 и современные рабочие процессы. Агент использует его при работе с reftables, sparse-checkout, partial clone и worktrees. CX Codex +1 164установок adf-master Скилл adf-master помогает настроить CI/CD для Azure Data Factory, написать скрипты PrePostDeploymentScript и подготовить шаблоны ARM для развёртывания. CX Codex +1 164установок

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

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