mono-repo-docker-compose-setup

Generate Docker Compose files for fullstack monorepos and verify HTTP 200 responses.

77|15|Updated May 12, 2026
One-click install
npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill mono-repo-docker-compose-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mono-repo-docker-compose-setup
Source: https://github.com/Waterball-Software-Academy/aixbdd/tree/main/.agents/skills/mono-repo-docker-compose-setup
Command: npx skills add https://github.com/Waterball-Software-Academy/aixbdd --skill mono-repo-docker-compose-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill eliminates the guesswork of turning a frontend+backend monorepo into a working local Docker Compose setup, including matching Dockerfiles, port/health checks, and a verified smoke test.

Core Features & Use Cases

  • Monorepo detection + stack inference: Detects frontend/ and backend/ and classifies backend/frontend stack plus likely DB kind and health endpoints.
  • Opinionated artifact generation: Generates a root docker-compose.yml, two service-specific Dockerfiles, and .dockerignore files tailored to the detected stacks.
  • Parallel smoke verification with bounded iteration: Spawns backend and frontend subagents to build/up and curl until HTTP 200 (or a strict fail-stop after the iteration budget), with guidance on what to check next.

Quick Start

Ask your AI agent to run the mono-repo-docker-compose-setup skill to generate fullstack Docker Compose files and verify both frontend and backend return HTTP 200.

Frequently Asked Questions about mono-repo-docker-compose-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Docker Compose for a fullstack monorepo with separate frontend and backend directories?

To set up Docker Compose for a fullstack monorepo, you need a root compose file alongside service-specific Dockerfiles. This process automates generation by detecting your frontend and backend stacks, then producing tailored artifacts with correct port mappings and health checks.

How does Docker Compose health check verification work for local development containers?

Docker Compose health check verification works by spawning parallel subagents to build, up, and repeatedly curl the backend and frontend services. The smoke test passes when repeated HTTP 200 checks succeed, or stops after a strict iteration budget is exceeded.

Can I automatically generate Dockerfiles for my existing frontend and backend stack?

Yes, you can automatically generate Dockerfiles for your existing frontend and backend stack. The Skill infers your stack from repository signals and creates opinionated Dockerfiles and .dockerignore files tailored to the detected technologies.

What happens to my existing Docker artifacts when generating a new docker-compose.yml?

When generating a new docker-compose.yml, existing Docker artifacts are protected by guarded overwrite and skip behavior. This prevents accidental data loss by preserving your current configurations unless explicitly intended otherwise.

Why does my Docker Compose smoke test fail when the backend health endpoint is unreachable?

Your Docker Compose smoke test fails when the backend health endpoint is unreachable because the verification process requires successful HTTP 200 responses. The Skill provides guidance on what to check next after the bounded iteration fails to reach the endpoint.