Docker Stack Scaffold

IMPORTANT: When this command is invoked, you MUST create all the files listed below. Do NOT just describe what should be done - actually create the files.

Step 1: Detect Project Structure

First, scan the project to identify:

1. Find backend directory: Look for pyproject.toml, requirements.txt, main.py
2. Find frontend directory: Look for package.json with next/react
3. Determine project name from directory name or package.json

Use Glob and Read tools to detect the structure.

Step 2: Create Directory Structure

Create these directories at the PROJECT ROOT (not in src/):

docker/
├── env/
├── nginx/
├── monitoring/
│   ├── prometheus/
│   └── grafana/
│       └── provisioning/
│           ├── datasources/
│           └── dashboards/
│               └── dashboards/
└── scripts/

Step 3: CREATE These Files (REQUIRED)

You MUST create ALL of the following files. Read the templates from this plugin and customize them with the detected project values.

3.1 docker/docker-compose.prod.yml

Read template from: templates/compose/docker-compose.prod.yml.template

Replace placeholders:

• {{PROJECT_NAME}} → detected project name (lowercase, hyphenated)
• {{BACKEND_PATH}} → relative path from docker/ to backend (e.g., ../../src/backend)
• {{FRONTEND_PATH}} → relative path from docker/ to frontend (e.g., ../../src/frontend)

3.2 docker/nginx/nginx.conf

Read template from: templates/nginx/nginx.conf.template

Replace {{PROJECT_NAME}} with project name.

3.3 docker/nginx/Dockerfile

Read template from: templates/dockerfiles/nginx.Dockerfile

Copy as-is.

3.4 docker/env/.env.example.backend

Read template from: templates/env/.env.example.backend.template

Replace:

• {{DB_USER}} → {project_name}_user
• {{DB_NAME}} → {project_name}_db

3.5 docker/env/.env.example.database

Read template from: templates/env/.env.example.database.template

Replace:

• {{DB_USER}} → {project_name}_user
• {{DB_NAME}} → {project_name}_db

3.6 docker/env/.env.example.redis

Read template from: templates/env/.env.example.redis.template

Copy as-is.

3.7 docker/env/.env.example.frontend

Read template from: templates/env/.env.example.frontend.template

Copy as-is.

3.8 docker/env/.env.example.grafana

Read template from: templates/env/.env.example.grafana.template

Copy as-is.

3.9 docker/env/.gitignore

Create with content:

# Ignore actual env files, keep examples
.env.*
!.env.example.*

3.10 docker/monitoring/prometheus/prometheus.yml

Read template from: templates/monitoring/prometheus/prometheus.yml.template

Copy as-is.

3.11 docker/monitoring/grafana/provisioning/datasources/prometheus.yml

Read template from: templates/monitoring/grafana/provisioning/datasources/prometheus.yml.template

Copy as-is.

3.12 docker/monitoring/grafana/provisioning/dashboards/dashboard_config.yml

Read template from: templates/monitoring/grafana/provisioning/dashboards/dashboard_config.yml.template

Copy as-is.

3.13 Backend Dockerfile (if not exists)

If {backend_path}/Dockerfile doesn't exist, read template from: templates/dockerfiles/python-fastapi.Dockerfile

3.14 Frontend Dockerfile (if not exists)

If {frontend_path}/Dockerfile doesn't exist, read template from: templates/dockerfiles/nextjs.Dockerfile

3.15 docker/README.md

Create a README explaining how to use the Docker setup:

• How to copy env files
• How to build and run
• Service URLs

3.16 Root .dockerignore (if not exists)

Create at project root if not exists:

.git
.gitignore
*.md
.env*
__pycache__
*.pyc
node_modules
.next

Step 4: Output Summary

After creating all files, output:

✅ Docker configuration scaffolded successfully!

Created files:
- docker/docker-compose.prod.yml
- docker/nginx/nginx.conf
- docker/nginx/Dockerfile
- docker/env/.env.example.* (5 files)
- docker/monitoring/prometheus/prometheus.yml
- docker/monitoring/grafana/provisioning/* (2 files)
- docker/README.md

Project: {project_name}
Backend: {backend_path}
Frontend: {frontend_path}

Next steps:
1. cd docker/env && cp .env.example.backend .env.backend
2. Edit .env files with your credentials
3. cd docker && docker-compose -f docker-compose.prod.yml up -d --build

Template Locations

All templates are in this plugin at:

• templates/compose/docker-compose.prod.yml.template
• templates/nginx/nginx.conf.template
• templates/dockerfiles/*.Dockerfile
• templates/env/.env.example.*.template
• templates/monitoring/**/*.template

CRITICAL REMINDER

This command MUST:

1. Actually CREATE files (not just describe them)
2. Use the Write tool to create each file
3. Read templates from the plugin's templates/ directory
4. Replace all placeholders with detected values
5. Output a summary of created files

DO NOT just output instructions. CREATE THE FILES.