aws-appconfig

AWS AppConfig Plugin

AI-assisted application configuration and feature flags with AWS AppConfig — deployment strategies, multi-compute integration, and Powertools utilities.

Overview

This plugin provides comprehensive AWS AppConfig guidance covering the complete lifecycle — from creating applications and configuration profiles to deploying with safe rollout strategies and integrating with Lambda, ECS, EKS, EC2, AWS Batch, and on-premises environments.

Built as a Claude Code plugin, but the skill content is plain markdown and works with any AI coding tool that supports context files — Cursor (rules), Windsurf, Copilot, Amazon Q Developer, or as system prompt context for any LLM. See Using with Other Tools below.

Features

Configuration Management

• Freeform Configuration: JSON, YAML, or plain text configuration profiles with JSON Schema (draft-04) and Lambda function validators
• Configuration Sources: Hosted store, SSM Parameter Store, SSM Documents, S3, CodePipeline, Secrets Manager
• Versioning: Immutable configuration versions with deploy-any-version-anywhere semantics
• Encryption: AWS KMS customer managed key support for configuration data at rest
• Deletion Protection: Account-level protection against accidental deletion of actively-retrieved resources
• Large Configuration Management: Split profiles, S3 backend, payload optimization guidance

Feature Flags

• Native AppConfig Feature Flags: Built-in multi-variant support with agent-side evaluation via context headers
• Powertools Feature Flags: Application-level evaluation with richer condition operators (Python only)
• Targeting Rules: Context-based flag resolution with S-expression rules (native) or JSON conditions (Powertools)
• Traffic Splitting: Deterministic percentage-based A/B testing with the split operator (native) or MODULO_RANGE (Powertools)
• Percentage Rollouts: Gradual feature rollout to a subset of users
• Local Development: LOCAL_DEVELOPMENT_DIRECTORY with JSON and Amazon Ion format support

Deployment Strategies

• Predefined Strategies: Linear, canary (exponential), and all-at-once with configurable bake time
• Custom Strategies: Define growth type, growth factor, duration, and bake time
• Automatic Rollback: CloudWatch alarm integration — rollback on ALARM or INSUFFICIENT_DATA state during deployment and bake time
• Post-Deployment Revert: Revert completed deployments within 72 hours using --allow-revert
• Scheduled Deployments: EventBridge Scheduler integration for time-based configuration changes

Multi-Compute Integration

• Lambda Extension: AppConfig extension layer for low-latency cached retrieval via localhost:2772
• ECS/EKS: Sidecar container and DaemonSet patterns with health checks and prefetch support
• EC2: systemd-managed agent for RPM-based Linux, Docker container for Debian/Ubuntu
• AWS Batch: Multi-container job definitions with agent sidecar
• On-Premises / Hybrid: RPM agent, Docker container, IAM Roles Anywhere
• Step Functions: AWS SDK service integration for workflow-based configuration reads
• SDK Direct: StartConfigurationSession + GetLatestConfiguration for custom polling
• Powertools Parameters: Typed retrieval with caching for Python, TypeScript, Java, and .NET
• Browser / Mobile: Proxy pattern via Lambda function URL or API Gateway
• VPC Endpoints: Private access without NAT gateways, with SAM template
• FIPS Endpoints: FedRAMP/regulated workload support

Monitoring and Extensions

• CloudWatch Alarms: Error rate, latency, and composite alarms for deployment safety
• Rollback Notifications: EventBridge rules for alerting on deployment rollbacks
• Extensions Framework: PRE/ON/AT action points for custom validation, notifications, and third-party monitoring
• Built-in Extensions: EventBridge, SNS, SQS, and Jira deployment notifications
• CloudTrail Auditing: Full API call logging for compliance and change tracking

Installation

Prerequisites

• AWS CLI configured with credentials
• AWS SAM CLI installed (for deploying SAM templates)

Install via Marketplace

1. Add the marketplace in Claude Code:

   /plugin marketplace add gunnargrosch/gunnargrosch-plugins
   

2. Install the plugin:

   /plugin install aws-appconfig@gunnargrosch-plugins
   

What's Included

This plugin bundles:

• A skill (/aws-appconfig): Workflow guidance, best practices, troubleshooting references, and detailed guides for configuration profiles, feature flags, deployment strategies, multi-compute integration, and monitoring

Note: This plugin does not bundle an MCP server. All AppConfig operations use the AWS CLI via aws appconfig commands.

Usage

Automatic Activation