aws-architecture-gotchas

Identify and mitigate common AWS infrastructure mistakes across services.

29|2|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/jbdamask/john-claude-skills --skill aws-architecture-gotchas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aws-architecture-gotchas
Source: https://github.com/jbdamask/john-claude-skills/tree/main/skills/aws-architecture-gotchas
Command: npx skills add https://github.com/jbdamask/john-claude-skills --skill aws-architecture-gotchas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps prevent common mistakes and pitfalls when designing, creating, or modifying AWS infrastructure, saving time and reducing deployment issues.

Core Features & Use Cases

  • Proactive Error Catching: Identifies and warns about known AWS infrastructure mistakes before they are implemented.
  • Best Practice Guidance: Provides lessons learned from real-world AWS deployments.
  • Use Case: Before deploying a new CloudFormation stack for a web application, use this skill to review the template against common gotchas related to IAM roles, S3 bucket policies, and API Gateway configurations.

Quick Start

Fetch the latest AWS learnings document and review sections relevant to the services you are using.

Frequently Asked Questions about aws-architecture-gotchas

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

FAQPage Schema
How do I avoid common AWS infrastructure mistakes during deployment?

To avoid AWS infrastructure mistakes, you should proactively review your components against known deployment pitfalls. Fetching a centralized learnings document provides guidance on hard-won lessons to prevent common errors across services like CloudFormation, Lambda, and S3 before implementation.

What are common CloudFormation deployment gotchas for API Gateway and IAM?

Common CloudFormation gotchas involve misconfigurations in IAM roles, S3 bucket policies, and API Gateway settings. Reviewing your infrastructure templates against a centralized learnings document helps identify and mitigate these specific deployment pitfalls before you execute stack modifications.

Can I check my AWS infrastructure for best practices before modifying EC2 and S3 components?

Yes, you can check AWS infrastructure for best practices by applying real-world deployment lessons to your creation or modification workflow. Fetching and reviewing a centralized learnings document proactively warns about known pitfalls across EC2, S3, and other services.

What is the best way to proactively catch AWS deployment errors in Lambda and API Gateway?

The best way to catch AWS deployment errors is to review your Lambda and API Gateway configurations against a centralized learnings document. This approach applies hard-won deployment lessons to proactively identify and mitigate known infrastructure pitfalls.

When do I need to review AWS infrastructure for known pitfalls?

You need to review AWS infrastructure for known pitfalls whenever you are designing, creating, or modifying components. Fetching a centralized learnings document before deploying helps mitigate common mistakes across services like CloudFormation, IAM, and EC2.