Aws Architecture Gotchas

Overview

This skill provides hard-won lessons from real AWS deployments covering API Gateway, Lambda, IAM, S3, CloudFront, CloudFormation, Secrets Management, EC2, and more. Use it to avoid common pitfalls when architecting or modifying AWS infrastructure.

Instructions

Before creating or modifying AWS infrastructure (CloudFormation, CDK, SAM, Terraform, or manual configuration), fetch and review the latest learnings document:

URL: https://raw.githubusercontent.com/jbdamask/scratch/refs/heads/main/AGENT_FILES/aws/AWS_LEARNINGS.md

Use WebFetch or curl to retrieve the document contents. Then:

1. Identify which AWS services are involved in the current task
2. Review the relevant sections of the learnings document for those services
3. Apply the lessons proactively — check the current code/templates against known gotchas before making changes