
aws-solution-architect
Expert AWS solution architecture for startups focusing on serverless, scalable, and cost-effective cloud infrastructure with modern DevOps practices and infrastructure-as-code
- Installs
- 91
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/alirezarezvani/claude-code-skill-factory --skill aws-solution-architect- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads aws-solution-architect automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
AWS Solution Architect for Startups
This skill provides comprehensive AWS architecture design expertise for startup companies, emphasizing serverless technologies, scalability, cost optimization, and modern cloud-native patterns.
Capabilities
- Serverless Architecture Design: Lambda, API Gateway, DynamoDB, EventBridge, Step Functions, AppSync
- Infrastructure as Code: CloudFormation, CDK (Cloud Development Kit), Terraform templates
- Scalable Application Architecture: Auto-scaling, load balancing, multi-region deployment
- Data & Storage Solutions: S3, RDS Aurora Serverless, DynamoDB, ElastiCache, Neptune
- Event-Driven Architecture: EventBridge, SNS, SQS, Kinesis, Lambda triggers
- API Design: API Gateway (REST & WebSocket), AppSync (GraphQL), rate limiting, authentication
- Authentication & Authorization: Cognito, IAM, fine-grained access control, federated identity
- CI/CD Pipelines: CodePipeline, CodeBuild, CodeDeploy, GitHub Actions integration
- Monitoring & Observability: CloudWatch, X-Ray, CloudTrail, alarms, dashboards
- Cost Optimization: Reserved instances, Savings Plans, right-sizing, budget alerts
- Security Best Practices: VPC design, security groups, WAF, Secrets Manager, encryption
- Microservices Patterns: Service mesh, API composition, saga patterns, CQRS
- Container Orchestration: ECS Fargate, EKS (Kubernetes), App Runner
- Content Delivery: CloudFront, edge locations, origin shield, caching strategies
- Database Migration: DMS, schema conversion, zero-downtime migrations
Input Requirements
Architecture design requires:
- Application type: Web app, mobile backend, data pipeline, microservices, SaaS platform
- Traffic expectations: Users/day, requests/second, geographic distribution
- Data requirements: Storage needs, database type, backup/retention policies
- Budget constraints: Monthly spend limits, cost optimization priorities
- Team size & expertise: Developer count, AWS experience level, DevOps maturity
- Compliance needs: GDPR, HIPAA, SOC 2, PCI-DSS, data residency
- Availability requirements: SLA targets, uptime goals, disaster recovery RPO/RTO
Formats accepted:
- Text description of application requirements
- JSON with structured architecture specifications
- Existing architecture diagrams or documentation
- Current AWS resource inventory (for optimization)
Output Formats
Results include:
- Architecture diagrams: Visual representations using draw.io or Lucidchart format
- CloudFormation/CDK templates: Infrastructure as Code (IaC) ready to deploy
- Terraform configurations: Multi-cloud compatible infrastructure definitions
- Cost estimates: Detailed monthly cost breakdown with optimization suggestions
- Security assessment: Best practices checklist, compliance validation
- Deployment guides: Step-by-step implementation instructions
- Runbooks: Operational procedures, troubleshooting guides, disaster recovery plans
- Migration strategies: Phased migration plans, rollback procedures
How to Use
"Design a serverless API backend for a mobile app with 100k users using Lambda and DynamoDB" "Create a cost-optimized architecture for a SaaS platform with multi-tenancy" "Generate CloudFormation template for a three-tier web application with auto-scaling" "Design event-driven microservices architecture using EventBridge and Step Functions" "Optimize my current AWS setup to reduce costs by 30%"
Scripts
architecture_designer.py: Generates architecture patterns and service recommendationsserverless_stack.py: Creates serverless application stacks (Lambda, API Gateway, DynamoDB)cost_optimizer.py: Analyzes AWS costs and provides optimization recommendationsiac_generator.py: Generates CloudFormation, CDK, or Terraform templatessecurity_auditor.py: AWS security best practices validation and compliance checks
Architecture Patterns
1. Serverless Web Application
Use Case: SaaS platforms, mobile backends, low-traffic websites
Stack:
- Frontend: S3 + CloudFront (static hosting)
- API: API Gateway + Lambda
- Database: DynamoDB or Aurora Serverless
- Auth: Cognito
- CI/CD: Amplify or CodePipeline
Benefits: Zero server management, pay-per-use, auto-scaling, low operational overhead
Cost: $50-500/month for small to medium traffic
2. Event-Driven Microservices
Use Case: Complex business workflows, asynchronous processing, decoupled systems
Stack:
- Events: EventBridge (event bus)
- Processing: Lambda functions or ECS Fargate
- Queue: SQS (dead letter queues for failures)
- State Management: Step Functions
- Storage: DynamoDB, S3
Benefits: Loose coupling, independent scaling, failure isolation, easy testing
Cost: $100-1000/month depending on event volume
3. Modern Three-Tier Application
Use Case: Traditional web apps with dynamic content, e-commerce, CMS
Stack:
- Load Balancer: ALB (Application Load Balancer)
- Compute: ECS Fargate or EC2 Auto Scaling
- Database: RDS Aurora (MySQL/PostgreSQL)
- Cache: ElastiCache (Redis)
- CDN: CloudFront
- Storage: S3
Benefits: Proven pattern, easy to understand, flexible scaling
Cost: $300-2000/month depending on traffic and instance sizes
4. Real-Time Data Processing
Use Case: Analytics, IoT data ingestion, log processing, streaming
Stack:
- Ingestion: Kinesis Data Streams or Firehose
- Processing: Lambda or Kinesis Analytics
- Storage: S3 (data lake) + Athena (queries)
- Visualization: QuickSight
- Alerting: CloudWatch + SNS
Benefits: Handle millions of events, real-time insights, cost-effective storage
Cost: $200-1500/month depending on data volume
5. GraphQL API Backend
Use Case: Mobile apps, single-page applications, flexible data queries
Stack:
- API: AppSync (managed GraphQL)
- Resolvers: Lambda or direct DynamoDB integration
- Database: DynamoDB
- Real-time: AppSync subscriptions (WebSocket)
- Auth: Cognito or API keys
Benefits: Single endpoint, reduce over/under-fetching, real-time subscriptions
Cost: $50-400/month for moderate usage
6. Multi-Region High Availability
Use Case: Global applications, disaster recovery, compliance requirements
Stack:
- DNS: Route 53 (geolocation routing)
- CDN: CloudFront with multiple origins
- Compute: Multi-region Lambda or ECS
- Database: DynamoDB Global Tables or Aurora Global Database
- Replication: S3 cross-region replication
Benefits: Low latency globally, disaster recovery, data sovereignty
Cost: 1.5-2x single region costs
Best Practices
Serverless Design Principles
- Stateless functions - Store state in DynamoDB, S3, or ElastiCache
- Idempotency - Handle retries gracefully, use unique request IDs
- Cold start optimization - Use provisioned concurrency for critical paths, optimize package size
- Timeout management - Set appropriate timeouts, use Step Functions for long processes
- Error handling - Implement retry logic, dead letter queues, exponential backoff
Cost Optimization
- Right-sizing - Start small, monitor metrics, scale based on actual usage
- Reserved capacity - Use Savings Plans or Reserved Instances for predictable workloads
- S3 lifecycle policies - Transition to cheaper storage tiers (IA, Glacier)
- Lambda memory optimization - Test different memory settings for cost/performance balance
- CloudWatch log retention - Set appropriate retention periods (7-30 days for most)
- NAT Gateway alternatives - Use VPC endpoints, consider single NAT in dev environments
Security Hardening
- Principle of least privilege - IAM roles with minimal permissions
- Encryption everywhere - At rest (KMS) and in transit (TLS/SSL)
- Network isolation - Private subnets, security groups, NACLs
- Secrets management - Use Secrets Manager or Parameter Store, never hardcode
- API protection - WAF rules, rate limiting, API keys, OAuth2
- Audit logging - CloudTrail for API calls, VPC Flow Logs for network traffic
Scalability Design
- Horizontal over vertical - Scale out with more small instances vs. larger instances
- Database sharding - Partition data by tenant, geography, or time
- Read replicas - Offload read traffic from primary database
- Caching layers - CloudFront (edge), ElastiCache (application), DAX (DynamoDB)
- Async processing - Use queues (SQS) for non-critical operations
- Auto-scaling policies - Target tracking (CPU, requests) vs. step scaling
DevOps & Reliability
- Infrastructure as Code - Version control, peer review, automated testing
- Blue/Green deployments - Zero-downtime releases, instant rollback
- Canary releases - Test new versions with small traffic percentage
- Health checks - Application-level health endpoints, graceful degradation
- Chaos engineering - Test failure scenarios, validate recovery procedures
- Monitoring & alerting - Set up CloudWatch alarms for critical metrics
Service Selection Guide
Compute
- Lambda: Event-driven, short-duration tasks (<15 min), variable traffic
- Fargate: Containerized apps, long-running processes, predictable traffic
- EC2: Custom configurations, GPU/FPGA needs, Windows apps
- App Runner: Simple container deployment from source code
Database
- DynamoDB: Key-value, document store, serverless, single-digit ms latency
- Aurora Serverless: Relational DB, variable workloads, auto-scaling
- Aurora Standard: High-performance relational, predictable traffic
- RDS: Traditional databases (MySQL, PostgreSQL, MariaDB, SQL Server)
- DocumentDB: MongoDB-compatible, document store
- Neptune: Graph database for connected data
- Timestream: Time-series data, IoT metrics
Storage
- S3 Standard: Frequent access, low latency
- S3 Intelligent-Tiering: Automatic cost optimization
- S3 IA (Infrequent Access): Backups, archives (30-day minimum)
- S3 Glacier: Long-term archives, compliance
- EFS: Network file system, shared storage across instances
- EBS: Block storage for EC2, high IOPS
Messaging & Events
- EventBridge: Event bus, loosely coupled microservices
- SNS: Pub/sub, fan-out notifications
- SQS: Message queuing, decoupling, buffering
- Kinesis: Real-time streaming data, analytics
- MQ: Managed message brokers (RabbitMQ, ActiveMQ)
API & Integration
- API Gateway: REST APIs, WebSocket, throttling, caching
- AppSync: GraphQL APIs, real-time subscriptions
- AppFlow: SaaS integration (Salesforce, Slack, etc.)
- Step Functions: Workflow orchestration, state machines
Startup-Specific Considerations
MVP (Minimum Viable Product) Architecture
Goal: Launch fast, minimal infrastructure
Recommended:
- Amplify (full-stack deployment)
- Lambda + API Gateway + DynamoDB
- Cognito for auth
- CloudFront + S3 for frontend
Cost: $20-100/month Setup time: 1-3 days
Growth Stage (Scaling to 10k-100k users)
Goal: Handle growth, maintain cost efficiency
Add:
- ElastiCache for caching
- Aurora Serverless for complex queries
- CloudWatch dashboards and alarms
- CI/CD pipeline (CodePipeline)
- Multi-AZ deployment
Cost: $500-2000/month Migration time: 1-2 weeks
Scale-Up (100k+ users, Series A+)
Goal: Reliability, observability, global reach
Add:
- Multi-region deployment
- DynamoDB Global Tables
- Advanced monitoring (X-Ray, third-party APM)
- WAF and Shield for DDoS protection
- Dedicated support plan
- Reserved instances/Savings Plans
Cost: $3000-10000/month Migration time: 1-3 months
Common Pitfalls to Avoid
Technical Debt
- Over-engineering early - Don't build for 10M users when you have 100
- Under-monitoring - Set up basic monitoring from day one
- Ignoring costs - Enable Cost Explorer and billing alerts immediately
- Single region dependency - Plan for multi-region from start
Security Mistakes
- Public S3 buckets - Use bucket policies, block public access
- Overly permissive IAM - Avoid "*" permissions, use specific resources
- Hardcoded credentials - Use IAM roles, Secrets Manager
- Unencrypted data - Enable encryption by default
Performance Issues
- No caching - Add CloudFront, ElastiCache early
- Inefficient queries - Use indexes, avoid scans in DynamoDB
- Large Lambda packages - Use layers, minimize dependencies
- N+1 queries - Implement DataLoader pattern, batch operations
Cost Surprises
- Undeleted resources - Tag everything, review regularly
- Data transfer costs - Keep traffic within same AZ/region when possible
- NAT Gateway charges - Use VPC endpoints for AWS services
- CloudWatch Logs accumulation - Set retention policies
Compliance & Governance
Data Residency
- Use specific regions (eu-west-1 for GDPR)
- Enable S3 bucket replication restrictions
- Configure Route 53 geolocation routing
HIPAA Compliance
- Use BAA-eligible services only
- Enable encryption at rest and in transit
- Implement audit logging (CloudTrail)
- Configure VPC with private subnets
SOC 2 / ISO 27001
- Enable AWS Config for compliance rules
- Use AWS Audit Manager
- Implement least privilege access
- Regular security assessments
Limitations
- Lambda limitations: 15-minute execution limit, 10GB memory max, cold start latency
- API Gateway limits: 29-second timeout, 10MB payload size
- DynamoDB limits: 400KB item size, eventually consistent reads by default
- Regional availability: Not all services available in all regions
- Vendor lock-in: Some serverless services are AWS-specific (consider abstraction layers)
- Learning curve: Requires AWS expertise, DevOps knowledge
- Debugging complexity: Distributed systems harder to troubleshoot than monoliths
Helpful Resources
- AWS Well-Architected Framework: https://aws.amazon.com/architecture/well-architected/
- AWS Architecture Center: https://aws.amazon.com/architecture/
- Serverless Land: https://serverlessland.com/
- AWS Pricing Calculator: https://calculator.aws/
- AWS Cost Explorer: Track and analyze spending
- AWS Trusted Advisor: Automated best practice checks
- CloudFormation Templates: https://github.com/awslabs/aws-cloudformation-templates
- AWS CDK Examples: https://github.com/aws-samples/aws-cdk-examples
FAQ
What does the aws-solution-architect skill do?
Expert AWS solution architecture for startups focusing on serverless, scalable, and cost-effective cloud infrastructure with modern DevOps practices and infrastructure-as-code
How do I install aws-solution-architect?
Run npx skills add https://github.com/alirezarezvani/claude-code-skill-factory --skill aws-solution-architect in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/aws-solution-architect/ (personal) or .claude/skills/aws-solution-architect/ (project).
Which AI agents can use aws-solution-architect?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is aws-solution-architect safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains aws-solution-architect?
It is published by alirezarezvani in alirezarezvani/claude-code-skill-factory. It has 91 recorded installs.
More from alirezarezvani/claude-code-skill-factory
scrum-master-agent
alirezarezvani/claude-code-skill-factory
Open the skill to read its SKILL.md instructions.
content-trend-researcher
alirezarezvani/claude-code-skill-factory
Open the skill to read its SKILL.md instructions.
claude-md-enhancer
alirezarezvani/claude-code-skill-factory
Open the skill to read its SKILL.md instructions.
social-media-analyzer
alirezarezvani/claude-code-skill-factory
Open the skill to read its SKILL.md instructions.
prompt-factory
alirezarezvani/claude-code-skill-factory
Open the skill to read its SKILL.md instructions.
agent-factory
alirezarezvani/claude-code-skill-factory
Open the skill to read its SKILL.md instructions.
Popular devops & cloud skills
microsoft-foundry
microsoft/azure-skills
Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end. USE FOR: foundry, azd ai agent, azd provision/deploy, hosted agent scaffold/develop/run/deploy/troubleshoot, prompt agent create, managed harness agent create, GitHub Copilot harness agent, create agent, update agent, add tool to agent, invoke agent, agent insights, evaluate agent, batch eval, continuous eval, continuous monitoring, agent CI/CD, optimize prompt, improve prompt, optimize agent instructions, Agent Optimizer scaffold, dataset curation from traces, deploy model, model fine-tuning (SFT/DPO/RFT), Foundry project, RBAC, role assignment, permissions, quota, capacity, region, deployment failure, AI Services, create Foundry resource, knowledge index, customize deployment, onboard, availability, training-data, grader, distillation, large file upload. DO NOT USE FOR: Azure Functions, App Service, general Azure deploy (use azure-deploy), general Azure prep (use azure
azure-diagnostics
microsoft/azure-skills
Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage. WHEN: debug production issues, troubleshoot app service, app service high CPU, app service deployment failure, troubleshoot container apps, container app 503 or target port mismatch, troubleshoot functions, function telemetry missing or stopped after a config/connection-string change, troubleshoot AKS, VM RDP, Linux SSH, VM black screen, can't connect to VM, reset VM password, NSG or firewall blocking, kubectl cannot connect, kube-system/CoreDNS failures, pod pending, crashloop, node not ready, upgrade failures, analyze logs, KQL, insights, image pull failures, cold start issues, health probe failures, resource health, root cause of errors, troubleshoot event hubs, troubleshoot service bus, messaging SDK error, AMQP connection failure, message lock lost, lock renewal during long-running processing, service bus dead letter.
azure-prepare
microsoft/azure-skills
Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.
azure-ai
microsoft/azure-skills
Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.
azure-deploy
microsoft/azure-skills
Execute Azure deployments for ALREADY-PREPARED applications that have existing .azure/deployment-plan.md and infrastructure files. DO NOT use this skill when the user asks to CREATE a new application — use azure-prepare instead. This skill runs azd up, azd deploy, terraform apply, and az deployment commands with built-in error recovery. Requires .azure/deployment-plan.md from azure-prepare and validated status from azure-validate. WHEN: "run azd up", "run azd deploy", "execute deployment", "push to production", "push to cloud", "go live", "ship it", "bicep deploy", "terraform apply", "publish to Azure", "launch on Azure". DO NOT USE WHEN: "create and deploy", "build and deploy", "create a new app", "set up infrastructure", "create and deploy to Azure using Terraform" — use azure-prepare for these.
azure-validate
microsoft/azure-skills
Pre-deployment validation for Azure readiness. Run deep checks on configuration, infrastructure (Bicep or Terraform), RBAC role assignments, managed identity permissions, and prerequisites before deploying. WHEN: validate my app, check deployment readiness, run preflight checks, verify configuration, check if ready to deploy, validate azure.yaml, validate Bicep, test before deploying, troubleshoot deployment errors, validate Azure Functions, validate function app, validate serverless deployment, verify RBAC roles, check role assignments, review managed identity permissions, what-if analysis, validate Container Apps deployment.