SKILL.md

name: docker description: Load when editing Dockerfile, docker-compose*.yml, or managing containers. Provides container management patterns for development and production environments.

Docker

Merged Skills

container-management: Start, stop, rebuild, logs
compose-files: Multi-container orchestration, environment separation

⚠️ Critical Gotchas

Category	Pattern	Solution
Stale code	`restart` keeps old code	Use `up -d --build` instead
Cache issues	Changes not appearing	Add `--force-recreate` flag
Wrong compose	Using prod for dev	Always use `docker-compose.dev.yml` for local
Network sockets	Broadcast not working	Add `SO_BROADCAST` socket option
Volume mounts	Source changes not reflecting	Check volume paths in compose file
Port conflicts	Container won't start	Check ports 3000, 8000, 5432 not in use

Rules

Rule	Pattern
Dev compose	Always use `docker-compose.dev.yml` for local development
Rebuild after code	`up -d --build` not `restart`
Force recreate	Add `--force-recreate` when cache issues
Check logs first	`docker compose logs -f {service}` before debugging
Clean rebuilds	`--no-cache` for dependency changes

Avoid

❌ Bad	✅ Good
`docker compose restart`	`docker compose up -d --build`
Production compose for dev	`docker-compose.dev.yml`
Debugging without logs	`docker compose logs -f backend`
Ignoring exit codes	Check `docker compose ps` for health

Patterns

# Pattern 1: Development startup (DEFAULT)
docker compose -f docker/docker-compose.dev.yml up -d

# Pattern 2: Rebuild single service
docker compose -f docker/docker-compose.dev.yml up -d --build backend

# Pattern 3: Force full recreate (cache issues)
docker compose up -d --build --force-recreate backend

# Pattern 4: Clean rebuild (dependency changes)
docker compose build --no-cache backend
docker compose up -d

# Pattern 5: Debug container
docker compose logs -f backend --tail 100
docker exec -it nop-backend bash

Environment Detection

Situation	Compose File
Local development	`docker/docker-compose.dev.yml`
Production deploy	`docker-compose.yml`
Testing	`docker/docker-compose.test.yml`
Debugging	`docker/docker-compose.debug.yml`

Commands

Task	Command
Start dev	`docker compose -f docker/docker-compose.dev.yml up -d`
Rebuild service	`docker compose up -d --build backend`
View logs	`docker compose logs -f backend`
Enter container	`docker exec -it nop-backend bash`
Stop all	`docker compose down`
Full reset	`docker compose down && docker compose up -d --build`
Check status	`docker compose ps`

スコア

総合スコア

50/100

リポジトリの品質指標に基づく評価

✓SKILL.md

SKILL.mdファイルが含まれている

+20

○LICENSE

ライセンスが設定されている

0/10

○説明文

100文字以上の説明がある

0/10

○人気

GitHub Stars 100以上

0/15

○最近の活動

3ヶ月以内に更新がある

0/10

○フォーク

10回以上フォークされている

0/5

✓Issue管理

オープンIssueが50未満

+5

✓言語

プログラミング言語が設定されている

+5

○タグ

1つ以上のタグが設定されている

0/5

レビュー

💬

レビュー機能は近日公開予定です