Skip to content

Configuration_Options

Jump to bottom
Rafal Lagowski edited this page Sep 12, 2025 · 1 revision

⚙️ Configuration Options

ClaudeAutoPM offers three distinct configurations to match your development workflow and team requirements.

🎯 Overview

Configuration Docker Kubernetes Use Case
🏃 Minimal ❌ ❌ Traditional development, learning, rapid prototyping
🐳 Docker-only ✅ ❌ Team consistency, environment parity
🚀 Full DevOps ✅ ✅ Production deployments, enterprise teams

🏃 Minimal Configuration

Perfect for: Simple projects, rapid prototyping, learning, individual developers

Features

  • Native tooling: Use npm, pip, local execution directly
  • Standard testing: Traditional test runners (Jest, pytest, etc.)
  • Simple deployment: FTP, traditional hosting, serverless
  • Quick setup: No Docker or Kubernetes knowledge required

Configuration

{
  "features": {
    "docker_first_development": false,
    "kubernetes_devops_testing": false,
    "github_actions_k8s": false,
    "enforce_docker_tests": false,
    "integration_tests": false
  }
}

Environment Variables

DOCKER_FIRST_DEVELOPMENT=false
KUBERNETES_DEVOPS_TESTING=false
GITHUB_ACTIONS_K8S=false
INTEGRATION_TESTS=false

Development Workflow

# Install dependencies locally
npm install
pip install -r requirements.txt

# Run development server
npm run dev
python app.py

# Run tests
npm test
pytest

CLAUDE.md Template

Uses minimal.md template with:

  • Traditional development rules
  • Native tooling instructions
  • Standard testing approaches
  • Local execution patterns

🐳 Docker-Only Configuration

Perfect for: Team consistency, environment parity, avoiding "works on my machine" issues

Features

  • Docker-first enforcement: All code runs in containers
  • Container orchestration: Docker Compose for services
  • Hot reload: Volume mounts for rapid development
  • Environment isolation: Consistent across all developer machines
  • No local pollution: Clean host system

Configuration

{
  "features": {
    "docker_first_development": true,
    "enforce_docker_tests": true,
    "auto_create_dockerfile": true,
    "block_local_execution": true,
    "kubernetes_devops_testing": false,
    "github_actions_k8s": false
  }
}

Environment Variables

DOCKER_FIRST_DEVELOPMENT=true
KUBERNETES_DEVOPS_TESTING=false
GITHUB_ACTIONS_K8S=false
INTEGRATION_TESTS=false

Development Workflow

# Start development environment
docker compose up -d

# Run commands in containers
docker compose exec app npm install
docker compose exec app npm run dev
docker compose exec app npm test

# View logs
docker compose logs -f app

# Stop environment
docker compose down

Container Architecture

  • Application container: Source code with hot reload
  • Database container: PostgreSQL, MongoDB, etc.
  • Cache container: Redis for sessions/caching
  • Network isolation: Services communicate via Docker networks

CLAUDE.md Template

Uses docker-only.md template with:

  • Docker-first enforcement rules
  • Container-based development instructions
  • No local execution allowed
  • Docker Compose orchestration patterns

🚀 Full DevOps Configuration

Perfect for: Production deployments, enterprise teams, complex microservices

Features

  • Hybrid strategy: Local Docker + CI/CD Kubernetes
  • Production parity: Test in environments similar to production
  • Kubernetes-native CI: KIND cluster testing in GitHub Actions
  • Security scanning: Trivy, vulnerability assessments
  • Helm charts: Production-ready deployments
  • Enterprise integration: Azure DevOps, advanced monitoring

Configuration

{
  "features": {
    "docker_first_development": true,
    "kubernetes_devops_testing": true,
    "github_actions_k8s": true,
    "enforce_docker_tests": true,
    "integration_tests": true,
    "auto_create_dockerfile": true,
    "sync_with_ci": true
  },
  "kubernetes": {
    "enabled": true,
    "testing": {
      "integration_tests": true,
      "helm_chart_tests": true,
      "kubectl_smoke_tests": true
    }
  }
}

