local-dev-environment

Configure Docker Compose, Dev Containers, and task runners for local development stacks.

5|1|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/roanbrasil/engineer-grade-agent-skills --skill local-dev-environment-roanbrasil
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: local-dev-environment
Source: https://github.com/roanbrasil/engineer-grade-agent-skills/tree/main/skills/local-dev-environment
Command: npx skills add https://github.com/roanbrasil/engineer-grade-agent-skills --skill local-dev-environment-roanbrasil

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the common pain point of inconsistent local development environments that cause "works on my machine" bugs, lengthy onboarding for new team members, and late discovery of integration issues that only appear in production-like settings.

Core Features & Use Cases

  • Docker Compose Configuration: Provides production-grade Docker Compose setups with health checks, named volumes, and profiles for infrastructure and application services, supporting common dependencies like PostgreSQL, Redis, and Kafka.
  • Dev Container Setup: Includes full devcontainer.json examples for uniform team environments with pre-installed tools, VS Code extensions, port forwards, and post-create commands to cache dependencies.
  • Kubernetes Local Development: Covers Tilt and Skaffold configurations for syncing code changes to local Kubernetes clusters with live updates and Helm/Kustomize integration.
  • Task Runners: Offers Makefile and Taskfile examples to codify common development commands like starting services, running tests, linting, and database migrations.
  • Environment Management: Guides use of direnv for auto-loading environment variables, dotenv libraries for application config, and secure secret retrieval from vaults like 1Password and AWS Secrets Manager.
  • Use Case: A team building a Spring Boot + Kafka event-driven application can use this Skill to spin up a full local stack with database, cache, and message broker in one command, with hot reload and debug ports pre-configured, so every developer has an identical environment from day one.

Quick Start

Use the local-dev-environment skill to set up a full local development stack with PostgreSQL, Redis, and Kafka for your new project, including Docker Compose configuration, Dev Container settings, and a Makefile with common development tasks, so you can start coding immediately after running one command.

Frequently Asked Questions about local-dev-environment

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

FAQPage Schema
How do I set up a Docker Compose environment with PostgreSQL, Redis, and Kafka for local development?

A Docker Compose environment for local development uses production-grade configurations with health checks, named volumes, and profiles to spin up infrastructure dependencies like PostgreSQL, Redis, and Kafka in a single command.

What is the best way to stop 'works on my machine' bugs in polyglot event-driven applications?

Stopping 'works on my machine' bugs in polyglot event-driven applications requires uniform team environments using Dev Containers with pre-installed tools, VS Code extensions, and post-create commands to cache dependencies identically across all machines.

How do I sync code changes to a local Kubernetes cluster for live updates?

Syncing code changes to a local Kubernetes cluster for live updates uses Tilt or Skaffold configurations with Helm and Kustomize integration, enabling automatic code synchronization and immediate application reloading during development.

Can I use a secret vault like 1Password or AWS Secrets Manager for local environment variables?

Using secret vaults like 1Password or AWS Secrets Manager for local environment variables involves integrating secure secret retrieval with direnv for auto-loading and dotenv libraries for application config to mirror production settings locally.

How do I codify common development commands like running tests and database migrations?

Codifying common development commands like running tests, linting, and database migrations uses task runners such as Makefile or Taskfile examples to standardize starting services and executing repetitive development tasks across the team.

Does setting up a local dev environment work with Spring Boot and Kafka event-driven applications?

Setting up a local dev environment works with Spring Boot and Kafka event-driven applications by providing a full local stack with database, cache, and message broker in one command, including hot reload and debug ports pre-configured for immediate coding.