environment-config-manager

license	Apache-2.0
name	environment-config-manager
description	Environment configuration manager for 12-factor config, feature flags, and multi-environment management. Activate on: environment variables, ConfigMap, feature flags, 12-factor config, dotenv management, config per environment, runtime config. NOT for: secret storage (use secret-management-expert), IaC provisioning (use terraform-module-builder), CI/CD variables (use github-actions-pipeline-builder).
allowed-tools	Read,Write,Edit,Bash(docker:*,kubectl:*,terraform:*,npm:*,npx:*)
category	DevOps & Infrastructure
tags	["configuration","twelve-factor","feature-flags","devops"]
pairs-with	[{"skill":"devops-automator","reason":"Config management is a core piece of deployment automation"},{"skill":"secret-management-expert","reason":"Secrets are a special class of configuration requiring separate handling"}]

Environment Config Manager

Expert in 12-factor configuration management, feature flags, and environment-specific config across dev, staging, and production.

Activation Triggers

Activate on: "environment variables", "ConfigMap", "feature flags", "12-factor config", "dotenv setup", "config per environment", "runtime configuration", "config validation", "environment parity"

NOT for: Secret storage → secret-management-expert | IaC provisioning → terraform-module-builder | CI/CD variables → github-actions-pipeline-builder

Quick Start

1. Separate config from code — no hardcoded URLs, ports, or feature toggles in source
2. Define config schema — typed validation with defaults (zod, envalid, convict)
3. Layer environments — base config overridden by environment-specific values
4. Implement feature flags — runtime toggleable features without deployment
5. Validate on startup — fail fast if required config is missing or invalid

Core Capabilities

Domain	Technologies
Validation	zod, envalid, @t3-oss/env-nextjs, convict, joi
Feature Flags	LaunchDarkly, Unleash, Flagsmith, Statsig, simple JSON flags
K8s Config	ConfigMap, ExternalSecret, Kustomize overlays
Local Dev	dotenv, direnv, 1Password CLI (op run), docker-compose env
Runtime Config	etcd, Consul KV, AWS AppConfig, Firebase Remote Config

Architecture Patterns

Typed Config Validation (TypeScript)

// config/env.ts — fail fast on invalid config
import { z } from 'zod';

const envSchema = z.object({
  NODE_ENV: z.enum(['development', 'staging', ]),
  : z..().(),
  : z.().(),
  : z.().().(),
  : z.([, , , ]).(),
  : z..().(),
  : z..().(),
});

   = z.< envSchema>;


  env = envSchema.(process.);