Environment Variables

DOCKER_FIRST_DEVELOPMENT=true
KUBERNETES_DEVOPS_TESTING=true
GITHUB_ACTIONS_K8S=true
INTEGRATION_TESTS=true

Local Development Workflow

# Same as Docker-only for local development
docker compose up -d
docker compose exec app npm run dev

CI/CD Kubernetes Workflow

Automated via GitHub Actions:

  1. KIND cluster setup for testing
  2. Docker images built and pushed
  3. Kubernetes manifests validated
  4. Helm charts linted and tested
  5. Integration tests in Kubernetes environment
  6. Security scanning with Trivy
  7. Deployment to staging/production

Required Files

  • k8s/ - Kubernetes manifests
  • Chart.yaml - Helm chart definition
  • Dockerfile - Container build instructions
  • .dockerignore - Build context optimization

CLAUDE.md Template

Uses full-devops.md template with:

  • Hybrid strategy documentation
  • Docker-first local development
  • Kubernetes CI/CD requirements
  • Security and compliance rules
  • Production deployment patterns

🔄 Switching Configurations

Interactive Configuration Tool

autopm config

Features:

  • Visual status display of current features
  • Toggle individual features on/off
  • Load predefined templates
  • Automatic CLAUDE.md regeneration
  • Configuration validation

During Installation

autopm install

🔧 Choose your development configuration:
  1) 🏃 Minimal     - Traditional development (no Docker/K8s)
  2) 🐳 Docker-only - Docker-first development without Kubernetes  
  3) 🚀 Full DevOps - All features (Docker + Kubernetes + CI/CD)
  4) ⚙️  Custom     - Use existing config.json template

Your choice [1-4]:

Programmatic Configuration

# Load specific template
cp .claude/config-templates/docker-only.json .claude/config.json

# Regenerate CLAUDE.md
.claude/scripts/config/toggle-features.sh

🎯 Configuration Matrix

Feature Comparison

Feature Minimal Docker-only Full DevOps
Local Execution ✅ Native ❌ Docker only ❌ Docker only
Container Development ❌ ✅ ✅
Hot Reload ✅ Native ✅ Volume mounts ✅ Volume mounts
Database Local install Docker container Docker/K8s
Testing Native runners Docker containers Docker + K8s
CI/CD Basic Docker-based Kubernetes-native
Security Scanning Manual Optional Automated
Production Deployment Manual Docker Kubernetes
Team Onboarding Medium Easy Easy
Learning Curve Low Medium High

GitHub Actions Workflows

Workflow Minimal Docker-only Full DevOps
docker-tests.yml ❌ ✅ ✅
kubernetes-tests.yml ❌ ❌ ✅
npm-publish.yml ✅ ✅ ✅

💡 Choosing the Right Configuration

Start with Minimal if:

  • You're new to containers
  • Working on simple projects
  • Need fast iteration
  • Learning ClaudeAutoPM

Choose Docker-only if:

  • You have "works on my machine" issues
  • Working in a team
  • Want consistent environments
  • Ready to learn containers

Go Full DevOps if:

  • Building production applications
  • Need enterprise-grade CI/CD
  • Working with microservices
  • Have DevOps expertise

Migration Path

Minimal → Docker-only → Full DevOps

You can always upgrade your configuration as your project grows and your team's expertise increases.

🔧 Advanced Configuration

Custom Templates

Create your own configuration template:

  1. Copy existing template: cp .claude/config-templates/docker-only.json .claude/config-templates/custom.json
  2. Modify features as needed
  3. Update installer to include your template
  4. Create matching CLAUDE.md template

Environment-Specific Configs

Different configurations for different environments:

# Development
cp .claude/config-templates/docker-only.json .claude/config.dev.json

# Production
cp .claude/config-templates/full-devops.json .claude/config.prod.json

CI/CD Integration

Your configuration automatically affects:

  • Which GitHub Actions workflows run
  • What agents are recommended
  • Which rules are enforced
  • What CLAUDE.md is generated

📋 Next Steps

Clone this wiki locally