generating-compose

Generate docker-compose.yml

Generate docker-compose.yml for local development by detecting required services from project dependencies.

Philosophy

• Service detection - Scan dependencies for service hints
• Health checks - Reliable startup ordering
• Volume persistence - Data survives container restarts
• Development-first - Mount source code, enable debugging

Workflow

1. Check for Existing Dockerfile

Glob: Dockerfile, Dockerfile.*

If no Dockerfile found, suggest running dockercraft:dockerfile first.

2. Detect Project Type

Glob: pyproject.toml, package.json, go.mod, Cargo.toml, pom.xml

3. Detect Services from Dependencies

Scan dependency files for service hints:

Dependency Pattern	Suggested Service	Reference File
postgres, asyncpg, psycopg, pg, prisma (postgres)	postgres	references/postgres.md
redis, ioredis, bull, aioredis	redis	references/redis.md
elasticsearch, @elastic/elasticsearch	elasticsearch	references/elasticsearch.md
mongo, mongoose, pymongo, motor	mongodb	references/mongodb.md
rabbitmq, amqp, amqplib, pika, celery, kombu	rabbitmq	references/rabbitmq.md
kafka, kafkajs, confluent-kafka, aiokafka	kafka	references/kafka.md
mysql, mysql2, mysqlclient	mysql	references/mysql.md
aws, boto, boto3, aiobotocore, s3, sqs, @aws-sdk	localstack	references/localstack.md
minio	minio	references/minio.md

4. Ask User to Confirm Services

Present multi-select via AskUserQuestion with detected services pre-selected:

Detected services from dependencies:

☑ postgres (asyncpg found)
☑ redis (redis found)
☐ elasticsearch
☐ mongodb
☐ localstack (AWS)
☐ rabbitmq
☐ kafka
☐ minio

Select services for docker-compose.yml:

5. Load Service References

Read ONLY the reference files for user-confirmed services. Each reference file contains:

• Service definition (image, ports, volumes, healthcheck)
• App environment variables

6. Ask About App Configuration

Via AskUserQuestion:

App configuration:

Port: [8000]
Environment: [local]
Mount source code? [Yes/No]

7. Generate docker-compose.yml

Read references/compose-skeleton.yaml.template for the app skeleton. Customize:

• Set {app_port} from user's answer in step 6
• Insert service env vars from loaded reference files
• Insert service definitions from loaded reference files
• Insert volume definitions for each service
• Use condition: service_healthy in all depends_on entries for proper startup ordering

9. Report

Created docker-compose.yml:

App configuration:
  - Port: {port}
  - Source mounted: {yes/no}

Services ({count}):
  {service_list_with_ports}

Environment variables added:
  {env_vars}

Commands:
  docker compose up -d          # Start all services
  docker compose logs -f app    # View app logs
  docker compose ps             # List containers
  docker compose down           # Stop all services
  docker compose down -v        # Stop and remove volumes

Service References

Each service definition is in references/{service}.md (see detection table in step 3 for mapping).